Web API 2中Base Controller依赖注入实现正确性及子控制器构造传参疑问

嘿，我来帮你梳理下在Web API 2里用Unity做依赖注入，基控制器和子控制器的正确写法以及最佳实践！

第一步：先搞定Unity在Web API 2的基础配置 #

首先得让Web API知道要用Unity作为依赖注入容器，这一步是基础：

1. 在项目的App_Start文件夹下创建UnityConfig.cs，代码如下：

using System.Web.Http;
using Unity;
using Unity.WebApi;

public static class UnityConfig
{
    public static void RegisterComponents()
    {
        var container = new UnityContainer();
        
        // 在这里注册你的所有服务接口和实现，比如：
        // container.RegisterType<IMyCommonService, MyCommonService>(new HierarchicalLifetimeManager());
        // container.RegisterType<IUserService, UserService>(new HierarchicalLifetimeManager());
        
        // 替换Web API默认的依赖解析器
        GlobalConfiguration.Configuration.DependencyResolver = new UnityDependencyResolver(container);
    }
}

2. 打开Global.asax，在Application_Start方法里调用这个配置：

protected void Application_Start()
{
    // 其他初始化代码...
    UnityConfig.RegisterComponents();
}

第二步：基控制器的正确写法 #

基控制器要通过构造注入接收通用依赖，不要用属性注入（不够直观，也不利于测试）。比如你的基控制器可以改成这样：

public class BaseController : ApiController
{
    // 把通用依赖声明为protected，让子控制器可以访问
    protected readonly IMyCommonService _commonService;
    public string[] includes = null;

    // 基控制器的构造函数，接收通用依赖
    public BaseController(IMyCommonService commonService)
    {
        _commonService = commonService;
    }

    // 这里可以写通用逻辑，比如权限校验、日志、includes参数解析等
}

第三步：子控制器传递构造参数的正确方式 #

子控制器需要在自己的构造函数中，同时接收基类需要的依赖和自身专属的依赖，然后通过base()把基类需要的参数传递过去。示例代码：

public class UserController : BaseController
{
    // 子控制器自己的专属依赖
    private readonly IUserService _userService;

    // 构造函数：先注入基类需要的IMyCommonService，再注入自己的IUserService
    public UserController(IMyCommonService commonService, IUserService userService) 
        : base(commonService) // 必须把基类需要的参数传递给基构造函数
    {
        _userService = userService;
    }

    // 示例Action，同时使用基类和自身的服务
    public IHttpActionResult GetUser(int id)
    {
        // 用基类的通用服务做一些前置处理
        var isValid = _commonService.ValidateRequest(Request);
        if (!isValid) return BadRequest("Invalid request");

        // 用自身服务处理业务逻辑
        var user = _userService.GetById(id);
        return Ok(user);
    }
}

关键注意事项和最佳实践 #

• 永远用构造注入：避免用[Dependency]属性注入，构造注入更清晰，能让依赖关系一目了然，也方便单元测试时手动注入Mock对象。
• 控制构造函数参数数量：如果控制器构造函数参数超过3-4个，说明你的控制器可能承担了太多职责，建议拆分服务或者用「聚合服务」把相关依赖打包。
• 合理选择生命周期：注册服务时用HierarchicalLifetimeManager，它会为每个HTTP请求创建一个服务实例，请求结束后自动释放，适合Web API场景。
• 基控制器只做通用逻辑：基控制器应该处理跨控制器的通用操作（比如日志、权限、参数解析），不要放业务逻辑，业务逻辑全部交给服务层。
• 单元测试友好：测试时可以用Unity创建子容器，或者直接用Moq等Mock框架手动注入依赖，不需要启动整个Web API环境。

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