Azure部署的.NET 6 Web App默认首页无法访问问题求助

架构老林

2026-8-15

.NET 6 Web App部署Azure后默认首页无法访问的解决办法

出现这种情况大概率是默认路由或Azure Web App的默认文档配置缺失，以下是针对性的排查和修复步骤：

检查项目路由配置
打开项目根目录的Program.cs，确认是否配置了正确的默认路由规则：
- 若为MVC项目，需确保存在如下代码：
```
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");
```
- 若为Razor Pages项目，需确保添加了：
```
app.MapRazorPages();
```
  同时确认Pages目录下存在Index.cshtml文件。
配置Azure Web App默认文档
登录Azure门户，进入目标Web App的配置 -> 默认文档页面：
- 添加index、Index.cshtml或index.html（根据你的项目首页类型）到默认文档列表
- 将刚添加的条目拖动到列表最顶部，确保优先匹配
- 保存配置后重启Web App生效
检查发布配置文件
打开项目的发布配置文件（.pubxml），确认没有覆盖默认文档的配置节点，若存在<DefaultDocument>相关设置，需确保其包含正确的首页文件名。
静态首页场景排查
如果首页是静态HTML文件，需确认Program.cs中已添加静态文件中间件：
```
app.UseStaticFiles();
```
同时确保wwwroot目录下存在index.html，并在Azure默认文档中添加该文件名。