.NET Standard单元测试依赖注入出现‘类型错误’问题排查

这个问题我之前也碰到过，本质是.NET Framework 4.7.1和.NET Standard 2.0在处理跨框架类型（比如HttpClient）时的类型识别差异，加上Moq代理类型的兼容性问题导致的。下面是几个针对性的解决办法：

1. 统一System.Net.Http的版本引用 #

.NET Framework 4.7.1自带的System.Net.Http组件和.NET Standard 2.0依赖的版本可能存在细微的标识差异，这会导致运行时无法识别构造函数参数类型。

• 给你的.NET Standard DLL和.NET 4.7.1测试项目都通过NuGet安装相同版本的System.Net.Http（比如4.3.4或更高版本）
• 在测试项目的app.config中添加绑定重定向，强制使用统一版本：

  <configuration>
    <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
        <dependentAssembly>
          <assemblyIdentity name="System.Net.Http" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
          <bindingRedirect oldVersion="0.0.0.0-4.2.0.0" newVersion="4.2.0.0" />
        </dependentAssembly>
      </assemblyBinding>
    </runtime>
  </configuration>
  

  注意调整newVersion为你实际安装的版本号。

2. 封装HttpClient为抽象接口（推荐方案） #

直接依赖HttpClient会带来跨框架类型兼容性问题，最好的做法是定义一个抽象接口封装HttpClient的操作，这样Moq代理接口就不会有类型识别问题：

• 在你的.NET Standard DLL中添加接口和实现：

  public interface IHttpService
  {
      Task<HttpResponseMessage> GetAsync(string requestUri);
      // 根据业务需求添加其他HttpClient方法
  }
  
  public class HttpService : IHttpService
  {
      private readonly HttpClient _httpClient;
  
      public HttpService(HttpClient httpClient)
      {
          _httpClient = httpClient;
      }
  
      public async Task<HttpResponseMessage> GetAsync(string requestUri)
      {
          return await _httpClient.GetAsync(requestUri);
      }
  }
  

• 然后让你的业务类依赖IHttpService而不是直接依赖HttpClient，测试时MoqIHttpService即可：

  var mockHttpService = new Mock<IHttpService>();
  mockHttpService.Setup(s => s.GetAsync(It.IsAny<string>()))
                 .ReturnsAsync(new HttpResponseMessage(HttpStatusCode.OK));
  
  var yourService = new YourBusinessService(mockHttpService.Object);
  

3. 换一种方式伪造HttpClient（不依赖Moq直接代理HttpClient） #

如果你不想修改业务代码，可以通过伪造HttpMessageHandler来创建假的HttpClient，这种方式绕过了直接代理HttpClient的类型问题：

// 创建HttpMessageHandler的Mock
var mockHandler = new Mock<HttpMessageHandler>();
mockHandler.Protected()
           .Setup<Task<HttpResponseMessage>>("SendAsync", 
               ItExpr.IsAny<HttpRequestMessage>(), 
               ItExpr.IsAny<CancellationToken>())
           .ReturnsAsync(new HttpResponseMessage(HttpStatusCode.OK));

// 使用伪造的Handler创建HttpClient
var fakeHttpClient = new HttpClient(mockHandler.Object);

// 注入到你的业务类中
var yourService = new YourBusinessService(fakeHttpClient);

4. 检查Moq版本与配置 #

确保你使用的Moq版本支持.NET Framework 4.7.1和.NET Standard 2.0，推荐使用Moq 4.16.0及以上版本。旧版本的Moq在生成跨框架类型的代理时可能存在兼容性问题。

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