.NET Core 2 Web API：如何基于内容类型路由，同一URL兼容JSON与表单？

好问题！在.NET Core MVC里，确实有和Java JAX-RS @Consumes 功能几乎一致的内置特性——[Consumes] 属性，专门用来解决你遇到的这种同一URL下，因支持不同请求内容类型导致的AmbiguousActionException异常。

核心解决方案：使用[Consumes]特性区分Action #

你只需要给处理不同内容类型的POST Action分别标记[Consumes]，指定它们各自支持的Content-Type即可。ASP.NET Core会根据请求头里的Content-Type值，自动匹配到对应的Action，不会再出现路由歧义。

举个实际的代码例子：

假设你有一个接收用户数据的模型：

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

然后在控制器里定义两个POST Action，分别处理JSON和表单请求：

[ApiController]
[Route("api/users")]
public class UsersController : ControllerBase
{
    // 处理JSON格式的POST请求
    [HttpPost]
    [Consumes("application/json")]
    public IActionResult CreateUserFromJson([FromBody] UserModel model)
    {
        // 业务逻辑处理
        return Ok($"Received JSON user: {model.Name}, {model.Age}");
    }

    // 处理表单格式的POST请求
    [HttpPost]
    [Consumes("application/x-www-form-urlencoded")]
    public IActionResult CreateUserFromForm([FromForm] UserModel model)
    {
        // 业务逻辑处理
        return Ok($"Received form user: {model.Name}, {model.Age}");
    }
}

关键细节说明 #

• 当客户端发送Content-Type: application/json的POST请求时，会自动匹配CreateUserFromJson；发送Content-Type: application/x-www-form-urlencoded的请求时，会匹配CreateUserFromForm。
• 你也可以在[Consumes]里指定多个内容类型，比如[Consumes("application/json", "application/xml")]，表示这个Action支持多种格式。
• 如果需要给整个控制器下的所有Action统一指定默认支持的内容类型，可以在控制器级别添加[Consumes]，个别Action可以通过自己的[Consumes]覆盖全局设置。

其他可选方案（非必要） #

如果内置的[Consumes]不能满足你的特殊需求，还可以通过自定义路由约束或者动作筛选器来实现类似逻辑，但官方推荐优先使用[Consumes]——毕竟这是专门为解决这类场景设计的内置特性，简洁且不易出错。

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