Angular5调用Web API遇405错误：自定义区域API控制器不支持POST

我之前也碰到过一模一样的情况！别慌，咱们一步步排查解决：

1. 先检查控制器的HTTP方法特性 #

首先确认你自定义区域里的API控制器，POST方法有没有显式加上[HttpPost]特性。比如：

// 错误示例：没加特性，默认可能只会识别GET请求
public IActionResult SubmitForm([FromBody] FormModel model)
{
    // 业务逻辑
}

// 正确示例：显式标记为POST方法
[HttpPost]
public IActionResult SubmitForm([FromBody] FormModel model)
{
    // 业务逻辑
}

哪怕你的方法命名是PostXXX，ASP.NET的约定路由可能自动识别，但显式加特性能避免很多莫名其妙的问题。

2. 检查区域的路由注册顺序和配置 #

自定义区域的路由很容易因为顺序或者模板问题导致请求匹配失败。在ASP.NET Core的Program.cs/Startup.cs里，要确保区域API路由先于全局API路由注册：

app.UseEndpoints(endpoints =>
{
    // 先注册区域API路由
    endpoints.MapAreaControllerRoute(
        name: "AreaApi",
        areaName: "YourAreaName",
        pattern: "api/{area:exists}/{controller}/{action=Index}/{id?}"
    );

    // 再注册全局API路由
    endpoints.MapControllerRoute(
        name: "defaultApi",
        pattern: "api/{controller}/{action=Index}/{id?}"
    );
});

另外要确认路由模板里的api前缀、区域名和你实际请求的URL完全对应，比如区域叫Dashboard，控制器是DataApi，POST方法是Upload，请求URL应该是https://yourdomain/api/Dashboard/DataApi/Upload。

3. IIS部署场景：禁用WebDAV模块 #

这是个超级常见的坑！如果你的项目部署在IIS（包括本地IIS Express），WebDAV模块会拦截POST请求，直接返回405。解决方法是在web.config里添加配置禁用它：

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

本地调试时，这个配置也能解决IIS Express的拦截问题。

4. 排查路由的HTTP方法约束 #

有时候会不小心在路由配置里加了HTTP方法限制，比如：

endpoints.MapAreaControllerRoute(
    name: "AreaApi",
    areaName: "YourAreaName",
    pattern: "api/{area:exists}/{controller}/{action=Index}/{id?}",
    constraints: new { httpMethod = new HttpMethodConstraint("GET") } // 这里限制了只能用GET！
);

如果有这种配置，要么删掉这个约束，要么把POST也加入允许的方法列表里。

5. 跨域场景：检查CORS配置 #

如果你的请求是跨域的，虽然405是方法不允许，但CORS配置不当也可能触发这个错误。确保你正确配置了CORS并允许POST方法：

builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowCrossDomain", policy =>
    {
        policy.AllowAnyOrigin()
              .AllowAnyMethod() // 或者明确指定"POST", "GET"等需要的方法
              .AllowAnyHeader();
    });
});

// 注意CORS中间件要放在UseRouting之后，UseAuthorization之前
app.UseCors("AllowCrossDomain");

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