ASP.NET Core MVC项目本地启动首页报404：自动跳转index.html

1. 检查launchSettings.json配置 #

项目根目录下的Properties/launchSettings.json文件控制启动默认URL，大概率是此处配置被修改导致自动打开index.html：

• 打开该文件，找到对应启动配置（如https或IIS Express）下的launchUrl字段，将其修改为空字符串""或直接删除该字段，确保启动时指向默认路由：

"profiles": {
  "YourProjectName": {
    "commandName": "Project",
    "dotnetRunMessages": true,
    "launchBrowser": true,
    "launchUrl": "",
    "applicationUrl": "https://localhost:7053;http://localhost:5053",
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development"
    }
  }
}

• 保存文件后重启项目测试。

2. 清理浏览器缓存与会话 #

浏览器可能缓存了旧的启动URL，导致每次启动自动跳转至index.html：

• 用浏览器隐私模式（无痕窗口）启动项目，验证是否正常打开根路径
• 若隐私模式正常，清理当前浏览器的缓存、Cookie和历史记录后重试

3. 检查Visual Studio调试启动设置 #

如果使用Visual Studio开发，调试时的启动URL可能被手动修改：

• 右键项目 → 属性 → 调试 → 确认"启动浏览器"选项的URL为https://localhost:7053/，而非https://localhost:7053/index.html
• 修改错误配置后保存并重启调试

4. 确认wwwroot目录无残留index.html #

若wwwroot目录下存在index.html静态文件，UseStaticFiles中间件会优先返回该文件，而非走MVC路由：

• 检查项目的wwwroot文件夹，若存在index.html文件直接删除，再重启项目

5. 清理编译缓存 #

编译缓存可能残留异常配置，尝试以下操作：

• 删除项目根目录下的bin和obj文件夹
• 重新执行dotnet clean和dotnet build命令，再启动项目

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