.NET Framework WebApi使用Unity IoC容器时遭遇依赖解析失败错误

嘿，我经常帮开发者解决Unity和ASP.NET WebApi整合时的依赖解析问题，你遇到的Unity.Exceptions.ResolutionFailedException十有八九是因为WebApi的核心服务管道没被Unity正确接管，或者注册环节漏了关键步骤。我给你一步步拆解排查和修复方案：

第一步：确保Unity容器注册了所有必要的类型 #

很多时候解析失败是因为核心WebApi服务或业务依赖没被注册，这是最常见的坑：

• 先检查你的业务接口和实现是否正确注册，比如：

  container.RegisterType<IMyBusinessService, MyBusinessService>(new HierarchicalLifetimeManager());
  

• 关键！必须注册WebApi的控制器激活器，否则WebApi会用默认的激活方式，不会走Unity：

  // 如果用的是原生Unity，手动注册控制器激活器
  container.RegisterType<IHttpControllerActivator, UnityHttpControllerActivator>();
  // 如果你安装了Unity.AspNet.WebApi包，可以直接自动注册所有控制器
  container.RegisterApiControllers(Assembly.GetExecutingAssembly());
  

第二步：检查自定义UnityResolver的实现是否正确 #

如果是自己写的UnityResolver，一定要注意WebApi的规则：找不到服务时必须返回null，不能抛出异常。下面是标准的正确实现：

public class UnityResolver : IDependencyResolver
{
    private readonly IUnityContainer _container;

    public UnityResolver(IUnityContainer container)
    {
        _container = container ?? throw new ArgumentNullException(nameof(container));
    }

    public object GetService(Type serviceType)
    {
        try
        {
            return _container.Resolve(serviceType);
        }
        catch (ResolutionFailedException)
        {
            return null; // WebApi要求找不到服务时返回null，而非抛出异常
        }
    }

    public IEnumerable<object> GetServices(Type serviceType)
    {
        try
        {
            return _container.ResolveAll(serviceType);
        }
        catch (ResolutionFailedException)
        {
            return Enumerable.Empty<object>();
        }
    }

    public IDependencyScope BeginScope()
    {
        var childContainer = _container.CreateChildContainer();
        return new UnityResolver(childContainer);
    }

    public void Dispose()
    {
        _container.Dispose();
    }
}

重点提醒：GetService里的异常捕获非常关键，Unity默认会在找不到服务时抛出异常，但WebApi期望此时返回null，这是很多人忽略的细节。

第三步：在Application_Start中正确配置WebApi的依赖解析器 #

确保在WebApi初始化完成前，把UnityResolver设置为WebApi的默认解析器，顺序很重要：

protected void Application_Start()
{
    // 先执行WebApi的基础配置
    GlobalConfiguration.Configure(WebApiConfig.Register);
    
    // 初始化Unity容器并注册组件
    var container = new UnityContainer();
    UnityConfig.RegisterComponents(container);

    // 替换WebApi的默认DependencyResolver
    GlobalConfiguration.Configuration.DependencyResolver = new UnityResolver(container);

    // 其他配置（路由、过滤器等）
    AreaRegistration.RegisterAllAreas();
    FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
    RouteConfig.RegisterRoutes(RouteTable.Routes);
    BundleConfig.RegisterBundles(BundleTable.Bundles);
}

第四步：使用适配WebApi的Unity NuGet包 #

与其自己写Resolver，更推荐安装专门适配WebApi的包Unity.AspNet.WebApi，它已经封装好了所有必要的整合逻辑：

1. 在NuGet包管理器中搜索并安装Unity.AspNet.WebApi
2. 配置时可以直接使用自带的UnityDependencyResolver，省去自定义Resolver的麻烦：

   GlobalConfiguration.Configuration.DependencyResolver = new UnityDependencyResolver(container);
   

最后几个排查小技巧 #

• 一定要看异常的InnerException！它会明确告诉你哪个类型无法解析，这是快速定位问题的关键
• 检查控制器的构造函数：如果控制器有多个构造函数，Unity会尝试用参数最多的那个，确保所有构造函数依赖都已注册
• 避免在容器中注册抽象类或接口的实例（除非是单例），确保每个抽象类型都有对应的具体实现注册

按照这些步骤检查一遍，应该就能解决你的依赖解析失败问题了。如果还是卡壳，把异常的完整堆栈信息（尤其是InnerException）贴出来，能更精准地帮你定位。

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