用户注册POST请求返回500内部服务器错误排查求助

我正在开发Web应用的登录系统，用户注册功能发起POST请求时返回500 Internal Server Error，但终端没有任何错误提示。已排查常见语法错误和回调函数异常，仍未找到问题，相关代码如下：

appController.js #

import bcrypt from "bcrypt";
import userModel from "../model/user.model.js";

export async function register(req, res) {
  try {
    const { username, password, profile, email } = req.body;

    // check existing user
    const existUsername = new Promise((resolve, reject) => {
      userModel.findOne({ username }, (err, user) => {
        if (err) {
          reject(new Error(err));
        }
        if (user)
          reject({
            error: "Username already in use",
          });
        resolve();
      });
    });

    // check for existing email
    const existEmail = new Promise((resolve, reject) => {
      userModel.findOne({ email }, (err, email) => {
        if (err) {
          reject(new Error(err));
        }
        if (email)
          reject({
            error: "Email already in use",
          });
        resolve();
      });
    });

    Promise.all([existUsername, existEmail])
      .then(() => {
        if (password) {
          const hashedPassword =
          bcrypt
            .hash(password, 10)
            .then((hashedPassword) => {
              const User = new userModel({
                username,
                password: hashedPassword,
                profile: profile || "",
                email,
              });

              //return save result as a response
              User.save()
                .then((result) =>
                  res.status(201).send({ msg: "User Registered Successfully" })
                )

                .catch((err) =>
                  res.status(500).send(err + "inside saving process")
                );
            })
            .catch((err) => {
              return res.status(500).send({
                error: "Enable to hash password",
              });
            });
        }
      })
      .catch((err) => {
        return res.status(500).send(err);
      });
  } catch (error) {
    return res.status(500).send(error);
  }
}

user.model.js #

import mongoose from "mongoose";

export const UserSchema = new mongoose.Schema({
  username: {
    type: String,
    required: [true, "please provide unique Username"],
    unique: [true, "username already exists"],
  },
  password: {
    type: String,
    required: [true, "please provide a password"],
    unique: false,
  },
  email: {
    type: String,
    required: [true, "please provide a unique email address"],
    unique: true,
  },
  firstName: { type: String },
  lastName: { type: String },
  mobile: { type: Number },
  address: { type: String },
  profile: { type: String },
});

export default mongoose.model.Users || mongoose.model("User", UserSchema);

Server.js #

import express from "express";
import cors from "cors";
import morgan from "morgan";
import connect from "./mongoConnect.js";
import router from "./routes/route.js";

const app = express();

app.use(express.json());
app.use(cors());
app.use(morgan("tiny")); // HTTP request logger middleware for node.js
app.disable("x-powered-by");
app.use("/api", router); // now all routes will goes by prefix '''/api'''

const PORT = 8080 || process.env.PORT;

// HTTP get request
app.get("/", (req, res) => {
  res.status(201).json({ msg: "Home GET request success" });
});

// start server only when we have valid connection
connect()
  .then(() => {
    try {
      // start server
      app.listen(PORT, () => {
        console.log(`app running on http://localhost:${PORT}`);
      });
    } catch (e) {
      console.log(e);
      console.log("can't connect to the server");
    }
  })
  .catch((e) => {
    console.log(e + "occured Invalid database connection");
  });

mongoConnect.js #

import mongoose from "mongoose";

import { MongoMemoryServer } from "mongodb-memory-server";

async function connect() {
  // to create new mongoDB server instance whenever you start server
  const mongod = await MongoMemoryServer.create();
  const getURI = mongod.getUri(); // returns MongoDB URL

  mongoose.set("strictQuery", true);
  const db = await mongoose.connect(getURI);
  console.log("Database connected!!!");
  return db;
}

export default connect;

route.js #

import { Router } from "express";
// import all controllers
import * as controller from "../controller/appController.js";

const router = Router();

// POST requests
router.route("/register").post(controller.register); 

核心问题排查与修复 #

1. Promise嵌套导致异常未捕获
   原代码混用async/await与Promise链式调用，逻辑嵌套混乱，部分异步异常未被正确捕获，同时bcrypt.hash的多余赋值语句无意义。改用async/await统一处理异步逻辑，消除嵌套：

   修复后的appController.js：

   import bcrypt from "bcrypt";
   import userModel from "../model/user.model.js";
   
   export async function register(req, res) {
     try {
       const { username, password, profile, email } = req.body;
   
       // 基础参数校验
       if (!username || !email || !password) {
         return res.status(400).send({ error: "Username, email and password are required" });
       }
   
       // 检查用户名是否存在
       const existUsername = await userModel.findOne({ username });
       if (existUsername) {
         return res.status(400).send({ error: "Username already in use" });
       }
   
       // 检查邮箱是否存在
       const existEmail = await userModel.findOne({ email });
       if (existEmail) {
         return res.status(400).send({ error: "Email already in use" });
       }
   
       // 密码哈希处理
       const hashedPassword = await bcrypt.hash(password, 10);
   
       // 创建并保存用户
       const newUser = new userModel({
         username,
         password: hashedPassword,
         profile: profile || "",
         email,
       });
   
       await newUser.save();
       return res.status(201).send({ msg: "User Registered Successfully" });
   
     } catch (error) {
       console.error("Registration error details:", error); // 打印错误到终端
       return res.status(500).send({ error: "Internal Server Error" });
     }
   }
   

2. Mongoose模型定义错误
   user.model.js中检查模型是否存在的语句写法错误，应改为：

   export default mongoose.models.User || mongoose.model("User", UserSchema);
   

   Mongoose的模型存储在models对象下，原代码的mongoose.model.Users写法不符合规范。

3. 终端无报错的根源
   原代码仅返回错误响应但未将错误信息输出到终端，导致无法排查具体问题。修复后的代码在catch块中添加了console.error，可将错误详情打印到终端，快速定位问题。

4. 补充参数校验
   新增基础参数校验，避免因空值导致数据库操作失败。

额外优化建议 #

• 使用express-validator库做更严谨的请求参数校验（比如邮箱格式、密码长度），提前拦截无效请求。
• 统一错误返回格式，确保前端能一致处理错误信息。
• 生产环境将错误信息写入日志文件，不要直接返回给前端，避免泄露敏感信息。

内容的提问来源于stack exchange，提问作者Rishit Parmar