从.Net Web API升级到.Net Core后运行报localhost无法处理请求500错误

第一步：先获取明确的错误栈 #

500是通用服务端错误，必须拿到具体异常才能精准定位，可通过以下方式获取：

• 运行项目时直接看控制台输出，dotnet run启动的终端会打印完整的异常栈和错误原因
• 临时强制启用开发者异常页，修改Configure方法开头的代码：

// 放在所有中间件最前面，排查完成后记得按环境区分还原
app.UseDeveloperExceptionPage();

• Windows平台还可以查看系统事件查看器，Windows日志→应用程序里找对应.NET Runtime的错误日志

第二步：修复Startup.cs中的明确错误 #

1. 修正CORS中间件顺序 #

ASP.NET Core对中间件顺序要求严格，CORS必须放在UseRouting之后、UseAuthorization之前，你当前的顺序错误会直接导致请求处理失败，修正后顺序：

app.UseStaticFiles();
app.UseRouting();
// CORS移到授权前面
app.UseCors(MyAllowSpecificOrigins);
app.UseAuthorization();

2. 修正CORS策略配置 #

你要允许所有来源的话，推荐直接用官方提供的AllowAnyOrigin方法，避免配置异常：

services.AddCors(options =>
{
    options.AddPolicy(name: MyAllowSpecificOrigins,
        builder =>
        {
            builder.AllowAnyOrigin()
                   .AllowAnyHeader()
                   .AllowAnyMethod();
        });
});

注意：如果你的接口开启了身份验证需要携带Cookie，不能使用允许所有来源的配置，必须明确指定允许的域名列表

3. 适配Web API项目的服务和路由配置 #

你是Web API项目，不需要MVC视图相关的服务和路由，修改对应配置：

• 服务注册部分替换AddControllersWithViews为AddControllers：

services.AddControllers(ConfigureMvcOptions)
    .AddNewtonsoftJson(options =>
    {
        options.UseMemberCasing();
    });

• 终结点配置替换默认MVC路由为API路由：

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
});

第三步：排查常见升级遗留问题 #

• 检查appsettings.json等配置文件的属性，确认“复制到输出目录”设置为如果较新则复制，避免配置读取失败报错
• 检查所有NuGet包版本，Microsoft.AspNetCore开头的包必须和你目标.NET版本保持一致，不要混合多个版本的官方包
• 如果升级到.NET 6+版本，确认Program.cs中正确引入了Startup配置，没有出现新旧启动配置冲突
• 删除旧项目遗留的web.config中system.web节点的旧配置，避免和ASP.NET Core配置冲突

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