Node + Express + Passport: req.user未定义

在使用Node.js、Express和Passport构建身份验证系统时，req.user未定义通常是由于以下几个原因造成的：

基础概念

Node.js: 是一个基于Chrome V8引擎的JavaScript运行时环境，允许开发者使用JavaScript编写服务器端代码。
Express: 是一个简洁灵活的Node.js Web应用框架，提供了一系列强大的特性来帮助创建Web服务器和API。
Passport: 是一个Node.js的身份验证中间件，支持多种策略，如本地策略、OAuth、OpenID Connect等。

类型与应用场景

本地策略: 适用于传统的用户名和密码登录。
OAuth: 适用于第三方登录，如Google、Facebook等。
OpenID Connect: 基于OAuth 2.0的身份层，适用于需要用户身份信息的应用。

常见问题及解决方法

1. 未正确配置Passport中间件

确保在Express应用中正确配置了Passport中间件。

const express = require('express');
const passport = require('passport');
const LocalStrategy = require('passport-local').Strategy;

const app = express();

// 配置Passport使用本地策略
passport.use(new LocalStrategy(
  function(username, password, done) {
    // 这里应该是查找用户的逻辑
    User.findOne({ username: username }, function (err, user) {
      if (err) { return done(err); }
      if (!user) { return done(null, false); }
      if (!user.verifyPassword(password)) { return done(null, false); }
      return done(null, user);
    });
  }
));

// 序列化和反序列化用户
passport.serializeUser(function(user, done) {
  done(null, user.id);
});

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

// 使用Passport中间件
app.use(passport.initialize());
app.use(passport.session());

// 路由示例
app.post('/login', 
  passport.authenticate('local', { failureRedirect: '/login' }),
  function(req, res) {
    res.redirect('/');
  });

app.get('/', function(req, res) {
  if (req.isAuthenticated()) {
    res.send('Hello ' + req.user.username);
  } else {
    res.send('Please login');
  }
});

2. 未启用Session

Passport依赖于Session来存储用户信息。确保在Express应用中启用了Session。

const session = require('express-session');

// 配置Session中间件
app.use(session({
  secret: 'your_secret_key',
  resave: false,
  saveUninitialized: false
}));

3. 路由顺序问题

确保Passport中间件在路由之前被加载。

// 先加载Passport中间件
app.use(passport.initialize());
app.use(passport.session());

// 然后定义路由
app.post('/login', passport.authenticate('local', { failureRedirect: '/login' }), function(req, res) {
  res.redirect('/');
});

4. 用户验证失败

如果用户验证失败，req.user将不会被定义。确保在验证失败时正确处理。

app.post('/login', 
  passport.authenticate('local', { 
    failureRedirect: '/login', 
    failureFlash: true 
  }),
  function(req, res) {
    res.redirect('/');
  });