能否用组合而非继承设计C# Web API通用控制器结构？

完全可以用组合而非继承的方式来设计C# Web API的基础控制器结构，这种方案不仅可行，还能解决继承模式带来的诸多痛点，是一种更灵活、更符合设计原则的实现方式。

核心优势 #

• 贴合单一职责原则：每个基础控制器（如ReadController、InsertController）只负责对应操作的逻辑，职责清晰，避免了继承模式下控制器类臃肿、职责混杂的问题。
• 操作组合更灵活：不同业务模型的操作权限往往不同（比如部分模型只允许查询和删除，不支持插入），用组合可以按需选择要集成的操作组件，不用像继承那样被迫继承不需要的方法，也无需编写空实现来“凑数”。
• 降低代码耦合：各操作控制器之间独立性强，修改某一类操作的逻辑时，不会影响其他操作的控制器实现，后续维护和扩展成本更低。

实现时的注意事项 #

路由配置 #

ASP.NET Core默认不会自动识别嵌套控制器的路由规则，因此需要在主控制器中做请求转发，确保路由能正确映射到对应的操作：

[ApiController]
[Route("api/[controller]")]
public class PersonController
{
    private readonly ReadController<PersonFilterRequest, PersonReadResponse, Person, PersonService> _readController;
    private readonly InsertController<PersonInsertRequest, PersonInsertResponse, Person, PersonService> _insertController;
    private readonly UpdateController<PersonUpdateRequest, PersonUpdateResponse, Person, PersonService> _updateController;
    private readonly DeleteController<PersonDeleteRequest, PersonDeleteResponse, Person, PersonService> _deleteController;

    // 通过依赖注入注入各操作控制器
    public PersonController(
        ReadController<PersonFilterRequest, PersonReadResponse, Person, PersonService> readController,
        InsertController<PersonInsertRequest, PersonInsertResponse, Person, PersonService> insertController,
        UpdateController<PersonUpdateRequest, PersonUpdateResponse, Person, PersonService> updateController,
        DeleteController<PersonDeleteRequest, PersonDeleteResponse, Person, PersonService> deleteController)
    {
        _readController = readController;
        _insertController = insertController;
        _updateController = updateController;
        _deleteController = deleteController;
    }

    // 转发GET请求到ReadController
    [HttpGet]
    public IActionResult GetPersons([FromQuery] PersonFilterRequest request)
    {
        return _readController.Get(request);
    }

    // 转发POST请求到InsertController
    [HttpPost]
    public IActionResult InsertPerson([FromBody] PersonInsertRequest request)
    {
        return _insertController.Insert(request);
    }

    // 同理实现Update和Delete的转发
}

依赖注入配置 #

需要确保所有基础控制器（ReadController、InsertController等）能被DI容器正确解析，可在Program.cs中注册这些泛型类型：

builder.Services.AddScoped(typeof(ReadController<,,,>));
builder.Services.AddScoped(typeof(InsertController<,,,>));
builder.Services.AddScoped(typeof(UpdateController<,,,>));
builder.Services.AddScoped(typeof(DeleteController<,,,>));

公共逻辑复用 #

如果多个操作控制器有共同的逻辑（比如权限校验、日志记录），建议将这些逻辑抽成中间件或Action过滤器，而非在每个基础控制器中重复编写，保持组件的简洁性和复用性。

总结 #

这种组合式控制器设计非常适合你的场景，尤其在业务模型操作差异较大的系统中，能显著提升代码的可维护性和扩展性，也是CQRS、DDD等架构风格中常用的实践方式。

内容的提问来源于stack exchange，提问作者Goran Petrović