如何在.NET Core中诊断CORS问题？是否有相关日志记录？

一、启用CORS原生调试日志 #

.NET Core的CORS中间件默认不会输出详细的匹配失败日志，但可以通过调整日志级别开启Debug级别的调试信息。修改appsettings.json中的日志配置：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "Microsoft.AspNetCore.Cors": "Debug"
    }
  }
}

启用后，当请求源不符合CORS策略时，日志中会出现类似内容：

Debug: Microsoft.AspNetCore.Cors.Infrastructure.CorsService[11]
The origin 'http://test-frontend.com' is not allowed by the CORS policy.

不过原生日志不会直接显示你配置的预期源，需要结合自身配置排查。

二、自定义中间件记录精准匹配细节 #

如果需要明确看到请求源和预期允许源的对比日志，可以在UseCors之前添加自定义中间件，手动校验并记录：

public void Configure(IApplicationBuilder app)
{
    // 自定义CORS诊断中间件
    app.Use(async (context, next) =>
    {
        var policyProvider = context.RequestServices.GetRequiredService<ICorsPolicyProvider>();
        var corsPolicy = await policyProvider.GetPolicyAsync(context, "MyCorsPolicy");
        
        if (corsPolicy != null)
        {
            var requestOrigin = context.Request.Headers["Origin"].FirstOrDefault();
            if (!string.IsNullOrEmpty(requestOrigin))
            {
                var corsService = context.RequestServices.GetRequiredService<ICorsService>();
                var evaluateResult = corsService.EvaluatePolicy(context, corsPolicy);
                
                if (!evaluateResult.IsSuccessful)
                {
                    var allowedOrigins = string.Join(", ", corsPolicy.Origins);
                    var logger = context.RequestServices.GetRequiredService<ILogger<Startup>>();
                    logger.LogWarning("CORS验证失败：请求源为'{RequestOrigin}'，配置允许的源为'{AllowedOrigins}'",
                        requestOrigin, allowedOrigins);
                }
            }
        }

        await next();
    });

    app.UseCors("MyCorsPolicy");
    // 其他中间件配置...
}

运行后，当出现源不匹配时，日志会清晰显示：

Warning: YourNamespace.Startup[0]
CORS验证失败：请求源为'http://test-frontend.com'，配置允许的源为'http://integration-frontend.com'

三、快速验证配置值的小技巧 #

在调试阶段，可以先把从环境变量获取的前端URL打印到日志，直接确认配置是否正确，避免试错：

public void ConfigureServices(IServiceCollection services)
{
    var frontendUrl = GetFrontendUrlFromEnvironmentVariable();
    // 临时打印配置值
    var loggerFactory = services.BuildServiceProvider().GetRequiredService<ILoggerFactory>();
    var logger = loggerFactory.CreateLogger<Startup>();
    logger.LogInformation("当前CORS策略允许的源：{FrontendUrl}", frontendUrl);

    services.AddCors(options =>
    {
        options.AddPolicy("MyCorsPolicy", builder =>
        {
            builder.WithOrigins(frontendUrl)
                   .AllowAnyMethod()
                   .AllowAnyHeader();
        });
    });
}

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