在.NET 5 Web API中能否定义带动态参数签名的抽象Handle方法？

C# 方法重写要求签名完全匹配，方法名、参数数量、参数类型、参数顺序必须和父类抽象方法完全一致，你新增参数后和父类定义的Handle(CancellationToken cancellationToken)签名不一致，因此触发编译错误。同时C#作为静态类型语言，不支持定义可随意追加任意参数的抽象方法，抽象方法的签名在声明时就必须固定。

采用泛型分层的基类设计，分别适配无参数、带自定义参数的场景，既保留统一的约束，又支持灵活的参数定义：

1. 重构基类 #

[ApiController]
public abstract class CommandController : ControllerBase
{
    [NonAction]
    protected CausationIdResult CausationId(Guid causationId) => new(causationId);
}

/// <summary>
/// 无额外参数的控制器基类
/// </summary>
public abstract class CommandControllerBase : CommandController
{
    public abstract Task<CausationIdResult> Handle(CancellationToken cancellationToken);
}

/// <summary>
/// 带自定义请求参数的控制器基类
/// </summary>
/// <typeparam name="TRequest">请求参数类型</typeparam>
public abstract class CommandControllerBase<TRequest> : CommandController
{
    public abstract Task<CausationIdResult> Handle(TRequest request, CancellationToken cancellationToken);
}

public sealed class CausationIdResult : OkObjectResult
{
    public CausationIdResult(Guid causationId) : base(causationId) { }
}

2. 无额外参数的实现（和原有逻辑兼容） #

public sealed class DoSomethingController : CommandControllerBase
{
    [HttpPost("do-something")]
    public override Task<CausationIdResult> Handle(CancellationToken cancellationToken)
    {
        // 执行业务逻辑
        return Task.FromResult(CausationId(Guid.NewGuid()));
    }
}

3. 带额外参数的实现 #

如果需要从路由、查询字符串、请求体等多个位置获取参数，只需要定义对应的请求参数类，配合ASP.NET Core自带的模型绑定特性即可：

3.1 定义请求参数类 #

public class DoSomethingRequest
{
    // 从路由取值
    [FromRoute]
    public string Id { get; set; }
    // 从查询字符串取值
    [FromQuery]
    public bool IsDebug { get; set; }
    // 从请求体取值
    [FromBody]
    public DoSomethingDto Body { get; set; }
}

3.2 控制器实现 #

public sealed class DoSomethingController : CommandControllerBase<DoSomethingRequest>
{
    [HttpPost("do-something/{id}")]
    public override Task<CausationIdResult> Handle(DoSomethingRequest request, CancellationToken cancellationToken)
    {
        // 直接通过request对象获取所有参数
        var routeId = request.Id;
        var debugFlag = request.IsDebug;
        var bodyData = request.Body;
        
        // 执行业务逻辑
        return Task.FromResult(CausationId(Guid.NewGuid()));
    }
}

如果只需要单个简单参数，也可以直接指定泛型类型为对应参数类型，无需额外定义请求类：

public sealed class DoSomethingController : CommandControllerBase<string>
{
    [HttpPost("do-something/{id}")]
    public override Task<CausationIdResult> Handle([FromRoute] string id, CancellationToken cancellationToken)
    {
        // 直接使用id参数
        return Task.FromResult(CausationId(Guid.NewGuid()));
    }
}

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