排查JWT开发中服务器无响应问题：请求挂起无数据返回

以下是针对服务器挂起、无数据返回问题的排查点及修复方案：

1. 缺少JSON请求体解析中间件 #

你的POST /login请求发送了JSON格式的请求体，但Express默认不会自动解析JSON请求体，导致服务器一直处于等待请求体解析的状态，最终挂起。

修复：在server.js中定义路由前添加JSON解析中间件：

const express = require('express');
const jwt = require('jsonwebtoken');
const app = express();

// 必须添加这行，解析JSON格式的请求体
app.use(express.json());

// 后续的posts数组、路由定义...

2. 未正确加载环境变量 #

代码中使用了process.env.ACCESS_TOKEN_SECRET作为JWT签名密钥，但如果没有配置环境变量，这个值会是undefined，导致jwt.sign抛出错误，且没有错误处理逻辑，进而阻塞请求响应。

修复：

• 安装dotenv包：npm install dotenv
• 在server.js最顶部添加环境变量加载代码：

require('dotenv').config();

• 在项目根目录创建.env文件，写入你的密钥：

ACCESS_TOKEN_SECRET=your_secure_secret_key_here

3. 未处理异常与边界情况 #

/login路由中没有校验req.body.username是否存在，也没有捕获jwt.sign可能抛出的异常，一旦出现错误会导致请求无响应。

修复：给login路由添加错误捕获和参数校验：

app.post("/login", (req, res) => {
  try {
    const username = req.body.username;
    // 校验用户名是否存在
    if (!username) {
      return res.status(400).json({ error: "用户名不能为空" });
    }
    const user = { name: username };

    const accessToken = jwt.sign(user, process.env.ACCESS_TOKEN_SECRET);
    res.json({ accessToken: accessToken });
  } catch (err) {
    // 捕获异常并返回错误响应
    res.status(500).json({ error: "生成访问令牌失败" });
  }
});

4. 确认服务器是否正常启动 #

原代码中app.listen没有添加回调函数，无法直观确认服务器是否成功启动，可能存在服务器未正常启动导致请求无响应的情况。

修复：添加启动回调：

app.listen(5000, () => {
  console.log("服务器已在http://localhost:5000启动");
});

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