远程环境下Web API访问Swagger遇问题：CORS错误与URL路径异常

我之前帮不少开发者解决过Web API 2.2搭配Swagger的这类问题，结合你的情况，咱们分两部分来搞定——先解决CORS错误，再修复路径访问的问题：

一、搞定远程服务器的CORS错误 #

本地正常但远程出CORS问题，大概率是服务器端没正确配置跨域规则，Web API 2.2的CORS配置很直接：

• 先装NuGet包：打开Package Manager Console，跑这个命令
  Install-Package Microsoft.AspNet.WebApi.Cors

• 然后去App_Start/WebApiConfig.cs里启用CORS：
  引入System.Web.Http.Cors命名空间后，在Register方法里加这段配置：

  // 先声明跨域规则，生产环境别用*，换成你的前端域名更安全
  var cors = new EnableCorsAttribute("*", "*", "*");
  config.EnableCors(cors);
  

  把这段放在路由配置之前，确保所有API接口都能应用跨域规则。

• 最后检查服务器端的额外限制：
  如果你的服务器用了IIS，看看有没有手动在HTTP响应头里加过Access-Control-Allow-Origin，别和Web API的配置冲突；要是用了反向代理（比如Nginx、IIS ARR），也得确认代理层没拦截CORS的响应头。

二、让简化路径example.com/swagger/能正常访问 #

必须输完整URL才能进Swagger，一般是路由配置或IIS默认文档的问题，试试这几步：

• 调整Swagger的路由前缀（用Swashbuckle的情况）：
  打开App_Start/SwaggerConfig.cs，在EnableSwaggerUi的配置里指定路由前缀，同时启用自动跳转：

  .EnableSwaggerUi(c =>
  {
      c.RoutePrefix = "swagger"; // 把UI的根路径设为swagger
      c.EnableDiscoveryUrlSelector(); // 支持自动跳转
  });
  

• 给IIS加默认文档或重写规则：
  要么在IIS站点的默认文档里把index.html移到最顶部（因为Swagger UI的入口是swagger/ui/index.html）；要么直接在Web.config里加个重写规则，让/swagger/自动跳转到完整路径：
  在<system.webServer>节点下加这段XML：

  <rewrite>
      <rules>
          <rule name="Swagger Redirect" stopProcessing="true">
              <match url="^swagger/$" />
              <action type="Redirect" url="swagger/ui/index" redirectType="Permanent" />
          </rule>
      </rules>
  </rewrite>
  

  注意：用重写规则的话，得确保IIS装了URL Rewrite模块。

• 适配虚拟目录场景（如果API部署在虚拟目录下）：
  要是你的API部署在IIS的虚拟目录里，得在Swagger配置里指定RootUrl，避免路径拼接错误：

  .EnableSwagger(c =>
  {
      c.RootUrl(req => req.RequestUri.GetLeftPart(UriPartial.Authority) + req.GetRequestContext().VirtualPathRoot);
      // 其他配置...
  })
  

最后再检查这几点 #

• 清一下浏览器缓存，有时候旧的缓存会搞事情；
• 确认服务器防火墙/安全组没拦截Swagger相关的路径；
• 生产环境记得把CORS的*换成具体允许的域名，别留安全隐患。

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