ASP.NET核心3.1 Web API post方法导致405“不允许的方法”错误

基础概念

HTTP 405错误表示“方法不被允许”，这意味着客户端尝试使用的HTTP方法（例如POST、GET、PUT、DELETE等）不被服务器端允许。在ASP.NET Core Web API中，这通常是由于路由配置或控制器方法的限制导致的。

类型

路由配置问题：可能是由于路由配置不正确，导致某些HTTP方法无法匹配到相应的控制器方法。
控制器方法限制：控制器方法可能明确禁止了某些HTTP方法。

应用场景

RESTful API：在构建RESTful API时，通常会对不同的HTTP方法进行限制，以确保API的正确性和安全性。
权限控制：通过限制HTTP方法，可以实现更细粒度的权限控制。

常见原因及解决方法

1. 路由配置问题

原因：路由配置可能没有正确匹配到POST方法。

解决方法：确保在Startup.cs或相应的路由配置文件中正确配置了路由。

app.UseRouting();

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
});

并且在控制器中使用了正确的路由属性：

[ApiController]
[Route("api/[controller]")]
public class MyController : ControllerBase
{
    [HttpPost]
    public IActionResult PostMethod()
    {
        // 处理POST请求的逻辑
        return Ok();
    }
}

2. 控制器方法限制

原因：控制器方法可能明确禁止了POST方法。

解决方法：检查控制器方法上的属性，确保没有使用[HttpDelete]、[HttpGet]等不匹配的属性。

[HttpPost]
public IActionResult PostMethod()
{
    // 处理POST请求的逻辑
    return Ok();
}

3. Web服务器配置问题

原因：可能是由于Web服务器（如IIS）配置不正确，导致某些HTTP方法被禁用。

解决方法：确保IIS配置允许POST请求。可以在web.config文件中添加以下配置：

<configuration>
  <system.webServer>
    <handlers>
      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified"/>
    </handlers>
  </system.webServer>
</configuration>

4. 中间件问题

原因：可能是由于中间件拦截了POST请求并返回了405错误。

解决方法：检查中间件逻辑，确保没有错误地拦截POST请求。

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }

    app.UseRouting();

    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

示例代码

以下是一个完整的ASP.NET Core Web API控制器示例，展示了如何正确配置POST方法：

[ApiController]
[Route("api/[controller]")]
public class MyController : ControllerBase
{
    [HttpPost]
    public IActionResult PostMethod([FromBody] MyModel model)
    {
        if (ModelState.IsValid)
        {
            // 处理POST请求的逻辑
            return Ok(new { message = "Data received successfully." });
        }
        else
        {
            return BadRequest(ModelState);
        }
    }
}

public class MyModel
{
    public string Name { get; set; }
    public int Age { get; set; }
}