如何避免dotnet core后端向React前端返回CORS错误

问题根因 #

你遇到的现象本质是：后端处理请求时抛出未捕获异常，导致请求链路提前中断，.NET没有给响应写入CORS相关头，浏览器接收不到允许跨域的头信息，就会抛出CORS错误，掩盖了后端真实的服务异常。如果异常抛出的位置在日志记录逻辑之前，就会出现无错误日志的情况。

修复与排查方案 #

特别注意：90%以上同类问题都是中间件注册顺序错误导致

• 首先调整Program.cs（或Startup.cs）中的中间件注册顺序，确保UseCors()调用放在UseRouting()、UseAuthorization()、自定义异常处理中间件、接口业务处理逻辑的最前方，保证哪怕后续中间件抛出未处理异常，响应头里已经写入了CORS相关字段，前端就不会把后端异常误判为CORS错误，方便暴露真实问题。
• 配置全局异常捕获机制，推荐使用.NET Core内置的UseExceptionHandler中间件，在异常分支的处理逻辑中手动追加CORS响应头，同时把异常栈、错误信息完整写入日志，避免出现异常无日志的情况，参考代码如下：

// 确保这段代码放在UseCors之后，其他业务中间件之前
app.UseExceptionHandler(errorApp =>
{
    errorApp.Run(async context =>
    {
        // 手动追加CORS头，替换为你实际允许的跨域源配置
        context.Response.Headers.AccessControlAllowOrigin = "你的前端域名";
        context.Response.StatusCode = StatusCodes.Status500InternalServerError;
        context.Response.ContentType = "application/json";
        
        var exception = context.Features.Get<IExceptionHandlerFeature>()?.Error;
        // 完整记录异常栈到日志系统
        logger.LogError(exception, "全局未捕获请求异常，请求路径：{Path}", context.Request.Path);
        
        // 可选：返回标准化错误信息给前端
        await context.Response.WriteAsJsonAsync(new
        {
            Code = 500,
            Message = "服务端内部错误"
        });
    });
});

• 排查未捕获异常的来源：优先检查数据库连接、EF Core实体映射、身份认证模块的代码逻辑，这类底层依赖抛出的未处理异常如果没有被全局捕获，很容易直接导致请求链路中断，无日志输出。如果是.NET Core 3.1或者.NET 5的旧版本，可以排查是否是官方异常处理模块的已知bug，优先升级到最新的LTS版本（.NET 6/8）修复底层问题。
• 增加请求全链路日志，在请求进入中间件的最开始就记录请求唯一标识、请求参数、请求路径，在请求结束（哪怕是异常结束）时都打印链路日志，方便后续定位无法复现的偶发问题。

你之前修改数据库标识就能解决问题，是因为之前的异常本身就是数据库层抛出的未处理异常，修改后异常不会触发，自然就不会出现后续的CORS误报问题。

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