ASP.NET Core中基于Accept Header区分端点触发AmbiguousMatchException问题

你遇到的AmbiguousMatchException是因为ASP.NET Core的路由匹配阶段不会检查Accept请求头：两个方法使用了完全相同的HTTP方法（HttpGet）和路由模板（{id:Guid}），路由系统无法区分它们，因此抛出冲突错误。Produces属性仅用于声明端点支持的响应内容类型，不会参与路由匹配逻辑。

解决方法 #

方法1：合并为单个端点方法（推荐） #

在同一个方法内根据Accept头判断返回格式，既避免路由冲突，也更符合内容协商的设计思路：

[HttpGet]
[Route("{id:Guid}")]
[Produces("text/csv", "application/json")]
public async Task<IActionResult> GetData(
    Guid id,
    [FromQuery(Name = "page[Limit]")] ushort pageLimit = 25,
    [FromQuery(Name = "page[Offset]")] ushort pageOffset = 0)
{
    // 1. 获取原始数据集（复用逻辑，无需重复编写）
    var dataset = await FetchYourDataset(id, pageLimit, pageOffset);

    // 2. 根据Accept头判断返回格式
    var acceptHeader = Request.Headers.Accept.ToString();
    if (acceptHeader.Contains("text/csv", StringComparison.OrdinalIgnoreCase))
    {
        // 生成CSV内容（可使用CsvHelper等库简化实现）
        var csvContent = ConvertDatasetToCsv(dataset);
        return Content(csvContent, "text/csv");
    }
    else
    {
        // 默认返回JSON格式
        return Ok(dataset);
    }
}

方法2：修改路由模板区分端点 #

如果坚持要分开两个方法，可以给其中一个方法添加独特的路由片段，比如给CSV端点加后缀：

// CSV端点
[HttpGet]
[Produces("text/csv")]
[Route("{id:Guid}/csv")]
public async Task<IActionResult> GetFile(Guid id)
{
    // CSV处理逻辑
}

// JSON端点
[HttpGet]
[Produces("application/json")]
[Route("{id:Guid}")]
public async Task<IActionResult> GetJson(
    [FromRoute] Guid id,
    [FromQuery(Name = "page[Limit]")] ushort pageLimit = 25,
    [FromQuery(Name = "page[Offset]")] ushort pageOffset = 0)
{
    // JSON处理逻辑
}

这种方式需要前端根据格式需求调用不同的路由，不如方法1灵活。

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