基于 Express 的毕业设计实战：从零构建高可用 RESTful API 服务

基于 Express 的毕业设计实战：从零构建高可用 RESTful API 服务

1. 学生常见痛点：为什么 Demo 永远跑不到线上

做毕业设计时，很多同学把“能跑起来”当成终点，结果代码越写越像“意大利面条”：

• 路由全部堆在app.js，一屏拉不到底
• console.log当日志，重启后全丢
• 鉴权靠“前端传个isAdmin=true”，答辩现场被老师一秒击穿
• 本地npm start没问题，放到云服务器就 404，路径大小写踩坑
• 端口、密钥、数据库密码全写死在代码里，GitHub 一开源直接“社死”

这些问题总结成一句话：缺少“工程化”思维。毕业设计不是课程作业，它得“可维护、可部署、可演示”。下面就用 Express 给出一套“能毕业、能上线”的最小实战范式。

2. Express 选型：为什么不是 Koa 或 Fastify

轻量 Node 框架三剑客常年被拿来对比，我直接给结论：

结论：除非你对性能有极致要求，否则 Express 是“最不会出错”的选择——老师懂、学长懂、云厂商模板也懂，节约答辩沟通成本。

3. 核心实现：四步搭出“能上线”的骨架

3.1 模块化路由：按业务拆文件

把路由从app.js拆出来，目录如下：

• routes/
  • index.js // 聚合所有子路由
  • user.js // 用户相关
  • paper.js // 论文相关

关键代码（routes/user.js）：

const express = require('express'); const router = express.Router(); const userCtrl = require('../controller/user'); router.post('/register', userCtrl.register); router.post('/login', userCtrl.login); module.exports = router;

在routes/index.js统一挂载：

module.exports = (app) => { app.use('/api/users', require('./user')); app.use('/api/papers', require('./paper')); };

好处：

1. 路由文件只负责“指路”，逻辑下沉到 controller，单一职责。
2. 新增模块只需加文件，不碰旧代码，符合开闭原则。

3.2 自定义错误中间件：统一格式、统一日志

没有错误规范的 API，前端收到500就抓瞎。定义一套“业务级别”错误码：

class BusinessError extends Error { constructor(code, msg, status = 400) { super(msg); this.code = code; this.status = status; } }

错误中间件（middleware/error_handler.js）：

module.exports = (err, req, res, next) => { // 已知业务错误 if (err instanceof BusinessError) { return res.status(err.status).json({ code: err.code, msg: err.message }); } // 未知错误 console.error(err); res.status(500).json({ code: 'INTERNAL_ERROR', msg: '服务器走神了' }); };

在app.js最后挂载：

const errorHandler = require('./middleware/error_handler'); app.use(errorHandler);

效果：

• 前端拿到{code: 10001, msg: '手机号已存在'}直接弹窗，无需解析 HTML。
• 未知错误落盘日志，方便定位。

3.3 JWT 令牌验证：无状态登录

毕业项目常见“把用户信息塞 session”——结果服务器一重启全掉线。用 JWT 实现真·无状态：

安装依赖：

npm i jsonwebtoken bcryptjs

登录接口（controller/user.js片段）：

const jwt = require('jsonwebtoken'); const bcrypt = require('bcryptjs'); const { BusinessError } = require('../utils/error'); exports.login = async (req, res, next) => { const { email, password } = req.body; const user = await User.findOne({ email }); if (!user) return next(new BusinessError('USER_NOT_FOUND', '用户不存在')); const ok = await bcrypt.compare(password, user.passwordHash); if (!ok) return next(new BusinessError('PASSWORD_ERROR', '密码错误')); const token = jwt.sign({ uid: user.id }, process.env.JWT_SECRET, { expiresIn: '7d' }); res.json({ token }); };

验证中间件（middleware/auth.js）：

const jwt = require('jsonwebtoken'); module.exports = (req, res, next)用最严格格式输出纯 Markdown 正文，不要任何额外说明 [![领取优惠](https://i-operation.csdnimg.cn/ad/ad_pic/d1d145535b894b49a721574ff1e756da.png)](https://t.csdnimg.cn/iKHO) ---