Node.js中Passport.js+express-flash登录报错：req.flash不是函数

1. 解决「req.flash is not a function」错误 #

你的中间件执行顺序完全错误，Express 中间件按加载顺序执行，session 必须在 flash、passport 及路由之前加载——因为 flash 依赖 session 存储消息，路由中的 Passport 认证也需要 session 支持。

修改后的 app.js 代码：

app.set("view engine", "ejs")

// 中间件顺序严格遵循：解析器 → session → flash → passport → 路由
app.use(bodyParser.urlencoded({ extended: true }))
app.use(session({
    secret: process.env.SESSION_SECRET,
    resave: false,
    saveUninitialized: false
}))
app.use(flash())

// 初始化 Passport
initializePassport(passport)
app.use(passport.initialize())
app.use(passport.session())

// 最后加载路由
const loginRoute = require("./routes/Login")
const registerRoute = require("./routes/Register")
app.use("/login", loginRoute)
app.use("/register", registerRoute)

2. 解决「messages is not defined」错误 #

该问题源于两个点：一是中间件顺序错误导致 flash 消息未生成，二是渲染模板时未主动传递 flash 消息。

修改 login.js 的 GET 路由 #

在渲染登录页时，将 flash 错误消息传入模板：

router.get('/', (req, res) => {
    // 获取 flash 存储的 error 消息，传给模板的 messages 变量
    res.render("login", { messages: { error: req.flash('error') } })
})

优化 login.ejs 的消息展示逻辑 #

注意：req.flash('error') 返回的是数组，需处理空数组场景：

<h1>LogIn</h1>
<% if (messages.error && messages.error.length > 0) { %>
    <div style="color: red;"><%= messages.error[0] %></div>
<% } %>
<form action="/login" method="POST">
    <div>
        <label for="email">Email</label>
        <input type="email" id="email" name="email" required="true">
    </div>
    <div>
        <label for="password">Password</label>
        <input type="password" id="password" name="password" required="true">
    </div>
    <button type="submit">Login</button>
</form>

<a href="/register">Register</a>

3. 修复 Passport 序列化/反序列化函数 #

你当前的 serializeUser 和 deserializeUser 是空实现，会导致用户登录后无法持久化会话，必须补充实现：

// serialize user to store inside of a session
passport.serializeUser((user, done) => {
    // 假设你的 user 对象包含 id 字段，用 id 作为会话标识
    done(null, user.id)
})
// deserialize user from session
passport.deserializeUser((id, done) => {
    // 根据 id 从用户列表中查找对应用户
    const user = Users.find(u => u.id === id)
    done(null, user)
})

验证步骤 #

1. 重启 Node.js 服务
2. 使用错误邮箱/密码登录，验证错误消息是否正常展示
3. 确认登录成功后会话可正常持久化

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