如何让Passport.js（Local）与Firestore实现会话功能？

我之前在项目里也遇到过一模一样的情况——用Firestore替代MongoDB做Passport的用户存储，官方文档没给示例，踩了好几个Promise和文档ID的坑。下面一步步帮你修复：

1. 先修正序列化与反序列化的代码问题 #

你的代码里有两个关键错误，直接导致会话无法正常工作：

错误1：反序列化未处理Promise异常，且err变量未定义 #

Firestore的异步操作必须捕获异常，而且你在done(err, ...)里的err根本没声明，会直接抛出未定义错误，导致Passport中断反序列化流程。

错误2：反序列化返回的用户信息不完整 #

你只返回了doc.data().name，但Passport需要完整的用户对象（至少包含能唯一识别用户的标识），否则会话与用户的关联会失效。

修正后的代码：

// 序列化：把用户ID存入会话
// 注意：这里的user应该是你登录时查到的、包含文档ID的用户对象
passport.serializeUser(function(user, done) {
  done(null, user.id);
});

// 反序列化：通过会话里的ID获取完整用户信息
passport.deserializeUser(function(docId, done) {
  DBReg.doc(docId)
    .get()
    .then(doc => {
      if (!doc.exists) {
        // 用户不存在，返回错误信息
        return done(new Error("User not found in Firestore"));
      }
      // 把文档ID和数据合并成完整用户对象，方便后续req.user调用
      const user = { id: doc.id, ...doc.data() };
      done(null, user);
    })
    .catch(err => {
      // 捕获Firestore查询错误，传递给Passport处理
      done(err);
    });
});

2. 确保登录验证环节正确传递用户对象 #

在LocalStrategy的验证函数里，查询到Firestore用户后，一定要把包含文档ID的完整用户对象传给done，否则序列化环节拿不到正确的user.id：

passport.use(new LocalStrategy(
  { usernameField: 'email' }, // 根据你的登录字段调整
  function(email, password, done) {
    DBReg.where('email', '==', email)
      .get()
      .then(snapshot => {
        if (snapshot.empty) {
          return done(null, false, { message: 'Incorrect email.' });
        }
        const doc = snapshot.docs[0];
        // 把文档ID合并到用户数据中
        const user = { id: doc.id, ...doc.data() };
        // 这里替换成你的密码验证逻辑（比如bcrypt对比哈希）
        if (!validatePassword(password, user.password)) {
          return done(null, false, { message: 'Incorrect password.' });
        }
        // 把完整用户对象传给Passport
        return done(null, user);
      })
      .catch(err => done(err));
  }
));

3. 排查会话中间件的挂载顺序 #

req.session里没有passport字段，很大概率是中间件挂载顺序错误。必须严格按照以下顺序挂载：

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

const app = express();

// 1. 先挂载express-session
app.use(session({
  secret: '你的会话密钥',
  resave: false,
  saveUninitialized: false,
  // 测试阶段用内存存储即可，生产环境可以用connect-firestore持久化会话
}));

// 2. 初始化Passport并启用会话支持
app.use(passport.initialize());
app.use(passport.session());

// 3. 最后挂载路由等其他中间件
app.use('/auth', authRoutes);

如果Passport在session之前挂载，它无法访问会话对象，自然不会在req.session里添加passport字段。

4. 额外提示：用Firestore存储会话（可选） #

如果你的应用需要生产环境的持久化会话，可以用connect-firestore模块替代默认的内存存储，会话数据会直接存在Firestore中：

const FirestoreStore = require('connect-firestore')(session);

app.use(session({
  secret: '你的会话密钥',
  resave: false,
  saveUninitialized: false,
  store: new FirestoreStore({
    collection: 'sessions',
    database: firestoreInstance, // 传入你的Firestore实例
  }),
}));

这样就能完美把Passport的会话系统和Firestore结合起来了，我现在的项目就是这么配置的，完全稳定。

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