如何配置passport-jwt模块？遇“登录会话需session支持”错误

我正在学习Node.js课程，用MEAN栈实现注册与认证功能，但教程代码版本较旧，适配新版模块时已经通过YouTube评论修复了不少bug，测试HTTP请求时还是遇到错误：

Error: Login sessions require session support. Did you forget to use `express-session` middleware?

但passport-jwt官方文档明确说明：

This module lets you authenticate endpoints using a JSON web token. It is intended to be used to secure RESTful endpoints without sessions.

以下是我的index文件代码：

const express = require('express');
const path = require('path');
const bodyParser = require('body-parser');
const cors = require('cors');
const passport = require('passport');
const mongoose = require('mongoose');
const config = require('./config/database');

// Connect To Database
mongoose.connect(config.database);

// On Connection
mongoose.connection.on('connected', () => {
  console.log('Connected to Database '+config.database);
});

// On Error
mongoose.connection.on('error', (err) => {
  console.log('Database error '+err);
});


const app = express();
const users = require('./routes/users');

// Port Number
const port = process.env.PORT || 3030;

// CORS Middleware
app.use(cors());

// Set Static Folder
app.use(express.static(path.join(__dirname, 'public')));

// Body Parser Middleware
app.use(bodyParser.json());

// Passport Middleware
app.use(passport.initialize());
app.use(passport.session());

require('./config/passport')(passport);

app.use('/users', users);

// Index Route
app.get('/', (req, res) => {
  res.send('invaild endpoint');
});

app.get('*', (req, res) => {
  res.sendFile(path.join(__dirname, 'public/index.html'));
});

// Start Server
app.listen(port, () => {
  console.log('Server started on port '+port);
});

请问如何正确配置passport-jwt模块解决这个错误？

解决方案 #

1. 移除不必要的会话中间件调用 #

错误核心原因是你在Passport配置中添加了passport.session()，但passport-jwt是无会话认证方案，完全不需要启用会话支持。直接删除这行代码：

// 删掉此行
app.use(passport.session());

2. 确保Passport配置使用JWT策略 #

检查./config/passport.js，确认配置的是passport-jwt策略，而非依赖会话的策略（比如local会话策略）。典型的passport-jwt配置示例如下：

const JwtStrategy = require('passport-jwt').Strategy;
const ExtractJwt = require('passport-jwt').ExtractJwt;
const User = require('../models/user');
const config = require('./database');

module.exports = function(passport) {
  const opts = {};
  opts.jwtFromRequest = ExtractJwt.fromAuthHeaderAsBearerToken();
  opts.secretOrKey = config.secret;
  
  passport.use(new JwtStrategy(opts, (jwt_payload, done) => {
    User.findById(jwt_payload._id, (err, user) => {
      if (err) return done(err, false);
      if (user) return done(null, user);
      return done(null, false);
    });
  }));
};

3. 路由中明确禁用会话 #

在需要保护的接口路由中，使用passport.authenticate('jwt', {session: false})作为中间件，明确告知Passport不使用会话：

// 示例：users路由中的受保护接口
router.get('/profile', passport.authenticate('jwt', {session: false}), (req, res) => {
  res.json({user: req.user});
});

完成以上配置后，就能彻底避免会话相关错误，符合passport-jwt无会话的设计初衷。

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