Passport JWT Strategy未触发调用问题排查求助

我碰到过不少开发者遇到类似的情况，咱们一步步排查可能的原因：

1. 检查JWT令牌的请求头格式 #

确保请求的Authorization头严格遵循 Bearer + 空格 + 令牌 的格式，比如：

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

如果格式错误，ExtractJWT.fromAuthHeaderAsBearerToken()无法正确提取令牌，策略回调自然不会触发。

2. 确认Passport的初始化顺序 #

在app.js里，必须先初始化Passport，再挂载需要授权的路由，顺序错了策略还没注册就会被调用：

// app.js 正确顺序示例
const passport = require('passport');
require('./passport'); // 导入策略定义

// 先初始化Passport
app.use(passport.initialize());

// 再挂载带授权的路由
app.use('/users', passport.authenticate('jwt', { session: false }), users);

3. 检查JWTStrategy的配置完整性 #

你的passport.js里必须配置secretOrKey（要和生成JWT时用的密钥完全一致），这是验证令牌签名的核心：

const JWTStrategy = require('passport-jwt').Strategy;
const ExtractJWT = require('passport-jwt').ExtractJwt;
const passport = require('passport');
const User = require('./models/User'); // 你的用户模型

passport.use(new JWTStrategy({
  jwtFromRequest: ExtractJWT.fromAuthHeaderAsBearerToken(),
  secretOrKey: 'your-jwt-secret-key' // 必须和生成令牌时的密钥一致
}, async (jwtPayload, done) => {
  try {
    const user = await User.findById(jwtPayload.id);
    return user ? done(null, user) : done(null, false);
  } catch (err) {
    return done(err, false);
  }
}));

如果secretOrKey缺失或不匹配，策略会直接跳过回调逻辑。

4. 验证请求是否真的到达了/users路由 #

可以在授权中间件前加一个调试用的中间件，确认请求是否进入了该路由：

app.use('/users', (req, res, next) => {
  console.log('请求已到达/users路由');
  console.log('Authorization头内容:', req.headers.authorization);
  next();
}, passport.authenticate('jwt', { session: false }), users);

如果控制台没有输出，说明请求被其他路由拦截或路径配置错误，得先排查路由问题。

5. 排查其他中间件的干扰 #

比如CORS、body-parser这类基础中间件，如果它们在处理请求时抛出错误，会导致后续的Passport中间件无法执行。确保这些中间件在Passport之前正确挂载，且没有报错。

6. 启用Passport调试日志 #

开启调试模式可以查看Passport内部的执行细节，帮你定位问题：

process.env.DEBUG = 'passport:*';

运行项目后，控制台会输出Passport的详细日志，能明确是令牌提取失败、签名验证失败还是其他环节出了问题。

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