如何在Express.js中清除hbs单个视图文件的缓存？

方法1：全局禁用视图缓存（仅调试用） #

生产环境默认开启视图缓存以提升性能，若只是临时调试模板，可以直接关闭全局缓存：

// 在Express应用初始化阶段添加
app.set('view cache', false);

// 也可在配置hbs引擎时直接关闭缓存
const hbs = require('hbs');
app.engine('hbs', hbs({ cache: false }));

注意：长期在生产环境关闭缓存会降低服务性能，调试完成后建议恢复默认设置。

方法2：手动清除指定模板的缓存 #

如果需要保留全局缓存、仅更新修改后的模板，可以直接操作HBS的内部缓存。HBS编译后的模板缓存存储在hbs.handlebars.cache对象中，缓存键为模板的绝对路径。你可以编写工具函数精准清除目标模板：

const hbs = require('hbs');
const path = require('path');

function clearHbsTemplateCache(templateRelativePath) {
    // 转换为绝对路径，匹配缓存键格式
    const absoluteTemplatePath = path.resolve(__dirname, templateRelativePath);
    // 删除对应缓存项
    delete hbs.handlebars.cache[absoluteTemplatePath];
}

// 调用示例：清除首页模板缓存
clearHbsTemplateCache('../_cache/homepage-1.hbs');

你可以结合文件监听工具（如chokidar），在模板文件修改时自动触发这个函数，实现缓存自动更新。

方法3：单次渲染时禁用缓存 #

如果只需要某一次请求加载最新模板，可在渲染时通过参数临时禁用该模板的缓存：

router.get('/', function(req, res, next) {
    res.render('../_cache/homepage-1.hbs', {
        title: 'Home',
        style: 'home-new',
        projectSlug: 'homepage',
        // 添加强制不使用缓存的选项
        cache: false
    });
});

该方法仅对当前请求生效，不会影响全局缓存策略。

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