ASP.NET Core WebAPI部署后Swagger报Failed to fetch（CORS/网络故障）求助

针对你遇到的「Failed to fetch. Possible Reasons: CORS Network Failure」错误，因应用在本地和新服务器正常，问题锁定在原Ubuntu服务器的环境配置上，按以下步骤排查：

1. 检查服务器防火墙与端口可用性 #

• 执行ufw status或iptables -L查看应用监听端口（如5000/7000）是否在防火墙规则中开放，未开放则用ufw allow <端口号>临时开放测试
• 在服务器本地执行curl http://localhost:<端口号>/api/[你的测试接口]，确认应用本身能正常响应，排除端口不通的底层问题

2. 验证PM2启动配置与日志 #

• 查看PM2启动命令，确认是否正确设置ASPNETCORE_ENVIRONMENT等环境变量，避免因环境差异导致CORS配置未加载
• 执行pm2 logs <你的应用名称>，检查日志中是否有CORS请求被拦截的报错，或应用启动时的配置加载异常
• 确认PM2启动时未遗漏应用配置文件路径，比如是否通过--env参数指定了正确的appsettings环境配置

3. 排查系统级网络限制 #

• 执行sestatus检查SELINUX状态，若处于Enforcing模式，临时执行setenforce 0关闭后测试，排除SELINUX拦截端口请求的可能
• 用tcpdump port <应用端口号>抓包，观察客户端的OPTIONS预检请求是否到达服务器，判断请求是否被中间网络或系统规则拦截

4. 临时放宽CORS配置测试 #

• 临时修改应用的CORS配置为允许所有来源（仅用于排查，生产环境需改回严格配置）：

  builder.Services.AddCors(options =>
  {
      options.AddPolicy("TemporaryAllowAll", policy =>
      {
          policy.AllowAnyOrigin()
                .AllowAnyMethod()
                .AllowAnyHeader();
      });
  });
  
  // 确保在UseRouting之后、UseAuthorization之前添加UseCors
  app.UseRouting();
  app.UseCors("TemporaryAllowAll");
  app.UseAuthorization();
  

• 重新发布到原服务器，用pm2 restart <应用名称>重启后测试Swagger接口，若恢复正常则说明原服务器环境下CORS配置的规则未匹配到请求来源

5. 反向代理（如Nginx）的CORS配置检查 #

• 若使用Nginx反向代理，检查配置是否正确处理了CORS预检请求，添加必要的响应头：

  location / {
      proxy_pass http://localhost:<应用端口号>;
      proxy_http_version 1.1;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
  
      # 处理CORS
      add_header Access-Control-Allow-Origin $http_origin always;
      add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS, PUT, DELETE' always;
      add_header Access-Control-Allow-Headers 'Content-Type, Authorization' always;
  
      # 直接响应OPTIONS预检请求
      if ($request_method = OPTIONS) {
          return 204;
      }
  }
  

• 修改后执行nginx -s reload重启服务，测试接口是否恢复正常

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