Postman发送POST请求报错排查：Node.js后端服务正常但请求失败

1. 先确认请求基础配置 #

• 核对请求URL：必须和服务器启动的地址、端口完全匹配，比如服务器运行在localhost:3000，不能写错端口或路径后缀
• 确认请求方法：确保Postman里选的是POST，别误选成GET/PUT等其他方法
• 检查请求头：如果传JSON格式参数，必须添加Content-Type: application/json请求头，这是POST JSON请求最常见的遗漏项

2. 核对路由配置（routes/user.js） #

• 检查路由路径是否和请求路径一致：比如路由定义router.post('/register', ...)，请求URL就得是/api/user/register（假设主服务器挂载路径是/api/user）
• 确认路由已挂载到主服务器：在index.server.js里必须有类似app.use('/api/user', userRoutes)的代码，未挂载的请求会直接返回404

3. 检查控制器逻辑（controller/user.js） #

• 确认服务器已配置JSON解析中间件：在index.server.js里必须添加app.use(express.json())，否则req.body会是undefined，直接读取会报错
• 排查控制器内的错误：检查是否有未捕获的异常，比如数据库操作未加try/catch、调用了不存在的方法，这类问题会导致服务器返回500错误

4. 验证数据库相关配置（models/user.js） #

• 核对模型字段与请求参数：比如模型定义email为必填项，但请求未传该字段，会触发数据库验证失败
• 确认数据库连接正常：虽然nodemon显示服务器启动，但可能数据库连接失败，执行数据库操作时会抛出错误

5. 查看服务器终端日志 #

• 重点看Postman请求发送后终端输出的错误信息，比如路由匹配失败、数据库连接错误、参数验证失败等，这是最直接的排查线索

6. 最简测试定位问题 #

• 在routes/user.js中添加测试路由：

  router.post('/test', (req, res) => {
    res.send('POST test success')
  })
  

  用Postman请求该路径，如果能正常返回，说明基础配置没问题，问题出在业务逻辑；如果仍报错，优先排查服务器端口、中间件等基础配置

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