使用VS2019发布MVC项目到Azure后默认路由返回404求助

我完全懂你现在的困惑——本地跑起来顺得不行，一发布到Azure就遇到默认路由404，其他页面还正常，找资料全是Angular的方案，属实头疼。结合你的描述，我帮你梳理几个最可能的原因和解决办法：

1. 未配置数据库引发的隐性异常（优先级最高） #

你提到索引页面需要从数据库加载内容，但数据库还没配置，这大概率是核心问题。本地运行时你可能依赖的是本地数据库，所以能正常渲染页面；但发布到Azure后，项目尝试连接未配置的数据库，抛出了异常，不过Azure默认会隐藏详细错误，反而返回了404，而非预期的错误页面。

解决建议：

• 先快速验证：临时修改HomeController里的Index方法，注释掉所有数据库相关的代码，改成返回一个静态视图（比如直接返回View()，或者写个简单的静态HTML内容）。如果修改后默认路由能正常访问，那百分百是数据库的锅。
• 正式解决：在Azure上配置好对应的数据库（比如Azure SQL Database），然后到应用服务的配置→连接字符串里添加正确的连接字符串，确保名称和你项目中使用的一致。

2. MVC路由配置的细节检查 #

虽然其他路由正常，但还是要确认默认路由的配置有没有发布后失效的情况：

• 打开项目的路由配置文件：
  • 如果是.NET Core/.NET 5+项目，看Startup.cs或者Program.cs里的端点配置：

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    });
    

  • 如果是.NET Framework项目，看RouteConfig.cs：

    routes.MapRoute(
        name: "default",
        url: "{controller}/{action}/{id}",
        defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
    );
    

• 同时确认HomeController的Index方法是public的，而且没有被[HttpPost]这类特性限制（默认路由是GET请求，如果加了[HttpPost]就会导致GET访问返回404）。

3. Azure应用服务的默认文档与发布完整性检查 #

有时候Azure的默认文档设置或者发布时的文件遗漏也会导致这个问题：

• 登录Azure门户，进入你的应用服务，找到配置→默认文档，手动添加Index.cshtml（虽然MVC框架会自动处理，但手动添加能规避一些特殊情况）。
• 检查发布文件是否完整：通过Azure应用服务的高级工具→Kudu，进入wwwroot/Views/Home目录，确认Index.cshtml文件存在。如果缺失，重新发布项目，确保发布设置里包含了所有视图文件。

4. 开启错误日志定位根源 #

如果以上步骤都没解决，建议开启Azure的错误日志，查看具体的报错信息：

• 进入应用服务的监控→日志流，实时查看应用运行时的错误日志；或者通过Kudu的Debug console→LogFiles目录，查看详细的错误日志。这些日志能直接告诉你是数据库连接失败、视图文件缺失还是其他路由问题。

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