.NET 8中如何实现Web API动作选择器匹配同路由方法？

问题根源 #

你当前的代码中，两个标注[HttpPost("api/redox")]的Action会直接触发AmbiguousMatchException——ASP.NET Core的路由匹配逻辑和旧版MVC不同，无法自动区分同路由、同请求方法的Action，之前可行的IActionDescriptorProvider方案在Core中已不再适用，需要改用Core原生支持的自定义匹配逻辑。

方案一：自定义Action约束（推荐轻量场景） #

通过给Action添加自定义约束，根据请求Body的特征决定匹配哪个Action。

1. 实现自定义Action约束属性 #

public class VerifyActionConstraint : IActionConstraint
{
    // 约束执行优先级，设为0确保优先判断
    public int Order => 0;

    public bool Accept(ActionConstraintContext context)
    {
        // 启用请求Body缓冲，避免后续Model绑定无法读取
        context.HttpContext.Request.EnableBuffering();
        var bodyContent = new StreamReader(context.HttpContext.Request.Body).ReadToEnd();
        context.HttpContext.Request.Body.Position = 0;

        // 根据VerifyDestinationModel的特征判断，示例：检查是否包含目标字段
        using var jsonDoc = JsonDocument.Parse(bodyContent);
        return jsonDoc.RootElement.TryGetProperty("DestinationId", out _);
    }
}

2. 给Action绑定约束 #

修改RedoxController，为两个Action添加约束逻辑：

[ApiController]
public class RedoxController : ControllerBase
{
    [Route("api/redox")]
    [HttpPost]
    [VerifyActionConstraint] // 符合约束的请求会匹配此Action
    public IActionResult Verify([FromBody] VerifyDestinationModel verification)
    {
        // 处理Verify业务逻辑
        return Ok("触发Verify动作");
    }

    [Route("api/redox")]
    [HttpPost]
    // 未满足Verify约束的请求自动匹配此Action
    public IActionResult DynamicRequest([FromBody] dynamic dynamicModel)
    {
        // 处理DynamicRequest业务逻辑
        return Ok("触发DynamicRequest动作");
    }
}

方案二：自定义IActionSelector（复杂场景） #

如果需要更灵活的选择逻辑，可以替换ASP.NET Core默认的Action选择器。

1. 实现自定义ActionSelector #

public class CustomRedoxActionSelector : IActionSelector
{
    private readonly IActionSelector _innerSelector;
    private readonly ILogger<CustomRedoxActionSelector> _logger;

    public CustomRedoxActionSelector(IActionSelector innerSelector, ILogger<CustomRedoxActionSelector> logger)
    {
        _innerSelector = innerSelector;
        _logger = logger;
    }

    public IReadOnlyList<ActionDescriptor> SelectCandidates(RouteContext context)
    {
        return _innerSelector.SelectCandidates(context);
    }

    public ActionDescriptor SelectBestCandidate(RouteContext context, IReadOnlyList<ActionDescriptor> candidates)
    {
        // 筛选出目标路由的候选Action
        var redoxCandidates = candidates.Where(a => a.AttributeRouteInfo?.Template == "api/redox").ToList();
        if (redoxCandidates.Count != 2)
        {
            // 非目标路由，使用默认选择逻辑
            return _innerSelector.SelectBestCandidate(context, candidates);
        }

        // 读取请求Body判断匹配逻辑
        context.HttpContext.Request.EnableBuffering();
        var bodyContent = new StreamReader(context.HttpContext.Request.Body).ReadToEnd();
        context.HttpContext.Request.Body.Position = 0;

        var verifyAction = redoxCandidates.First(a => a.RouteValues["action"] == nameof(RedoxController.Verify));
        var dynamicAction = redoxCandidates.First(a => a.RouteValues["action"] == nameof(RedoxController.DynamicRequest));

        try
        {
            // 尝试反序列化为VerifyDestinationModel，成功则选Verify
            JsonSerializer.Deserialize<VerifyDestinationModel>(bodyContent, new JsonSerializerOptions());
            return verifyAction;
        }
        catch (JsonException)
        {
            // 反序列化失败，选DynamicRequest
            return dynamicAction;
        }
    }
}

2. 注册自定义选择器 #

在Program.cs中替换默认服务：

builder.Services.AddSingleton<IActionSelector, CustomRedoxActionSelector>(sp =>
{
    var innerSelector = sp.GetRequiredService<IActionSelector>();
    var logger = sp.GetRequiredService<ILogger<CustomRedoxActionSelector>>();
    return new CustomRedoxActionSelector(innerSelector, logger);
});

注意事项 #

• 处理请求Body时必须调用EnableBuffering()，并重置流位置，否则后续Model绑定会因流已读取完毕而失败。
• 若请求Body体积过大，建议使用基于Span的JSON解析方式，避免一次性读取整个Body影响性能。

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