如何修复Express+PostgreSQL注册接口的Cannot set headers after they are sent错误？

算力阿峰

2026-8-5

用户注册接口重复响应问题解决

问题原因

你这段代码的核心问题是异步操作没有按顺序等待：

postgres.query是异步执行的，用.then()的话，代码不会等这个查询完成，就直接往下跑邮箱查询、密码哈希和插入操作
哪怕第一个用户名查询已经返回了res.json，后面的代码还是会继续执行，导致多次尝试给客户端发响应，触发Cannot set headers after they are sent错误

解决方案

利用函数已经是async的特性，把所有异步操作改成await，确保代码按顺序执行，一旦发现用户名/邮箱存在就直接终止后续逻辑：

module.exports.register = async (req, res, next) => {
  try {
    const { username, email, password } = req.body;

    // 先检查用户名是否存在
    const usernameCheck = await postgres.query("SELECT * FROM users WHERE username = $1", [username]);
    if (usernameCheck.rows.length > 0) {
      return res.status(409).json({
        msg: "Username is already in use",
        status: false,
      });
    }

    // 再检查邮箱是否存在
    const emailCheck = await postgres.query("SELECT * FROM users WHERE email = $1", [email]);
    if (emailCheck.rows.length > 0) {
      return res.status(409).json({
        msg: "Email is already in use",
        status: false,
      });
    }

    // 哈希密码
    const hashedPassword = await bcrypt.hash(password, 10);

    // 插入新用户
    const newUser = await postgres.query(
      "INSERT INTO users (username, email, password) VALUES ($1,$2,$3) RETURNING *",
      [username, email, hashedPassword]
    );

    return res.json({ user: newUser.rows, status: true });
  } catch (err) {
    next(err);
  }
};