Node.js CRUD API调用Postman时出现500内部服务器错误求助

1. 输出详细错误信息定位问题 #

Express默认不会返回具体错误详情，在server.js末尾添加错误处理中间件，捕获并输出完整错误：

app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(500).json({ message: err.message, errorDetails: err });
});

重启服务后再测试请求，Postman会返回具体错误原因（如字段验证失败、模型不匹配等）。

2. 核对Sequelize模型与数据库表一致性 #

• 对比用户迁移文件和models/user.js的字段定义，确保字段名、数据类型、约束（如unique、allowNull）完全同步。比如迁移中设置email为唯一，模型中也要添加unique: true配置。
• 执行npx sequelize-cli db:migrate:status，确认用户表迁移状态为up，避免未执行迁移导致表结构缺失。

3. 验证路由挂载正确性 #

• 检查user.routes.js中路由路径是否符合请求规则，比如POST请求路径是否为/users，GET请求是否为/users。
• 确认server.js中正确挂载路由，示例：

const userRoutes = require('./routes/user.routes');
app.use('/api', userRoutes); // 确保挂载前缀与请求路径匹配

4. 完善控制器的错误捕获逻辑 #

查看user.controller.js中的createUser和getUsers方法，必须用try/catch捕获异步操作错误：

exports.createUser = async (req, res) => {
  try {
    const user = await User.create(req.body);
    res.status(201).json(user);
  } catch (error) {
    res.status(500).json({ error: error.message });
  }
};

未捕获的Promise拒绝会直接触发500错误。

5. 检查数据库配置准确性 #

确认config.json中开发环境的数据库信息与实际一致：

{
  "development": {
    "username": "你的数据库用户名",
    "password": "你的数据库密码",
    "database": "目标数据库名",
    "host": "127.0.0.1",
    "dialect": "mysql",
    "port": 3306
  }
}

端口、用户名或密码错误会导致数据库操作失败。

6. 规范Postman请求格式 #

• 发送POST请求时，请求头必须设置Content-Type: application/json。
• 请求体需为合法JSON格式，示例：

{
  "name": "测试用户",
  "email": "test@example.com",
  "password": "123456"
}

格式错误会导致express.json()中间件解析失败，触发后续逻辑错误。

7. 排查依赖版本兼容性 #

确认sequelize、sequelize-cli、mysql2版本兼容（如Sequelize v6需搭配mysql2 v2.x），可重新安装依赖：

rm -rf node_modules package-lock.json
npm install

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