app.locals变量无法在EJS中访问，登录后全局变量配置报错求助

问题情况 #

我想实现登录后设置全局变量，让应用里所有脚本和模板都能直接引用，不用每个页面重复传递相同值，步骤如下：

• 在index.js里初始化app.locals全局变量，包含uaccId、uaccName、uaccOrgId等字段
• 登录接口/auth中，数据库验证通过后，把request.session里的值同步到app.locals
• EJS页面通过include引入header.ejs，尝试在header.ejs里使用uaccName、uaccOrgName变量

结果运行时抛出TypeError，提示uaccName为undefined，无法调用replace方法，完全访问不到app.locals里的变量。

为啥会出这问题？ #

1. app.locals生命周期与session同步时机不匹配：app.locals是应用级全局变量，初始化后会被所有请求共享。登录时同步session到app.locals的操作仅在当前登录请求生效，后续请求不会自动从session更新app.locals，导致渲染模板时变量无值。
2. 模板上下文继承异常：如果使用res.render时单独传递了局部变量，可能干扰app.locals的继承；或者header.ejs作为被include的模板，未正确获取主模板的上下文。
3. 初始化未设默认值：初始化app.locals时没给uaccName等变量设空值或默认值，未登录状态下直接访问会触发undefined错误。

怎么解决？ #

方法1：用res.locals加全局中间件自动同步session（推荐） #

res.locals是请求级全局变量，每个请求都会重新生成，适合存储用户会话数据。写一个全局中间件，每个请求过来自动把session中的用户信息同步到res.locals：

// index.js 全局中间件
app.use((req, res, next) => {
  // 从session取用户信息，无值则设空字符串
  res.locals.uaccId = req.session.uaccId || '';
  res.locals.uaccName = req.session.uaccName || '';
  res.locals.uaccOrgId = req.session.uaccOrgId || '';
  res.locals.uaccOrgName = req.session.uaccOrgName || '';
  next();
});

登录接口只需更新session即可，无需同步app.locals：

// /auth 登录接口
app.post('/auth', async (req, res) => {
  // 数据库验证逻辑
  const user = await db.query('SELECT * FROM users WHERE ...');
  if (user) {
    // 将用户信息存入session
    req.session.uaccId = user.id;
    req.session.uaccName = user.name;
    req.session.uaccOrgId = user.org_id;
    req.session.uaccOrgName = user.org_name;
    res.redirect('/dashboard');
  } else {
    res.send('登录失败');
  }
});

这样每个请求都会自动同步session数据到res.locals，EJS模板（包括header.ejs）可直接引用变量，无需额外传递。

方法2：修复app.locals同步逻辑（不推荐，多用户会数据混乱） #

如果坚持用app.locals，需在每个请求时从session更新它，但多用户在线时会覆盖彼此的变量，仅适用于单用户测试：

app.use((req, res, next) => {
  if (req.session.uaccId) {
    app.locals.uaccId = req.session.uaccId;
    app.locals.uaccName = req.session.uaccName;
    // 其他变量同理
  }
  next();
});

注意：生产环境绝对不能用这个方法，多用户同时登录会导致用户信息串用。

方法3：给app.locals设默认值，避免未登录报错 #

初始化app.locals时给变量设空字符串，未登录状态下访问不会直接报错：

// index.js 初始化
app.locals.uaccId = '';
app.locals.uaccName = '';
app.locals.uaccOrgId = '';
app.locals.uaccOrgName = '';

但这个方法只能解决报错，无法解决多用户共享app.locals导致的数据混乱问题。

验证方法 #

1. 在header.ejs中添加调试输出，查看变量是否存在：

<!-- header.ejs 调试代码 -->
<% console.log('uaccName的值:', uaccName) %>

2. 在中间件中打印session和res.locals，确认数据同步是否正确：

app.use((req, res, next) => {
  console.log('当前session:', req.session);
  console.log('当前res.locals:', res.locals);
  next();
});

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