Node.js中无法显示Flash消息，出现req is not defined报错求助

报错信息：

req is not defined

控制器代码（handleSignup函数）：

async function handleSignup(req, res) {
    const username = req.body.username;
    const password = req.body.password;

    try {
        const user = await UserModel.createUser(username, password); // 假设已有数据处理模型
        req.flash('success', 'User registered successfully!');
        res.redirect('/'); // 重定向到signup.ejs页面
    } catch (error) {
        console.error(error);
        res.status(500).send('Error creating user'); // 错误处理
    }
}

视图文件（signup.ejs）：

<% const successMessage = req.flash('success'); %>
<% if (successMessage && successMessage.length > 0) { %>
    <div class="flash-message success">
        <%= successMessage %>
    </div>
<% } %>
...//其他代码

问题原因及解决方法 #

核心原因 #

EJS模板默认无法直接访问req对象，需通过配置让Express把Flash消息暴露给模板，或者使用更规范的res.locals传递全局变量。另外要确保Flash消息的依赖和Session配置正确。

分步解决 #

1. 确认依赖安装与基础配置
   首先必须安装connect-flash（Flash消息依赖）和express-session（Flash需要Session存储数据），然后在Express入口文件中配置：

const express = require('express');
const session = require('express-session');
const flash = require('connect-flash');
const app = express();

// 配置Session（必须在Flash中间件之前）
app.use(session({
  secret: 'your-custom-secret-key', // 替换为自己的安全密钥
  resave: false,
  saveUninitialized: false
}));

// 挂载Flash中间件
app.use(flash());

2. 全局注入Flash消息到模板
   添加一个中间件，自动将Flash消息存入res.locals（所有视图都能直接访问这些变量）：

app.use((req, res, next) => {
  // 把success类型的Flash消息存入全局变量
  res.locals.successMessages = req.flash('success');
  // 可顺便处理error类型的消息
  res.locals.errorMessages = req.flash('error');
  next();
});

注：控制器中的req.flash('success', ...)代码无需修改。

3. 修改EJS视图代码
   直接使用全局变量，不再依赖req：

<% if (successMessages && successMessages.length > 0) { %>
    <div class="flash-message success">
        <%= successMessages %>
    </div>
<% } %>

备选方案（不推荐） #

如果一定要在视图中使用req，可以在渲染页面时手动传递req对象：
比如在对应路由中：

app.get('/', (req, res) => {
  res.render('signup', { req: req });
});

但这种做法不够优雅，res.locals是Express专为模板全局变量设计的机制，更适合这类场景。

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