ASP.NET MVC WebAPI文件上传接口OPTIONS请求报405错误排查与解决

a) 为什么只有这个文件上传端点的OPTIONS请求报405？ #

结合ASP.NET WebAPI和IIS的常见运行逻辑来看，你的全局CORS配置在普通端点正常，但文件上传端点触发了特殊拦截逻辑，主要有这几个核心原因：

• WebDAV模块拦截：IIS默认的WebDAV模块会优先识别和“文件操作”相关的请求，包括OPTIONS请求，它会直接覆盖你的CORS配置返回405——因为WebDAV自身的权限规则不允许跨域OPTIONS请求，而文件上传端点的属性刚好被它判定为“文件操作类请求”。
• 预检请求匹配问题：文件上传请求通常携带multipart/form-data类型的Content-Type，这类请求的预检OPTIONS会触发更严格的路由匹配检查。如果你的上传端点只标记了[HttpPost]而没有显式处理OPTIONS请求，WebAPI路由系统会找不到对应的处理方法，最终让IIS返回默认的405错误。
• 模块优先级冲突：如果runAllManagedModulesForAllRequests未开启，或者IIS的静态文件模块等优先级高于ASP.NET模块，OPTIONS请求会被IIS直接处理，根本没传递到你的WebAPI应用，自然返回错误。

b) 不用EnableCors属性的解决方法 #

以下几种方案都能解决问题，你可以根据自己的部署环境选择：

1. 禁用WebDAV模块（最常用的解决方案）

WebDAV是这类问题的头号元凶，直接在web.config中移除它的模块和处理器即可：

<system.webServer>
  <modules runAllManagedModulesForAllRequests="true">
    <remove name="WebDAVModule" />
  </modules>
  <handlers>
    <remove name="WebDAV" />
  </handlers>
</system.webServer>

如果不想全局禁用，也可以针对上传端点单独配置：

<location path="api/your-file-upload-endpoint">
  <system.webServer>
    <modules>
      <remove name="WebDAVModule" />
    </modules>
    <handlers>
      <remove name="WebDAV" />
    </handlers>
  </system.webServer>
</location>

2. 显式在上传Controller中处理OPTIONS请求

在你的文件上传Controller里添加专门处理OPTIONS请求的方法，确保WebAPI能返回符合要求的预检响应：

[AcceptVerbs("OPTIONS")]
public HttpResponseMessage Options()
{
    var response = Request.CreateResponse(HttpStatusCode.OK);
    response.Headers.Add("Access-Control-Allow-Origin", "*");
    response.Headers.Add("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS");
    response.Headers.Add("Access-Control-Allow-Headers", "*");
    return response;
}

这个方法会直接匹配OPTIONS请求，避免IIS返回默认的405错误。

3. 配置IIS的OPTIONSVerbHandler

如果WebDAV不是问题，你可以让IIS把OPTIONS请求传递给ASP.NET处理，在web.config的handlers节点添加：

<system.webServer>
  <handlers>
    <add name="OPTIONSVerbHandler" path="*" verb="OPTIONS" modules="ProtocolSupportModule" resourceType="Unspecified" requireAccess="None" />
  </handlers>
</system.webServer>

这个配置会确保OPTIONS请求被正确路由到你的WebAPI应用，而不是被IIS直接拦截处理。

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