ASP.NET WebAPI文件上传Post接口返回405错误求助

遇到405方法不允许错误且断点完全没触发，说明你的POST请求连控制器方法都没到达，大概率是路由、服务器配置或者请求处理管道的问题。结合你已经做的操作，给你几个重点排查方向：

1. 彻底确认WebDAV已移除干净 #

你提到已经移除了WebDAV相关模块，但有时候残留的配置还是会拦截POST请求。确保你的Web.config里有这些配置：

<system.webServer>
  <modules>
    <!-- 移除WebDAV模块 -->
    <remove name="WebDAVModule" />
  </modules>
  <handlers>
    <!-- 移除WebDAV处理器 -->
    <remove name="WebDAV" />
    <!-- 确保ExtensionlessUrlHandler能处理所有请求方法 -->
    <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" 
         type="System.Web.Handlers.TransferRequestHandler" 
         preCondition="integratedMode,runtimeVersionv4.0" />
  </handlers>
</system.webServer>

2. 检查IIS请求筛选是否允许POST方法 #

响应头显示只允许GET、HEAD、OPTIONS、TRACE，说明POST被禁用了。在Web.config里添加请求筛选配置，明确允许POST：

<system.webServer>
  <security>
    <requestFiltering>
      <verbs allowUnlisted="false">
        <add verb="GET" allowed="true" />
        <add verb="POST" allowed="true" />
        <add verb="HEAD" allowed="true" />
        <add verb="OPTIONS" allowed="true" />
        <add verb="TRACE" allowed="true" />
      </verbs>
    </requestFiltering>
  </security>
</system.webServer>

3. 验证路由配置是否正确 #

断点没触发，首先要确认请求路径和控制器方法的路由完全匹配：

• 确保WebApiConfig.cs里启用了属性路由，并且默认路由配置正确：

public static void Register(HttpConfiguration config)
{
    // 必须先启用属性路由
    config.MapHttpAttributeRoutes();

    config.Routes.MapHttpRoute(
        name: "DefaultApi",
        routeTemplate: "api/{controller}/{id}",
        defaults: new { id = RouteParameter.Optional }
    );

    // 配置JSON格式化器（你已经做了，但确认下）
    config.Formatters.JsonFormatter.SupportedMediaTypes.Add(new MediaTypeHeaderValue("text/html"));
}

• 控制器和方法上的路由特性要匹配请求URL，比如如果你的请求是POST /api/fileupload，控制器应该这样写：

[RoutePrefix("api/fileupload")]
public class FileUploadController : ApiController
{
    [HttpPost]
    [Route("")] // 空路由对应RoutePrefix的根路径
    public async Task<HttpResponseMessage> Post()
    {
        // 你的文件处理代码
    }
}

4. 检查请求本身的正确性 #

用Postman或者curl先测试，确保请求没有问题：

• 请求方法必须是POST，路径要和路由完全一致（比如http://localhost:xxxx/api/fileupload）
• Content-Type必须是multipart/form-data; boundary=----WebKitFormBoundaryxxxx（这个一般工具会自动生成，不用手动写，但要确保没选错格式）
• 确认上传的文件参数是正确的form-data类型，而不是raw或者其他格式

5. 排除请求大小限制的间接影响 #

虽然405是方法不允许，但如果MP4文件过大，可能会在到达控制器之前就被拦截，导致看起来像方法不允许。在Web.config里添加大小限制配置：

<system.web>
  <!-- 单位是KB，这里设置100MB -->
  <httpRuntime maxRequestLength="102400" />
</system.web>
<system.webServer>
  <security>
    <requestFiltering>
      <!-- 单位是Bytes，这里设置100MB -->
      <requestLimits maxAllowedContentLength="104857600" />
    </requestFiltering>
  </security>
</system.webServer>

6. 排查全局过滤器或消息处理器 #

如果你的项目里有自定义的全局过滤器或者消息处理器，检查它们有没有拦截POST请求，或者修改了请求方法。比如有些授权过滤器可能会在验证失败时返回错误，但如果是405的话，更可能是某个处理器限制了请求方法。

按照这些步骤一步步排查，应该能找到问题所在。之前图片上传没问题，可能是图片接口的路由或配置和现在的MP4接口有细微差别，仔细对比下两个控制器的配置差异也会有帮助。

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