MEAN栈Todo后端实现Passport Local认证遇阻求助

我来帮你梳理一下在MEAN栈后端实现Passport Local认证并完成路由拦截的具体步骤，结合你的项目结构来拆解：

1. 先安装必要依赖 #

首先确保你已经安装了核心依赖包：

npm install passport passport-local express-session bcryptjs

• bcryptjs 用于密码加密存储，是用户认证的安全基础
• express-session 用来保存Passport的用户会话信息

2. 在 api.route.js 中配置Passport核心逻辑 #

首先引入所需模块，然后配置Local策略、序列化/反序列化用户，最后实现认证拦截中间件：

const express = require('express');
const router = express.Router();
const passport = require('passport');
const LocalStrategy = require('passport-local').Strategy;
const bcrypt = require('bcryptjs');
// 假设你的用户模型放在models/User.js路径下
const User = require('../models/User');

// --------------------------
// 配置Passport Local策略
// --------------------------
passport.use(new LocalStrategy(
  // 这里指定登录时用email作为用户名字段（如果用username替换即可）
  { usernameField: 'email' },
  (email, password, done) => {
    // 查找数据库中的用户
    User.findOne({ email: email })
      .then(user => {
        if (!user) {
          return done(null, false, { message: '该邮箱未注册' });
        }
        // 验证密码是否匹配
        bcrypt.compare(password, user.password, (err, isMatch) => {
          if (err) throw err;
          if (isMatch) {
            return done(null, user);
          } else {
            return done(null, false, { message: '密码错误' });
          }
        });
      })
      .catch(err => console.error(err));
  }
));

// --------------------------
// 序列化/反序列化用户（必须配置）
// --------------------------
passport.serializeUser((user, done) => {
  done(null, user.id);
});

passport.deserializeUser((id, done) => {
  User.findById(id, (err, user) => {
    done(err, user);
  });
});

// --------------------------
// 核心：认证拦截中间件
// --------------------------
function isAuthenticated(req, res, next) {
  // Passport提供的req.isAuthenticated()方法，判断用户是否已登录
  if (req.isAuthenticated()) {
    return next(); // 已认证，放行到后续路由
  }
  // 未认证，返回401权限错误
  res.status(401).json({ message: '请先完成登录' });
}

// --------------------------
// 公开路由：登录/登出
// --------------------------
// 用户登录接口
router.post('/login', (req, res, next) => {
  passport.authenticate('local', (err, user, info) => {
    if (err) throw err;
    if (!user) return res.status(400).json({ message: info.message });
    // 手动触发Passport的登录流程，将用户信息存入session
    req.logIn(user, (err) => {
      if (err) throw err;
      res.status(200).json({ 
        message: '登录成功',
        user: { id: user._id, email: user.email } // 返回必要的用户信息即可
      });
    });
  })(req, res, next);
});

// 用户登出接口
router.get('/logout', (req, res) => {
  req.logout((err) => {
    if (err) return next(err);
    res.status(200).json({ message: '登出成功' });
  });
});

// --------------------------
// 受保护路由：应用认证拦截
// --------------------------
// 示例：挂载你的Todo控制器路由，先通过isAuthenticated拦截
const todoController = require('../Controllers/todoController');

// 所有/todo前缀的路由都需要先经过认证
router.use('/todo', isAuthenticated);
router.get('/todo', todoController.getAllTodos);
router.post('/todo', todoController.createTodo);
router.put('/todo/:id', todoController.updateTodo);
// 其他Todo相关路由...

module.exports = router;

3. 在主入口文件（如server.js/app.js）配置Session和Passport初始化 #

这一步很容易遗漏，必须确保Session配置在Passport初始化之前：

const express = require('express');
const app = express();
const session = require('express-session');
const passport = require('passport');
const apiRoutes = require('./routes/api.route');

// 配置Session（密钥要换成你自己的随机字符串）
app.use(session({
  secret: 'your-custom-secret-key-keep-it-safe',
  resave: false,
  saveUninitialized: false,
  cookie: { 
    secure: false, // 生产环境请改为true（配合HTTPS）
    maxAge: 24 * 60 * 60 * 1000 // Session有效期1天
  }
}));

// 初始化Passport和Session支持
app.use(passport.initialize());
app.use(passport.session());

// 解析JSON请求体（必须在路由挂载之前）
app.use(express.json());

// 挂载API路由
app.use('/api', apiRoutes);

// 启动服务器
const PORT = process.env.PORT || 5000;
app.listen(PORT, () => console.log(`Server running on port ${PORT}`));

常见问题排查 #

• 如果req.isAuthenticated()始终返回false：检查Session配置是否正确，以及序列化/反序列化逻辑是否能正确从数据库获取用户
• 登录后仍无法访问受保护路由：确认中间件顺序，Session必须在Passport初始化之前配置
• 密码验证失败：检查用户注册时是否用bcrypt.hash()正确加密了密码

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