我在 Node.js 后端开发中常见的错误（以及如何修复它们）

2026西湖龙井茶官网DTC发售：茶农直供，政府溯源防伪到农户家 

到目前为止，我已经开发过足够多的 Node.js 后端项目，开始反复遇到相同的问题。其中一些是初学者常犯的错误，另一些则出现在那些本应更懂行的人所编写的代码库中。

以下是我最常看到的几个问题。

未正确处理异步错误

这个问题随处可见。有人编写了一个异步函数，却忘了用 try/catch 包裹它，结果在生产环境中，未处理的 Promise 拒绝会悄无声息地吞掉错误。

// 这样会吞掉错误
app.get("/users", async (req, res) => {
  const users = await getUsers();
  res.json(users);
});

// 这样则不会
app.get("/users", async (req, res, next) => {
  try {
    const users = await getUsers();
    res.json(users);
  } catch (err) {
    next(err);
  }
});

更好的做法是使用一个包装工具函数，或者像 express-async-errors 这样的库，这样你就不用到处重复这种模式了。

把所有代码塞进一个文件

我曾打开过一些 Node.js 项目，整个应用——包括路由、业务逻辑、数据库调用和中间件——全都写在一个 index.js 文件里。这种方式在项目小的时候还能运行，但一旦项目规模扩大，代码就变得难以导航，测试起来更是噩梦。

采用一个简单的目录结构就能带来很大改善：

src/
  routes/
  controllers/
  services/
  middleware/
  utils/

控制器负责处理请求和响应，服务层负责处理业务逻辑。将它们分开，你的代码库在规模扩大时依然能保持可读性。

阻塞事件循环

Node.js 是单线程的。如果你在主线程上执行繁重的同步操作，其他所有任务都必须等待。我见过有人在路由处理器中直接同步解析一个大型 JSON 文件，或执行 CPU 密集型计算。

如果你有繁重的任务需要处理，请将其卸载到……