Express中使用req.redirect时如何正确显示Flash消息？

问题背景 #

用Express.js、MongoDB和Handlebars开发博客应用时，遇到以下问题：

• 使用req.redirect配合req.flash()时，页面无法展示Flash消息
• 使用req.render搭配req.flash()时消息显示正常，但无法实现页面跳转需求
• 控制台能打印出Flash消息内容，说明消息已生成但未传递到跳转后的页面

问题代码 #

Session与Flash配置 #

// Session
app.use(session({
secret: 'secret',
resave: true,
saveUninitialized: true,
cookie: {secure: true}
}));
app.use(flash());
// Middleware
app.use((req, res, next) => {
res.locals.success_msg = req.flash(('success_msg')[0]);
res.locals.error_msg = req.flash(("error_msg")[0]);
next();
});

路由逻辑 #

adminRouter.post('/categories/delete', async (req, res) => {
try {
const { id } = req.body;
await Category.deleteOne({_id: id });
req.flash('success_msg', 'Category deleted successfully');
res.redirect("/admin/categories");
} catch (err) {
req.flash('error_msg', `Error to delete category: ${err}`);
res.redirect('admin/categories');
}
})

Handlebars渲染代码 #

{{#if success_msg}}
<div class="alert alert-success">{{success_msg}} </div>

{{else if error_msg}}
<div class="alert alert-danger"> {{error_msg}}  </div>
{{/if}}

问题分析 #

1. 语法错误：中间件中req.flash(('success_msg')[0])的写法错误，('success_msg')[0]会取字符串s，实际调用的是req.flash('s')，根本没获取到目标Flash消息。
2. Session Cookie配置错误：cookie: {secure: true}要求仅在HTTPS连接下传递Cookie，开发环境通常用HTTP，导致Session无法保存，Flash消息无法跨请求传递。
3. 相对路径跳转隐患：catch块中res.redirect('admin/categories')是相对路径，可能导致跳转路径错误，无法正确加载目标页面的Flash消息。

修复方案 #

1. 修正中间件语法错误 #

调整括号位置，正确获取Flash消息的第一个元素：

app.use((req, res, next) => {
  res.locals.success_msg = req.flash('success_msg')[0];
  res.locals.error_msg = req.flash('error_msg')[0];
  next();
});

2. 调整Session Cookie配置 #

根据环境动态设置secure属性，开发环境禁用HTTPS Cookie要求：

app.use(session({
  secret: 'secret',
  resave: false, // 遵循Express最佳实践，关闭不必要的Session刷新
  saveUninitialized: false, // 避免保存未初始化的Session
  cookie: {
    secure: process.env.NODE_ENV === 'production' // 仅生产环境启用HTTPS Cookie
  }
}));

3. 统一跳转路径为绝对路径 #

确保跳转路径一致且正确：

adminRouter.post('/categories/delete', async (req, res) => {
  try {
    const { id } = req.body;
    await Category.deleteOne({_id: id });
    req.flash('success_msg', '分类删除成功');
    res.redirect("/admin/categories");
  } catch (err) {
    req.flash('error_msg', `删除分类失败：${err}`);
    res.redirect("/admin/categories"); // 改为绝对路径
  }
})

验证 #

修复后重新测试删除分类流程：

1. 提交删除请求后，Flash消息会存入Session
2. 跳转至/admin/categories时，中间件会从Session中取出消息并挂载到res.locals
3. Handlebars模板能正确渲染对应的提示消息

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