MongoDB错误必须区分连接级与操作级并用Express错误中间件统一处理：mongoose.connect()需监听error事件而非仅catch，路由中应扁平化try/catch避免响应失控，事务需副本集支持，错误中间件须四参数且置于路由之后。
直接说结论：MongoDB 连接失败、查询超时、ValidationError、CastError 这些错误不能靠 try/catch 一层包住路由函数就万事大吉——必须区分「连接级错误」「操作级错误」，并用 Express 错误中间件统一接管，否则 500 响应会漏发、日志会丢失、客户端收不到真实状态。
mongoose.connect() 的错误不会自动触发 Express 错误中间件
很多人把 mongoose.connect() 放在 app.js 里，只写个回调或 .catch() 打印日志，但没做任何进程级防护。结果是：MongoDB 挂了，Express 服务还在跑，所有接口返回 500 或空响应，却没有任何告警。
- ✅ 正确做法：在
connect后加on('error')监听，并调用process.exit(1)或触发全局告警（如 Sentry） - ⚠️ 注意：
mongoose.connect(...).catch()只捕获首次连接失败，不捕获后续网络闪断；必须监听connection.on('disconnected')和on('reconnected') - 示例片段：
mongoose.connect('mongodb://localhost:27017/mydb').catch(err => {<br> console.error('❌ MongoDB 连接初始失败:', err);<br> process.exit(1);<br>});<br><br>mongoose.connection.on('error', err => {<br> console.error('? 连接池异常:', err);<br> // 这里可发钉钉/企业微信告警<br>});
控制器里嵌套 try-catch 会导致响应逻辑失控
这是最常踩的坑：在 async 路由处理函数中，对每个 await 单独包 try/catch，然后在内层 catch 里调用 next(err) ——但 next() 不会中断函数执行，后面的 res.json() 依然会跑。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- ❌ 错误写法：
try {<br> const user = await User.findById(req.params.id);<br> try {<br> await user.updateOne({ status: 'active' });<br> } catch (err) {<br> next(err); // ❌ res.json 仍会执行<br> }<br> res.json(user); // ⚠️ 即使 update 失败也返回旧数据<br>} - ✅ 必须扁平化：
try {<br> const user = await User.findById(req.params.id);<br> await user.updateOne({ status: 'active' });<br> res.json(user); // ✅ 仅全部成功才响应<br>} catch (err) {<br> next(err); // 统一交由错误中间件<br>} - ⚠️ 特别注意：
ValidationError（字段校验失败）、CastError（ID 格式错误）都继承自Error，会被上层catch捕获，无需额外判断类型
需要事务时，别硬套单条 save + findByIdAndUpdate
当业务要求「A 写入 + B 关联更新」必须原子性（比如创建订单同时扣库存），仅靠两个独立 await 无法保证一致性——哪怕都在一个 try 块里，第二个操作失败时第一个已提交，无法回滚。
- ✅ 必须启用 MongoDB 事务：
session.startTransaction()+session.commitTransaction()/session.abortTransaction() - ⚠️ 硬性前提：MongoDB 必须是副本集（非单机模式），且 Mongoose 版本 ≥ 6.0
- 性能影响：事务会锁资源、增加延迟，非强一致性场景（如日志记录）不必上事务
- 示例关键点：
const session = await mongoose.startSession();<br>try {<br> await session.withTransaction(async () => {<br> await order.save({ session });<br> await inventory.updateOne({ _id }, { $inc: { stock: -1 } }, { session });<br> });<br>} finally {<br> session.endSession();<br>}
真正容易被忽略的是：错误中间件必须放在所有 app.use() 路由之后，且函数签名必须是 (err, req, res, next) 四参数形式——少一个参数，Express 就当它是普通中间件，错误永远进不去。另外，res.headersSent 在错误处理前要检查，避免重复发送响应。
