ASP.NET Core 6 MVC发布到本地IIS路由失效报HTTP 500错误

首先你贴的Program.cs里存在明确的中间件顺序错误，这是路由异常的核心诱因之一，按以下步骤逐一排查修复：

1. 修正中间件注册顺序 #

ASP.NET Core中间件严格按照代码里的注册顺序执行，你当前的顺序完全不符合MVC应用的规范，直接替换Program.cs中var app = builder.Build();之后的代码为以下内容：

var app = builder.Build();

// 生产环境异常处理，VS调试时走开发异常页不受影响
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    app.UseHsts();
}

// 注意：UseDefaultFiles必须注册在UseStaticFiles之前，否则默认文档重写逻辑不生效
app.UseDefaultFiles();
app.UseStaticFiles();

app.UseRouting();

// 后续如果加权限控制，UseAuthentication/UseAuthorization放在这两个中间件之间

// .NET 6 Minimal API模式下不需要套UseEndpoints，直接映射路由即可
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

你原来的写法把UseStaticFiles放在UseDefaultFiles前面，还把UseEndpoints放在静态文件中间件后面，会导致非首页的路由请求先被静态文件模块处理，匹配不到文件后再走路由，逻辑错位很容易触发异常。

2. 定位具体500错误的根因 #

首页能正常加载说明你的IIS已经装了.NET 6 Hosting Bundle，应用进程可以正常启动，其他页面报500属于运行时异常，必须拿到具体错误栈才能精准修复：

• 打开发布目录下的web.config，找到stdoutLogEnabled="false"，把值改成true，在发布目录下新建名为logs的文件夹，给IIS对应应用池的运行账号开这个文件夹的读写权限，刷新报错页面后，logs文件夹里会生成详细的运行日志，里面会写清楚具体抛错的位置
• 临时调试可以在发布后的appsettings.json里加配置"ASPNETCORE_ENVIRONMENT": "Development"，或者直接在IIS站点的配置项里加这个环境变量，刷新报错页就能直接在浏览器看到详细的异常信息，这类非首页500的常见原因有：
  • 跳转目标页面依赖的服务没有在DI容器里注册，你现在只注册了IDomain、IItem两个仓储服务，如果对应Controller或者视图里依赖了其他没注册的服务，请求进来就会抛500
  • 发布后的数据库连接串配置错误，比如VS调试时用的是LocalDB实例，部署到IIS后应用池账号没有LocalDB访问权限，或者连接的SQL Server实例地址不对、账号密码错，刚好首页没查数据库、其他页面查库就会报错
  • 发布时遗漏了依赖文件，比如对应页面的Razor视图没有被编译进发布包，或者缺少相关的NuGet依赖dll
• 检查IIS对应应用池的配置：.NET CLR版本必须选「无托管代码」，ASP.NET Core是独立的自托管进程运行，不要选任何.NET Framework版本的CLR，否则会导致部分请求处理异常。

3. 路由规则验证 #

修正代码后先在本地右键项目选「发布」，发布到本地文件夹后用IIS挂载测试，确认跳转正常：

• 页面上的跳转链接不要写硬编码的相对路径，统一用Url.Action方法或者MVC的Tag Helper生成地址，避免发布到IIS虚拟目录时路径前缀不对触发匹配错误（这类问题一般报404，你现在的500大概率是上面提到的运行时异常）。

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