Azure Web App部署TypeScript Node.js服务遇权限问题求助

问题概述 #

基于VS2019「Basic Azure Node.js Express 4 Application」模板开发的TypeScript Node.js服务，本地运行正常，但部署到Azure Web App后出现以下问题：

• 默认虚拟路径下，返回「你正在查找的资源已被移除、名称已更改或暂时不可用。」
• 将根虚拟路径改为site\wwwroot\dist\src后，返回「你无权查看此目录或页面。」

部署后通过Kudu查看文件结构，TypeScript编译产物嵌套在wwwroot/dist/src下，而预期index.js应直接位于dist根目录。

问题根源 #

1. 编译路径配置错误：tsconfig.json未指定rootDir，导致编译产物保留了src的目录层级，输出到dist/src下。
2. web.config与虚拟路径不匹配：修改虚拟路径后，web.config未对应调整，IISNode无法正确定位入口文件，触发权限拦截。

解决方案 #

1. 修正TypeScript编译输出路径 #

更新tsconfig.json，添加rootDir指定源码根目录，确保编译产物直接输出到dist根目录：

{
  "compilerOptions": {
    "module": "commonjs",
    "esModuleInterop": true,
    "target": "es5",
    "outDir": "./dist",
    "rootDir": "./src", // 指定源码根目录，消除嵌套层级
    "baseUrl": ".",
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

执行npm run build后，编译产物结构变为：

|-dist
|---index.js
|---index.js.map
|---environments
|---middlewares
...

2. 重置Azure Web App虚拟路径 #

将根虚拟路径恢复为site\wwwroot，无需指向子目录，后续通过web.config引导请求到正确入口。

3. 更新web.config配置 #

修改web.config，让IISNode正确指向编译后的入口文件，并配置路由重写规则：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <appSettings>
        <add key="iisnode:nodeProcessCommandLine" value="node.exe" />
    </appSettings>
    <system.webServer>
        <staticContent>
            <mimeMap fileExtension=".svg" mimeType="image/svg+xml" />
        </staticContent>
        <modules runAllManagedModulesForAllRequests="false" />
        <iisnode watchedFiles="web.config;dist\*.js;dist\**\*.js" />
        <handlers>
            <!-- 指向dist下的index.js作为服务入口 -->
            <add name="iisnode" path="dist/index.js" verb="*" modules="iisnode" />
        </handlers>
        <rewrite>
            <rules>
                <clear />
                <!-- 所有非iisnode相关请求重写到入口文件 -->
                <rule name="NodeAppRewrite" enabled="true" stopProcessing="true">
                    <match url="^(?!iisnode)" />
                    <action type="Rewrite" url="dist/index.js" />
                </rule>
            </rules>
        </rewrite>
        <!-- 隐藏dist目录，避免直接访问 -->
        <security>
            <requestFiltering>
                <hiddenSegments>
                    <add segment="dist" />
                </hiddenSegments>
            </requestFiltering>
        </security>
    </system.webServer>
</configuration>

4. 重新部署验证 #

1. 本地执行npm run build确认编译产物路径正确
2. 在VS2019中重新发布项目到Azure Web App
3. 通过Kudu确认wwwroot/dist目录结构符合预期
4. 访问Web App地址，验证服务正常响应

额外排查点 #

• 确认Azure Web App的Node.js版本与本地开发环境一致（Azure门户→配置→常规设置）
• 检查package.json的main字段是否设置为dist/index.js
• 若问题仍存在，开启Azure门户的「诊断日志」，查看具体错误日志定位问题

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