前端POST添加教师报500错误，Postman正常，CORS配置无效求助

1. 先抓服务器端具体错误日志 #

500是服务器内部错误，优先看服务器的错误栈才能定位根本问题：

• 如果用Express，在代码末尾添加错误处理中间件并开启开发模式：

app.use((err, req, res, next) => {
  console.error(err.stack); // 控制台会打印详细错误信息
  res.status(500).send('服务器内部错误');
});

启动服务器时执行NODE_ENV=development node app.js，查看终端输出的错误详情，比如参数解析失败、数据库约束报错等。

2. 对比Postman与前端请求的差异 #

打开浏览器开发者工具（F12）的Network标签，导出前端POST请求的详情，和Postman的请求做逐项对比：

• 请求头：重点看Content-Type，Postman通常设为application/json，如果前端没显式设置，浏览器可能默认发送text/plain或multipart/form-data，导致服务器无法解析请求体。
• 请求体：检查JSON结构、字段名、数据类型是否和Postman完全一致，比如Postman传teacherAge: 30，前端写成age: "30"（字符串类型），可能触发服务器逻辑报错。

示例：前端用fetch发送请求的正确写法

fetch('http://localhost:3000/teachers', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json', // 必须显式声明
  },
  body: JSON.stringify({
    teacherName: '李老师',
    teacherAge: 32,
    subject: '物理'
  })
})

3. 检查CORS配置细节 #

即使配置了中间件，也可能存在顺序或参数问题：

• 如果用cors包，确保中间件注册在路由之前：

const cors = require('cors');
// 允许指定前端域名请求，比通配符更安全
app.use(cors({
  origin: 'http://localhost:3001', // React默认运行端口
  credentials: true // 若前端需要带Cookie则开启
}));
// 路由要在cors中间件之后注册
app.use('/teachers', teacherRouter);

• 手动设置CORS头时，要处理OPTIONS预检请求：

app.use((req, res, next) => {
  res.header('Access-Control-Allow-Origin', 'http://localhost:3001');
  res.header('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
  res.header('Access-Control-Allow-Headers', 'Content-Type');
  if (req.method === 'OPTIONS') {
    return res.sendStatus(200); // 预检请求直接返回200
  }
  next();
});

4. 确认服务器端请求体解析配置 #

Express默认不会自动解析JSON请求体，必须添加对应中间件：

// 放在路由之前注册
app.use(express.json()); // 解析JSON格式请求体
app.use(express.urlencoded({ extended: true })); // 解析表单格式请求体

如果缺少这一步，服务器无法读取req.body，处理逻辑会直接报错。

5. 排查数据库操作错误 #

如果添加教师涉及数据库操作，前端请求的参数可能违反数据库约束（比如必填字段为空、重复唯一键），但Postman的参数是合法的。此时查看服务器日志中的数据库报错信息，比如SQL语句执行失败提示。

示例：Mongoose操作时打印错误

Teacher.create(req.body)
  .then(teacher => res.json(teacher))
  .catch(err => {
    console.error('数据库操作错误:', err); // 打印具体错误
    res.status(500).send('添加教师失败');
  });

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