NodeJS使用Passport时出现request.login is not a function错误如何解决

错误成因 #

request.login（别名request.logIn）是Passport框架主动挂载到Express请求对象上的扩展方法，出现该错误的核心原因有两个：

1. 你没有在Express主入口文件中注册Passport的初始化中间件，请求对象未被注入该方法
2. 路由的注册顺序早于Passport初始化中间件的注册顺序，路由匹配时Passport还未完成对请求对象的扩展
   你之前尝试切换别名仍报错，本质是因为方法根本没有被挂载到请求对象上，和方法名无关。

解决方案 #

1. 调整主入口文件的中间件注册顺序 #

在你的Express主入口文件（通常是app.js或index.js）中，确保Passport初始化中间件的注册顺序在路由注册之前，参考代码如下：

const express = require('express');
const app = express();
const passport = require('passport');
// 先加载你编写的Passport策略配置
require('./authentication/authentication.js');

// 注册请求体解析中间件
app.use(express.json());
app.use(express.urlencoded({ extended: false }));

// 必须注册Passport初始化中间件，是挂载login方法的前提
app.use(passport.initialize());
// 如果你不需要使用session存储登录态，可以不用注册passport.session()中间件

// 路由注册必须放在Passport初始化之后
const userRouter = require('./routes/user.js');
app.use(userRouter);

// 后续错误处理中间件等其他逻辑

修改完成后重新启动服务，request.login方法即可正常调用，原有业务代码无需调整。

2. 可选优化：无session场景可省略login调用 #

如果你明确不需要使用session存储登录态（就像你当前配置了{session: false}），也可以直接跳过request.login调用，身份验证通过后直接返回用户信息即可，简化后的路由代码如下：

const express = require("express");
const router = express.Router();
const passport = require("passport");

router.post("/login", (request, response, next) => {
    passport.authenticate("login", (error, user) => {
        try {
            if(error) return next(error);
            if(!user) return next(new Error("Email and password are required."));
            // 无session场景无需调用login，直接返回结果即可
            return response.status(200).json({status: 200, user});
        } 
        catch (error) {
            console.log(error);    
            return next(error);
        }
    })(request, response, next);
});

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