在C#中能否按对象类型重载API端点？尝试遇歧义匹配错误

首先明确：ASP.NET Core无法直接通过请求体中的对象类型来重载API端点，你遇到的AmbiguousMatchException正是因为路由系统无法区分两个具有相同HTTP方法和路由路径的端点。

错误原因 #

ASP.NET Core的路由匹配逻辑在模型绑定之前执行，它只关注HTTP方法、路由路径、查询参数等表层信息，不会解析请求体内容来判断匹配哪个端点。你的两个CreateDocument端点都使用了[HttpPost("CreateDocument")]属性，路由规则完全一致，因此路由系统无法确定要调用哪个方法，导致歧义错误。

可行解决方案 #

方案1：为不同类型分配唯一路由路径 #

最简单的解决方式是给每个类型的端点设置不同的路由路径，让路由系统能明确区分：

[HttpPost("CreateDocument/Contract1")]
public async Task<object> CreateContract1Document(CustomerDocument<Contract1> document)
{
    return await CreateDocument<Contract1>(document);
}

[HttpPost("CreateDocument/Contract2")]
public async Task<object> CreateContract2Document(CustomerDocument<Contract2> document)
{
    return await CreateDocument<Contract2>(document);
}

private async Task<object> CreateDocument<T>(CustomerDocument<T> document) 
{
    // 业务逻辑实现
}

方案2：单一端点+类型判别器 #

如果希望保持统一的路由路径，可以在请求中加入类型判别信息（比如请求体字段或查询参数），然后在单一端点中根据类型分发到对应泛型方法：

首先修正你的CustomerDocument类（原代码缺少泛型声明）：

public class CustomerDocument<T>
{
    public string Id { get; set; }
    public string AccountId { get; set; }
    public string DocumentType { get; set; } // 新增类型判别字段
    public T DocData { get; set; }

    public CustomerDocument(T initialValue)
    {
        DocData = initialValue;
    }
}

然后实现单一端点：

[HttpPost("CreateDocument")]
public async Task<IActionResult> CreateDocument([FromBody] JObject requestBody)
{
    var documentType = requestBody["DocumentType"]?.ToString();
    if (string.IsNullOrEmpty(documentType))
    {
        return BadRequest("缺少DocumentType参数");
    }

    switch (documentType)
    {
        case nameof(Contract1):
            var contract1Doc = requestBody.ToObject<CustomerDocument<Contract1>>();
            return Ok(await CreateDocument<Contract1>(contract1Doc));
        case nameof(Contract2):
            var contract2Doc = requestBody.ToObject<CustomerDocument<Contract2>>();
            return Ok(await CreateDocument<Contract2>(contract2Doc));
        default:
            return BadRequest($"不支持的文档类型：{documentType}");
    }
}

private async Task<object> CreateDocument<T>(CustomerDocument<T> document) 
{
    // 业务逻辑实现
}

方案3：自定义模型绑定器（进阶） #

如果需要更优雅的实现，可以编写自定义模型绑定器，让系统根据请求体内容自动解析到对应的泛型类型。不过这种方式复杂度较高，适合有框架定制经验的场景。

额外注意点 #

你提供的CustomerDocument类存在语法错误，必须添加泛型类型声明才能正确使用：

// 错误写法
public class CustomerDocument

// 正确写法
public class CustomerDocument<T>

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