Express怎么让所有模板都能用的全局变量突然失效了？

Mc.玉娟提问于 2026-01-26 20:05:22 阅读 52

前端

我在用Express做项目时，之前设置的全局变量突然在模板里显示undefined了。之前在app.js里这样配置的：

// app.js
app.locals.siteName = '我的博客';
app.set('views', './views');
app.set('view engine', 'ejs');

现在新创建的路由页面访问不到siteName变量了，但旧页面还能正常显示。我检查过路由文件没改过，连模板语法都确认过是，这是什么情况啊？

我来解答赞 9 收藏

反馈

2 条解答

UX雨鑫 Lv1

你这种情况，可能是全局变量被覆盖或者重置了。app.locals 是全局对象，但如果在某个路由或中间件里不小心改写了它，或者用了同名变量覆盖了全局的值，就会导致新页面访问不到。

你可以先做几个校验：

1. 在出问题的路由文件顶部加一个中间件，打印一下 req.app.locals，确认全局变量是否存在：

router.get('/', (req, res) => {

     console.log(req.app.locals);

     res.render('some-page');

   });

2. 检查你的中间件链，有没有地方调用了 res.locals 赋值了同名字段但未正确传递，或者用了 app.locals = { ... } 这种方式重写整个对象。

3. 确保你没有在模板中修改变量，虽然 EJS 一般不会允许这种操作，但如果用了 <% siteName = 'xxx' %> 这样的代码，可能会影响后续输出。

4. 查看是否有模板继承或引入了其他变量覆盖了上下文。

如果你确认是 app.locals 没问题，但某些页面还是取不到，可以考虑把变量统一挂载到 res.locals 上，比如加一个全局中间件：

app.use((req, res, next) => {

  res.locals.siteName = '我的博客';

  next();

});

这样不管哪个路由渲染模板，都能确保变量存在。

最后提醒一点：全局变量容易被覆盖或误改，如果涉及敏感信息（如配置、密钥等），一定不要直接暴露给模板。这种场景可以考虑在模板里用 API 接口获取，或者用中间件做更精细的注入。

2026-02-04 06:00

爱学习的艳鑫 Lv1

这问题挺常见的，估计是你新增的路由文件里没正确加载全局变量配置导致的。虽然你在app.js里设置了app.locals.siteName，但如果新路由文件里没有正确引入主应用实例（app），或者用了不同的中间件覆盖了这些设置，就会出现这种情况。

更好的写法是把全局变量抽到一个单独的函数里，确保所有地方都能用上。比如这样：

// 在 app.js 或单独的 config 文件里

function setupGlobals(app) {

    app.locals.siteName = '我的博客';

    // 如果还有其他全局变量也放这里

}



// 然后在 app.js 里调用一次

setupGlobals(app);



// 新增的路由文件也要手动传入 app 并调用

const express = require('express');

const router = express.Router();



module.exports = function (app) {

    setupGlobals(app); // 确保这里的路由也能用全局变量

    router.get('/newpage', (req, res) => {

        res.render('newpage'); // 这样 siteName 就不会 undefined 了

    });

    return router;

};

这种写法的好处是，不管多少个路由文件，只要记得传入app并调用这个函数，所有模板都能正常访问全局变量。别忘了检查一下新路由是不是在独立文件里写的，如果是的话大概率是这个原因。

2026-01-28 23:00