Azure部署的Express服务器无法找到Handlebars视图求助

问题背景 #

本地开发时，Express结合Handlebars渲染HTML完全正常，但部署到Azure staging服务器后，访问指定路由返回以下错误：

Error: Failed to lookup view "reset-password" in views directory "/usr/src/server/public/html"

原项目使用纯HTML文件时部署正常，替换为.handlebars（或.ejs）后缀后出现该问题。

相关代码片段 #

路由实现

userRouter.get(
    '/template-reset-password/:from',
    async (req: Request, res: Response) => {
        return res.status(200).render('reset-password', { data: req.data });
    },
);

Express视图引擎配置

app.engine(
    'handlebars',
    engine({
        defaultLayout: false,
        layoutsDir: `${__dirname}/public/html`,
    }),
);
app.set('view engine', 'handlebars');
app.set('views', `${__dirname}/public/html`);

排查与解决方案 #

1. 验证部署后文件存在性 #

• 登录Azure门户，进入目标App Service，打开高级工具 > Kudu，导航到/usr/src/server/public/html目录，确认reset-password.handlebars文件是否存在
• 若文件缺失，检查部署配置（GitHub Actions、Azure DevOps或本地部署命令），确保.handlebars文件被纳入部署包。多数构建脚本默认仅打包.js/.ts/.json文件，需手动添加视图文件规则

2. 修正路径计算逻辑 #

__dirname在TypeScript编译后或容器化环境中可能指向错误目录，改用path模块结合process.cwd()计算稳定路径：

import path from 'path';

// 更新视图引擎配置
app.engine(
    'handlebars',
    engine({
        defaultLayout: false,
        layoutsDir: path.join(process.cwd(), 'public', 'html'),
    }),
);
app.set('view engine', 'handlebars');
app.set('views', path.join(process.cwd(), 'public', 'html'));

process.cwd()始终指向应用根目录，避免编译或部署环境导致的路径偏移。

3. 确认启动命令正确性 #

确保Azure App Service的启动命令指向编译后的入口文件，例如TypeScript编译输出到dist目录时，启动命令应为：

node dist/index.js

禁止直接使用ts-node启动，除非已在Azure配置完整的TypeScript运行环境。

4. 匹配视图文件后缀与引擎配置 #

• 确保视图文件后缀为.handlebars，与配置的引擎名称完全一致；若使用.hbs后缀，需将配置中的handlebars替换为hbs，同时修改视图文件名
• 检查render方法调用时是否省略了后缀（默认会自动拼接配置的视图引擎后缀，无需手动添加）

5. 更新打包文件包含规则 #

若使用package.json的files字段或构建工具配置，需添加视图文件路径：

// package.json示例
"files": [
  "dist",
  "public/html/*.handlebars"
]

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