.NET 8 Azure Functions容器化后CORS配置无效求助

排查方向及解决步骤 #

1. 检查容器环境变量优先级 #

Azure Functions容器运行时，AZURE_FUNCTIONS_CORS环境变量会覆盖host.json和代码中的CORS配置。如果容器启动时设置了该变量，会导致你自定义的策略失效。

• 解决：删除容器启动命令中的AZURE_FUNCTIONS_CORS变量，或根据需求设置为*（允许所有源），指定多个源用逗号分隔，如http://localhost:8080。

2. 确认代码配置适配运行模式 #

.NET 8 Azure Functions分Isolated和In-process两种模式，CORS配置方式不同：

• Isolated模式：需自定义中间件处理预检请求，示例代码：

  var host = new HostBuilder()
      .ConfigureFunctionsWorkerDefaults()
      .ConfigureServices(services =>
      {
          services.AddCors(options =>
          {
              options.AddPolicy("AllowAll", policy =>
              {
                  policy.AllowAnyOrigin()
                        .AllowAnyMethod()
                        .AllowAnyHeader()
                        .AllowCredentials();
              });
          });
      })
      .ConfigureFunctionsWorkerDefaults(builder =>
      {
          builder.UseMiddleware<CORSMiddleware>();
      })
      .Build();
  
  host.Run();
  
  // 自定义CORSMiddleware实现
  public class CORSMiddleware : IFunctionsWorkerMiddleware
  {
      public async Task Invoke(FunctionContext context, FunctionExecutionDelegate next)
      {
          var req = await context.GetHttpRequestDataAsync();
          if (req?.Method == HttpMethod.Options.Method)
          {
              var resp = req.CreateResponse(HttpStatusCode.OK);
              resp.Headers.Add("Access-Control-Allow-Origin", "*");
              resp.Headers.Add("Access-Control-Allow-Methods", "*");
              resp.Headers.Add("Access-Control-Allow-Headers", "*");
              resp.Headers.Add("Access-Control-Allow-Credentials", "true");
              await context.GetInvocationResultAsync().SetResult(resp);
              return;
          }
          await next(context);
      }
  }
  

• In-process模式：直接在WebApplication中启用CORS，示例代码：

  var builder = WebApplication.CreateBuilder(args);
  builder.Services.AddCors(options =>
  {
      options.AddPolicy("AllowAll", policy =>
      {
          policy.AllowAnyOrigin()
                .AllowAnyMethod()
                .AllowAnyHeader()
                .AllowCredentials();
      });
  });
  builder.Services.AddAzureFunctions();
  
  var app = builder.Build();
  app.UseCors("AllowAll");
  app.MapFunctions();
  app.Run();
  

3. 处理OPTIONS预检请求 #

带凭据的跨域请求会触发浏览器发送OPTIONS预检请求，若Function未处理该方法，会导致预检失败：

• 方案1：在host.json中全局允许OPTIONS方法：

  {
      "version": "2.0",
      "extensions": {
          "http": {
              "routePrefix": "api",
              "allowedOrigins": "*",
              "allowedMethods": "*",
              "allowedHeaders": "*"
          }
      }
  }
  

• 方案2：在单个Function中显式处理OPTIONS：

  [FunctionName("Wallet")]
  public async Task<IActionResult> Run(
      [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", "options", Route = "wallet")] HttpRequest req,
      ILogger log)
  {
      if (req.Method == HttpMethod.Options.Method)
      {
          return new OkResult();
      }
      // 业务逻辑代码
  }
  

4. 验证容器端口映射 #

确认容器端口映射正确，host.docker.internal:7171需指向容器内Function的监听端口（默认是80或7071）。若映射错误，请求无法到达服务，自然不会返回CORS响应头。

5. 清除浏览器缓存 #

浏览器可能缓存旧的CORS响应，导致新配置不生效。打开开发者工具的Network标签，勾选"Disable cache"后重新发起请求。

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