Node.js Express API调用出现500错误求助（新手首次开发）

嘿，别慌！作为Node.js新手第一次碰API遇到500错误太正常了，咱们一步步拆解问题，找出根源～

最可能的原因：没配置JSON解析中间件 #

Express默认不会自动解析JSON格式的请求体，如果你没加这个中间件，req.body会是undefined，如果代码里尝试访问它，直接就会抛出错误导致500。

解决方法很简单，在你的app.js（或者入口文件）里添加这行代码：

app.use(express.json());

一定要把它放在所有路由定义之前，这样所有请求都会先经过这个中间件处理。

检查路由代码的错误 #

你提到只尝试打印请求数据，那可能代码里有语法错误或者未捕获的异常。建议给路由加上try-catch捕获错误，同时把错误信息打印出来，这样能知道到底哪里出问题了。比如：

// 假设你的路由是POST请求
app.post('/your-api-path', (req, res) => {
  try {
    // 打印请求体，确认是否拿到数据
    console.log('请求数据:', req.body);
    // 先返回一个成功响应，确保流程正常
    res.status(200).send('请求已收到');
  } catch (err) {
    // 打印错误详情，这是排查的关键！
    console.error('出错了:', err.stack);
    res.status(500).send(`服务器错误：${err.message}`);
  }
});

这样终端里会显示具体的错误信息，比如是req.body不存在，还是JSON格式有问题。

验证Postman的请求是否正确 #

虽然你说设置了JSON格式，但再仔细检查这几点：

• 请求头里的Content-Type必须是application/json，不能写错（比如少了斜杠或者拼写错误）
• 请求体的JSON必须是有效格式：所有字符串用双引号，没有多余的逗号，比如{"name": "khushboo", "email": "test@example.com"}是对的，用单引号或者末尾加逗号都是错的
• 请求的HTTP方法（GET/POST/PUT等）要和你Express路由定义的方法完全一致，比如路由是app.post，Postman就不能用GET请求

检查服务器启动状态 #

确认你的Express服务器已经正常启动，终端里能看到类似服务器运行在 http://localhost:3000的提示，没有启动时的报错（比如端口被占用、依赖缺失）。如果没装express，先执行npm install express安装依赖。

完整的示例代码参考 #

如果还是不确定，你可以先跑这个最小可行的示例，确认流程没问题：

// app.js
const express = require('express');
const app = express();
const port = 3000;

// 关键：解析JSON请求体
app.use(express.json());

// 测试路由
app.post('/test', (req, res) => {
  try {
    console.log('收到的请求体:', req.body);
    res.status(200).json({
      message: '请求成功',
      receivedData: req.body
    });
  } catch (err) {
    console.error('错误详情:', err.stack);
    res.status(500).json({
      error: '服务器内部错误',
      details: err.message
    });
  }
});

// 启动服务器
app.listen(port, () => {
  console.log(`服务器运行在 http://localhost:${port}`);
});

启动服务器后，用Postman发POST请求到http://localhost:3000/test，设置好Content-Type和JSON请求体，看看终端和Postman的响应是否正常。

如果还是有问题，把终端里打印的错误信息贴出来，就能更精准地定位问题啦～

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