使用Jest+Supertest测试Passport.js认证路由时策略未识别

解决思路与方案 #

核心问题是测试环境中Passport的admin-login策略未被正确注册，以下是具体原因和修复方案：

1. Passport实例不一致（模块缓存/加载顺序问题） #

Node.js模块缓存机制下，若应用中存在多个Passport实例，可能出现策略注册到了未被Express使用的实例上：

• app.js中配置策略的Passport实例，和路由login.js中调用passport.authenticate的实例不是同一个
• 测试环境下模块加载顺序异常，导致策略注册代码晚于路由初始化执行

修复方式：
统一应用中Passport实例的使用：

• 创建单独的Passport配置文件，导出已配置好的实例：

  // config/passport.js
  const passport = require('passport');
  const LocalStrategy = require('passport-local').Strategy;
  
  passport.use('admin-login', new LocalStrategy(
    {
      usernameField: 'username',
      passwordField: 'password',
      passReqToCallback: true,
    },
    (req, name, password, done) => { 
      async function verifyAdminAuth() {
        // 你的认证逻辑，务必调用done()
        try {
          // 示例逻辑：查询用户、校验密码
          const admin = await Admin.findOne({ username: name });
          if (!admin) return done(null, false, { message: '用户不存在' });
          done(null, admin);
        } catch (err) {
          done(err);
        }
      }
      verifyAdminAuth();
    }
  ));
  
  module.exports = passport;
  

• 在app.js和路由文件中统一导入该实例：

  // app.js
  const passport = require('./config/passport');
  app.use(passport.initialize());
  // 若使用session需添加：app.use(passport.session());
  

  // login.js
  const passport = require('../config/passport');
  

2. 测试环境未执行Passport配置代码 #

若app.js中Passport配置存在环境判断逻辑，或测试代码未加载完整的应用初始化流程，会导致策略注册代码未执行。

修复方式：

• 检查app.js是否有类似if (process.env.NODE_ENV !== 'test')的判断跳过Passport配置，移除该限制
• 确保app.js中所有配置逻辑（包括Passport）都在导出app对象之前执行，避免测试时导入未完成配置的app

3. 策略回调未正确调用done() #

虽然浏览器请求正常，但测试环境下若策略的异步认证逻辑未调用done()，可能导致Passport内部抛出异常，错误信息被混淆为“策略不存在”。

修复方式：
检查verifyAdminAuth函数，确保在认证完成（成功/失败/异常）时调用done()，示例代码见上述config/passport.js中的实现。

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