POST返回200状态码但无响应？Passport路由中间件异常排查

• 向用户认证接口/user/login发起POST请求，服务端返回200状态码，但Postman、自有客户端始终处于等待状态，无法接收到完整响应对象。
• 接口调用截图：
  
• 服务端控制台可正常打印控制器内日志，用户认证逻辑实际执行成功，日志输出如下：

req:  { username: 'fedex', password: 'fedex' }
logged in {
  _id: new ObjectId("62a8b00f468c563699d7dfc2"),
  username: 'fedex',
  password: '$2a$10$cdbh0oCBNpHxxwebsvArLOAFwetVAh5LTnQwk1Lg9kjWkjAWhfxym',
  __v: 0
}

• 移除路由中passport.authenticate('local')中间件，将认证逻辑直接写入控制器时，接口可正常返回响应。

异常版本路由与控制器代码 #

router.post(
    '/user/login',
    passport.authenticate('local'),
    UserCtrl.getLogin,
)

getLogin =  (req, res, next) => {
        console.log("req: ", req.body)
        console.log('logged in', req.user);
        var userInfo = {
            username: req.user.username
        };
        res.json(userInfo)   
    }

LocalStrategy本地策略实现 #

const strategy = new LocalStrategy(
    function(username, password, done) {
        User.findOne({ username: username }, (err, user) => {
            if (err) {
                return done(err)
            }
            if (!user) {
                return done(null, false, { message: 'Incorrect username' })
            }
            if (!user.checkPassword(password)) {
                return done(null, false, { message: 'Incorrect password' })
            }
            return done(null, user)
        })
    }
) 

路由写法对比 #

无法正常工作的写法 #

router.post(
    '/user/login',
     passport.authenticate('local'),
    UserCtrl.getLogin
)

可正常工作的写法 #

router.post(
    '/user/login',     
    UserCtrl.getLogin 
)

passport.authenticate('local')中间件默认开启会话支持，存在以下任意一种配置缺失时，就会导致认证流程卡住、请求被挂起：

1. 没有在Express实例上注册Passport的核心初始化中间件
2. 需要使用会话功能，但没有补全Passport的用户序列化、反序列化逻辑
3. 不需要会话功能（比如用JWT做认证），但没有显式关闭session配置

即使控制器逻辑执行到了、日志能正常打印，会话逻辑的隐性阻塞也会导致响应无法正常发回客户端。

按顺序做以下检查和配置即可解决：

1. 确保在所有路由注册前，已经加载了Passport必要的核心中间件，顺序不能错：

const passport = require('passport');
// 解析请求体是LocalStrategy正常工作的前提
app.use(express.urlencoded({ extended: false }));
app.use(express.json());
// 初始化Passport
app.use(passport.initialize());
// 如果需要用session维持登录状态，再加载下面这行，同时提前配置好express-session
// app.use(passport.session());

2. 如果项目不需要用session维持登录状态（比如前后端分离用JWT的场景），直接在authenticate配置里显式关闭session即可：

router.post(
    '/user/login',
    passport.authenticate('local', { session: false }),
    UserCtrl.getLogin
)

3. 如果需要使用session功能，必须补全Passport的用户序列化、反序列化逻辑，否则会话流程无法正常闭环：

// 将用户id存入session
passport.serializeUser((user, done) => {
  done(null, user._id);
});
// 从session中取id查询用户信息，挂载到req.user
passport.deserializeUser((id, done) => {
  User.findById(id, (err, user) => {
    done(err, user);
  });
});

内容的提问来源于stack exchange，提问作者TOTΣM