Express框架POST请求无响应，该如何排查解决？

问题原因及解决方案 #

1. 缺少请求体解析中间件（最常见诱因） #

使用POST请求提交JSON格式参数时，Express默认不会解析请求体，未注册对应解析中间件的情况下，请求的数据流无法被消费，就会出现一直处于pending无响应的问题。
修改server.js，在注册路由前添加解析中间件：

import express from "express";
import userRoutes from "./routes/userRoutes.js";
const app = express();

// 新增请求体解析逻辑
app.use(express.json()); // 解析application/json格式的请求体
app.use(express.urlencoded({ extended: true })); // 解析表单格式的请求体

app.use("/api/user", userRoutes);
// 确保端口监听逻辑正常
app.listen(5000, () => {
  console.log('服务启动成功，监听5000端口');
});

2. 确认端口监听配置正常 #

你提供的server.js代码中没有端口监听的调用逻辑，确认是否漏写了app.listen代码，未启动端口监听的情况下服务不会响应任何请求。

3. 校验请求配置是否匹配 #

发送请求时需要满足以下要求：

• 请求方式和地址：POST http://localhost:5000/api/user/login
• 请求头需设置Content-Type: application/json
• 请求体为合法JSON格式，包含email字段

4. 补充全局错误处理中间件 #

你使用了express-async-handler捕获异步错误，未配置全局错误处理中间件的情况下，异常发生时可能不会返回响应，在server.js所有路由之后添加以下代码：

app.use((err, req, res, next) => {
  const statusCode = res.statusCode === 200 ? 500 : res.statusCode;
  res.status(statusCode);
  res.json({
    message: err.message,
    stack: process.env.NODE_ENV === 'production' ? null : err.stack
  });
});

可选：前端跨域处理 #

如果是浏览器端发起的请求，跨域限制也可能导致请求异常，可通过cors中间件解决：

1. 执行安装命令：npm install cors
2. 在server.js中注册中间件：

import cors from 'cors';
app.use(cors());

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