使用Passport Local Strategy无法完成用户身份验证问题求助

问题排查及解决方案 #

1. 核心问题：中间件挂载顺序错误 #

你当前把路由挂载的代码app.use("/", loginRoutes)放在了session、passport初始化逻辑的前面，请求到达登录接口时，passport还未完成初始化，也无法读取session数据，自然无法完成身份校验。
修改方案：调整中间件顺序，把路由挂载放到passport配置完成之后，调整后的index.js相关代码顺序如下：

// 先挂载基础解析中间件、模板引擎配置
app.use(express.urlencoded({ extended: true }));
app.engine('ejs', ejsMate);
app.set('view engine', 'ejs');
app.set('views', path.join(__dirname, 'views'));
app.use(express.static(path.join(__dirname, 'public')));
// 再挂载session和passport相关中间件
app.use(session(sessionConfig));
app.use(passport.initialize());
app.use(passport.session());
passport.use(new localStrategy(User.authenticate()));
passport.serializeUser(User.serializeUser()); 
passport.deserializeUser(User.deserializeUser());
// 最后才挂载路由
app.use("/", loginRoutes);
app.use("/business", userRoutes);

2. 其他可能的问题排查点 #

• 确认登录表单字段名是否符合默认要求：passport-local默认读取请求体里的username和password字段作为校验参数，如果你表单里用户名字段用的是email/phone等其他命名，需要手动指定字段：

  passport.use(new localStrategy({
    usernameField: '你的表单用户名字段名',
    passwordField: '你的表单密码字段名'
  }, User.authenticate()));
  

• 确认注册逻辑正确性：如果你用的是passport-local-mongoose插件，必须调用插件提供的User.register()方法创建用户，该方法会自动对密码做哈希处理，如果是手动保存明文密码到数据库，会因为哈希不匹配导致校验失败。
• 调整登录跳转逻辑：passport.authenticate如果配置了successRedirect，会直接跳转，不会执行后续的users.login控制器逻辑，如果你需要执行控制器里的自定义逻辑，就把successRedirect去掉，在login控制器里自己做跳转：

  // 路由修改为
  router.route('/login')
    .get(users.renderLoginForm)
    .post(passport.authenticate('local', { failureRedirect: '/login' }), users.login);
  
  // 控制器修改为
  module.exports.login = (req, res, next) => {
    console.log("I am here");
    res.redirect('/');
  };
  

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