Express-Handlebars中无法访问res.locals.user变量问题求助

我来帮你捋捋这个问题哈——既然已经搞定了登录和会话创建，那res.locals.user传不到视图里、导致登出链接不显示，大概率是这几个环节出了问题，咱们一步步排查：

1. 先检查中间件的执行顺序 #

Express的中间件是按代码顺序执行的，要是你设置res.locals.user的代码放错了位置，肯定拿不到会话里的用户信息。正确的顺序应该是这样的：

// 第一步：先加载会话中间件（比如express-session）
app.use(session({
  secret: '你的密钥',
  resave: false,
  saveUninitialized: false
}));

// 第二步：设置res.locals.user的中间件，必须放在路由之前
app.use((req, res, next) => {
  // 从会话里取出用户信息，挂载到res.locals供视图使用
  res.locals.user = req.session.user || null;
  next(); // 别忘了调用next，不然请求会卡住
});

// 第三步：再加载你的路由
app.use('/', require('./routes/index'));

要是你用了会话存储的第三方库（比如connect-mongo），也要保证它在res.locals中间件之前执行

2. 确认登录时会话是否正确存了用户信息 #

登录成功后，你得把用户信息写入req.session.user，不然会话里是空的，res.locals自然拿不到。比如登录路由里的代码应该是这样的：

router.post('/login', async (req, res) => {
  // 这里是你查询Neo4J验证用户的逻辑
  const user = await verifyUser(req.body.email, req.body.password);
  if (user) {
    // 把用户的必要信息存入会话（别存密码这类敏感数据）
    req.session.user = { id: user.id, email: user.email };
    res.redirect('/');
  } else {
    res.redirect('/login');
  }
});

你可以在设置res.locals的中间件里加个console.log(req.session.user)，登录后看看控制台有没有输出用户信息——要是没有，那就是登录时没把用户存进会话，这时候视图肯定拿不到user。

3. 检查Handlebars模板的语法是否正确 #

别小看拼写和语法错误！确保模板里的{{#if user}}没写错，比如大小写、闭合标签：

<!-- 正确的示例 -->
<nav>
  {{#if user}}
    <a href="/logout">登出</a>
  {{else}}
    <a href="/login">登录</a>
    <a href="/register">注册</a>
  {{/if}}
</nav>

另外还要确认你正确配置了Handlebars引擎：

app.engine('handlebars', exphbs.engine({ defaultLayout: 'main' }));
app.set('view engine', 'handlebars');

要是引擎没配置对，模板里的表达式根本不会被解析。

4. 检查路由里有没有覆盖res.locals.user #

如果某个路由渲染视图时手动传了user: null，会直接覆盖全局的res.locals设置。比如这种错误写法：

// 错误：手动传user覆盖了全局值
router.get('/', (req, res) => {
  res.render('home', { user: null });
});

正确的做法是渲染视图时不用传user，直接用全局的res.locals：

router.get('/', (req, res) => {
  res.render('home'); // 视图会自动读取res.locals.user
});

5. 确认会话Cookie是否正常生成 #

登录后打开浏览器开发者工具的Cookie面板，看看有没有connect.sid（express-session默认的会话Cookie名）。要是没有，说明会话中间件没正确设置Cookie，req.session里自然没有用户信息。

你可以按照上面的步骤一步步排查，先从中间件顺序和会话存储开始，这俩是最常见的问题～

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