.Net6应用部署至新Azure App Service访问报页面不存在求助

• 先核对部署文件路径：打开App Service的高级工具(Kudu)，进入DebugConsole的CMD/PowerShell界面，进入site/wwwroot目录检查实际部署的文件位置。绝大多数这类问题都是Pipeline把产物输出到了wwwroot下的子目录（比如dist、build、publish文件夹），没有放到应用服务默认读取的根路径。临时修复可以直接在Kudu里把子目录内的所有文件剪切到wwwroot根目录，或者在配置-路径映射里新增虚拟应用映射，将根路径/指向实际存放部署产物的子目录，保存后重启应用即可。
• 检查启动配置匹配性：进入App Service 配置-常规设置页，确认运行时版本和你本地开发环境的大版本一致（比如Node.js 16和20的依赖兼容性差异、.NET Core和.NET 8的运行时不匹配，都会导致应用启动失败但门户仅标记部署操作成功），同时核对启动命令是否正确：Node项目要指向实际的入口文件（比如node app.js），Python项目要配置正确的gunicorn启动参数，Java项目要确认启动的JAR/WAR包名和配置一致。修改配置保存重启后再验证访问。
• 补全路由与默认文档配置：如果是React/Vue/Angular这类前端单页应用，服务端没有配置路由重写规则时，直接访问非根路径就会返回404：Windows环境App Service可以在wwwroot下新增web.config配置URL重写规则，将所有请求转发到index.html；Linux托管静态站的临时方案可以在启动命令里加cp /home/site/wwwroot/index.html /home/site/wwwroot/404.html，把所有404响应指向首页。同时去配置-默认文档页确认index.html等首页文件在列表内，优先级调到最高。
• 排除端口与缓存问题：检查应用代码的端口监听逻辑，必须优先监听App Service自动注入的PORT环境变量，不要硬编码3000、8080这类固定端口，否则应用无法正常对外提供服务。访问时先用Ctrl+F5强制刷新浏览器，或者开无痕窗口测试，如果前面套了CDN或者Front Door，先purge节点缓存，避免缓存旧的404响应。
• 快速定位根因：打开App Service的日志流功能，重启应用后触发一次访问，看实时输出的运行日志，是文件缺失、启动超时还是路由匹配错误；也可以在Kudu的/LogFiles/Application/目录下查历史运行日志，同时核对Pipeline的详细运行日志——很多时候Pipeline显示成功只是因为没有配置步骤错误判断，某个拷贝文件的子步骤失败了整体任务依然会标绿。

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