为什么您的 Express 项目总是越写越乱?
说实话,我见过太多 Express 项目了。刚开始写的时候挺清爽,几个路由一放,跑起来没问题。可过了两三个月,文件越来越多,中间件到处塞,错误处理七零八落。您是不是也遇到过这种情况?改一个接口,结果影响了另外三个功能,排查半天才发现是某个中间件的顺序放错了。
坦白讲,Express 本身非常灵活,它不像 NestJS 那样帮您把架构定死。这既是优点,也是坑。灵活意味着您得自己想清楚怎么组织代码。今天我就结合这些年踩过的坑,跟您聊聊 Express 开发中那些真正管用的实操经验。
项目结构:别把所有东西都塞进一个文件
就拿我最开始写 Express 来说,所有路由都写在 app.js 里。一开始就五六个接口,感觉挺方便。等到三十多个接口的时候,那个文件已经快两千行了,找一段代码得翻半天。
后来我学乖了,按功能模块拆分目录。每个模块有自己的路由文件、控制器、数据校验逻辑。比如说您做一个用户系统,那就建一个 routes 目录放路由定义,controllers 目录放业务逻辑,middlewares 目录放通用中间件。这样您改用户相关的功能,就只需要关注 users 这个模块,不会牵一发动全身。
还有一点特别重要:把 app 和 server 分开。app.js 只负责创建 Express 实例、注册中间件和路由,server.js 负责监听端口。这样做的好处是什么呢?测试的时候您可以直接引入 app,不用真的启动一个 HTTP 服务。很多朋友做集成测试时被这个问题卡住,其实就是没做这层分离。
中间件:顺序决定生死
Express 的中间件机制是它的灵魂,但也是最容易出问题的地方。我见过一个项目,日志中间件放在了路由注册之后,结果所有请求都记录不到日志。为什么?因为请求已经被路由处理完并返回响应了,根本不会走到后面的中间件。
您得记住一个原则:中间件的执行顺序就是代码里注册的顺序,从上到下,像水流一样。所以通用的、每个请求都要经过的中间件,比如日志、CORS、body 解析,一定要放在最前面。路由相关的中间件放在中间。错误处理中间件放在最后,而且必须是四个参数的那个函数签名。
说到错误处理,我强烈建议您统一用一个错误处理中间件来兜底。别在每个路由里写 try-catch 然后 res.send 错误信息,那样代码又乱又难维护。正确做法是在路由里只管抛错误或者调用 next(error),让统一的错误处理中间件来决定返回什么状态码和什么格式的错误信息。这样前端拿到的错误格式也是一致的,联调的时候少吵很多架。
异步处理与性能优化
Express 4 有个让人头疼的地方:它不会自动捕获异步函数里抛出的错误。您写了一个 async 路由处理函数,里面 await 某个数据库操作失败了,如果不手动 try-catch,这个错误就会变成未处理的 Promise rejection,进程可能直接挂掉。
解决办法有好几种。您可以写一个包装函数,把 async 函数包一层,自动 catch 错误并传给 next。也可以用 Express 5,它原生支持异步错误捕获。如果您现在还在用 Express 4,我建议至少加一个包装器,这个投入绝对值得。
性能方面,说实话大部分项目根本到不了需要极致优化的量级。但有几个点提前做好没坏处。比如说用 compression 中间件开启 gzip 压缩,响应体积能减少 70% 左右。再比如说静态资源交给 Nginx 或者 CDN 处理,别让 Express 去读文件流。这些配置花不了多少时间,但效果立竿见影。
另外,如果您的前端用的是 Vue.js,那前后端分离的架构下,Express 只需要专注提供 API 就好。跨域问题用 cors 中间件一行代码解决,别在 Nginx 里绕来绕去。开发环境下用 proxy 配置转发,生产环境用 Nginx 反向代理,这是最省心的方案。
总结与行动建议
聊了这么多,其实核心就三件事:结构清晰、中间件有序、错误处理统一。Express 不难,难的是在项目变大之前就建立起好的习惯。
如果您现在手里正好有一个 Express 项目,我建议您今天就做一件事:打开您的 app.js,看看中间件的注册顺序对不对,错误处理是不是统一的。就这一个检查,可能就能帮您避免未来好几个小时的排查时间。
如果您刚开始学 Express,那更好,从一开始就按模块化的方式组织代码,把 app 和 server 分开。等您项目长大了,您会感谢现在做决定的自己。毕竟,写代码这件事,前期多花十分钟规划,后期能省十个小时填坑。您说是不是?