本文信息核实于2026-08-06
兄弟，听我一句劝，别再去啃那些几百页的Express官方文档了。你花三天三夜看完，不如直接看我这个老油条给你划的重点。我敢打赌，你照着下面这套玩法搞，当天就能上手写接口，一周后就能在公司里横着走。为啥？因为Express这玩意儿，说透了就是“中间件”三个字，你把这三个字玩明白了，什么路由、模板、静态资源，全是弟弟。
先给你交个底，我见过太多新手，甚至一些工作两三年的，用Express写接口，QPS（每秒查询数）一上去就崩。为啥？不是Express不行，是你用错了姿势。今天这篇，我不给你整那些虚头巴脑的理论，全是实战里淌着泪总结出来的干货，尤其是最后那5个坑，你提前知道，能少加三天班。
核心观点：Express的精髓不是“路由”，而是“中间件”的洋葱模型。
很多人一上来就学app.get、app.post，以为会写路由就会Express了。大错特错！你想想，为啥叫“框架”？框架就是给你搭好了骨架，让你填肉。Express的骨架就是那一个个app.use()。请求进来，就像一颗洋葱，你要一层层剥开，每一层都是一个中间件，做点小处理（比如打印日志、解析Body、校验Token），最后才到你的业务路由（核心果肉）。理解了这一点，你才算入了门。
详细解读：从“能用”到“好用”，你得这么玩
-
别用
req.body裸奔，上express.json()和express.urlencoded()兄弟们，这俩是亲兄弟，必须一起上。你前端发个JSON，后端不解析，你拿啥？拿到的是个undefined，然后你一脸懵逼查半天。记住，在挂载路由之前，先app.use(express.json())。这是地基中的地基。别嫌我啰嗦，我见过太多新手栽在这上面，一查一个准。 -
路由别全堆在
app.js里，要拆分模块 你见过哪个大厨把满汉全席都放一个锅里炖的？代码也一样。app.js只负责启动服务器和挂载全局中间件。具体业务路由，比如用户相关的，就建一个routes/user.js，然后用Router()导出来，在app.js里app.use('/api/user', userRouter)。这样结构清晰，后期维护想骂人都找得到对象。 -
错误处理中间件，是你的救命稻草 默认情况下，Express 4.x 的错误处理是有点“呆”的。你必须在所有路由的最后，加一个四个参数的函数：
(err, req, res, next)。别问为啥是四个，这就是约定。你所有的next(err)，最后都会汇聚到这里，统一返回一个500或者你自定义的错误码。没有这个，你的服务器一遇到异步错误，直接崩溃给你看，连个响都没有。 -
异步错误要主动捕获 这是Express 4的一个大坑。如果你的路由函数是
async的，里面抛了个异常，Express不会自动捕获！它会直接变成未处理的Promise rejection，然后进程就挂了。咋办？要么你每个路由都写try...catch，要么，直接升级到Express 5（现在已经很稳了），它原生支持异步错误处理。如果你还在用4，赶紧套个壳，比如express-async-errors这个包，装上之后世界就清净了。 -
生产环境要关掉
x-powered-by这个头信息会暴露你的技术栈，告诉黑客“我是Express”。虽然不至于致命，但安全意识要有。一行代码：app.disable('x-powered-by')，分分钟搞定。
5个FAQ（兄弟们问得最多的）
Q1：Express和Koa到底选哪个？
兄弟，这问题就像问“川菜和湘菜哪个好吃”。Koa更轻量，基于async/await，没有内置路由，更“自由主义”。Express更成熟，资料多，生态全，公司项目用得多。你要是新手，我强烈建议先从Express上手，因为工作机会多啊！学会了Express，你再看Koa，那叫一个降维打击。
Q2：中间件里next()和return next()有啥区别？
区别大了去了！你写next()，代码还会继续往下走。如果你后面还有代码，就可能会出问题（比如重复发送响应）。写return next()，就是告诉函数“执行完next就结束，别往下跑了”。这是个好习惯，能帮你避免一堆莫名其妙的bug。
Q3：怎么处理文件上传？
别自己造轮子，用multer这个中间件，神器。几行代码配置好存储路径和文件名，搞定。记住，文件上传是multipart/form-data格式，你之前那个express.json()解析不了，必须用multer。
Q4：如何给Express写单元测试？
用supertest，配合jest或者mocha。它可以直接启动你的app，然后模拟HTTP请求，断言返回结果。记住，测试的时候要导出你的app实例，而不是监听端口，不然测试跑不起来。
Q5：Express性能瓶颈在哪儿？怎么优化？
瓶颈一般不在Express本身，而在你的业务代码和数据库查询。常见的优化：1. 开启gzip压缩（compression中间件）；2. 用cluster模块或者PM2开启多进程，充分利用多核CPU；3. 把数据库查询结果缓存起来（比如用Redis）；4. 静态资源交给Nginx处理，别让Node去读文件。
实用建议（给你的掏心窝子话）
-
别用
nodemon，用node --watch现在Node.js版本（18+）自带--watch模式，不用再装第三方包了。启动命令改成node --watch app.js，改代码自动重启，香得很。 -
环境变量管理，别写死在代码里 端口号、数据库密码、密钥，这些必须放
.env文件里，然后用dotenv这个包加载。别问为什么，等你把密码传到GitHub上被全网围观的时候，你就懂了。 -
写接口，一定要有统一的响应格式 别一会儿返回
{status:1, data:...}，一会儿又返回{code:200, msg:...}。前后端联调会打起来的。统一用{ code: 200, message: 'success', data: {} }这种格式，包一个response工具函数，省心省力。 -
多看源码，但别钻牛角尖 你不需要把Express源码全部看完，但一定要看懂
express这个函数返回的是什么，Router是怎么工作的。看懂了，你就能理解为什么app.use能匹配所有路径。 -
最后，也是最重要的：动手写！ 看一百篇攻略，不如自己写一个博客接口。从搭建项目开始，到写用户注册登录（用JWT做鉴权），再到写文章增删改查，最后部署上线。走完这一套流程，你才算真正掌握了Express。
好了，兄弟，干货就这么多。别光收藏，赶紧去跑一个npm init -y，把Express装上，照着上面的思路搞一搞。相信我，你离“Node.js后端开发”这个头衔，就差这临门一脚了。有问题随时评论区开麦，我看到了就回你。