Express中ERR_HTTP_HEADERS_SENT错误求助：相似接口一崩溃

首先看你贴的错误栈，报错的是getTrainings函数（RecordController.js第69行），但你提供的问题代码是getCategories，这是第一个要排查的点：确认路由配置是否正确，有没有把getCategories和getTrainings的路由搞混，或者同一个路由被多次注册，导致响应被重复发送。

再看两个接口的代码，虽然结构相似，但存在几个关键问题：

1. 连接池创建方式错误 #

两个函数都在每次请求时新建MySQL连接池，这是不合理的——连接池应该全局初始化一次、复用连接，而非每次请求都创建。这种做法不仅浪费资源，还可能引发连接泄漏，间接导致响应重复发送的问题。

修正方法： #

在项目入口文件或单独的数据库配置文件中全局初始化连接池：

// db.js
const mysql = require("mysql2/promise");
const pool = mysql.createPool({
  host: process.env.DATABASE_HOST,
  user: process.env.DATABASE_USER,
  password: process.env.DATABASE_PASSWORD,
  port: process.env.DATABASE_PORT,
  database: process.env.DATABASE_NAME,
  connectionLimit: 10, // 合理设置连接数，不要设为1
});
module.exports = pool;

然后在控制器中引入复用：

const pool = require("../db.js"); // 路径根据实际项目调整

const getCategories = async (req, res) => {
  try {
    const [categories] = await pool.query(
      "SELECT category FROM `training` WHERE name IS NULL"
    );
    res.status(200).json(categories);
  } catch (err) {
    console.error("查询分类失败：", err);
    res.status(500).json({ message: "服务器内部错误" });
  }
};

2. 缺少异步错误捕获 #

getCategories没有用try/catch包裹异步查询操作，一旦数据库查询出错，异步函数会抛出未捕获的异常，Express默认错误处理中间件会尝试发送错误响应，此时若之前已有响应发送，就会触发ERR_HTTP_HEADERS_SENT错误。

getCoach没出问题只是因为它的查询逻辑暂时没有报错（比如coach表数据稳定），并非代码没有隐患。

修正方法： #

给所有异步接口函数加上try/catch，统一捕获异常并处理响应，避免重复发送。

3. 路由配置排查 #

检查路由文件，确认：

• getCategories的路由没有被多次注册
• 没有中间件在该路由之后又尝试发送响应
• 错误栈里的getTrainings函数是否和getCategories存在路由冲突或逻辑关联

额外优化 #

getCoach里的const body = req.body;是无用代码，可直接删除，减少冗余。

内容的提问来源于stack exchange，提问作者Guilherme Vianna