.NET 4.7 Web API引用NetStandard 2.0包后返回结果异常求助

这个问题我之前排查过，核心是System.Net.Http程序集的版本绑定冲突导致的，我来给你详细说清楚原因和解决办法：

问题原因 #

当你引入NetStandard 2.0兼容的NuGet包（比如System.Threading.Tasks.Extensions）时，NuGet会自动引入一套适配.NET Framework的System.Net.Http版本（也就是你看到的v4.2.0.0，来自MSBuild扩展包）。

• 原本.NET Framework 4.7原生的System.Net.Http.HttpResponseMessage（v4.0.0.0），Web API的内置格式化器会识别它是"响应消息容器"，直接提取Content里的内容返回。
• 但新版本的HttpResponseMessage，Web API无法再将它识别为特殊的响应类型，反而把它当作普通CLR对象进行序列化，所以就返回了整个对象的属性结构（包含Version、Content、StatusCode这些字段的JSON）。

解决办法 #

1. 强制绑定重定向到原生版本 #

在项目的web.config中添加程序集绑定重定向，强制使用.NET Framework 4.7原生的System.Net.Http v4.0.0.0版本：

<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.0.0.0" />
    </dependentAssembly>
  </assemblyBinding>
</runtime>

2. 改用IHttpActionResult返回（推荐方案） #

.NET Web API官方更推荐使用IHttpActionResult来构建响应，它不仅写法更简洁，还能从根源上避免这类版本冲突问题。修改你的Action代码：

[System.Web.Http.Route("api/GetData")]
[System.Web.Http.HttpGet]
public async Task<IHttpActionResult> GetData()
{
    string result = await Task.FromResult("test data");
    return Ok(result);
}

这样不管System.Net.Http的版本如何，Web API都会正确处理响应，返回你预期的"test data"字符串。

3. 清理不必要的NuGet引用 #

如果System.Threading.Tasks.Extensions不是项目必须的依赖，可以直接移除这个包，这样System.Net.Http会自动恢复到原生的v4.0.0.0版本，问题也会随之解决。如果确实需要这个包，结合上面的绑定重定向即可。

验证步骤 #

修改完成后，重新编译项目，检查引用的System.Net.Http是否回到了.NET Framework 4.7的原生路径：C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.7\System.Net.Http.dll，然后测试API接口，应该就能正常返回预期的字符串了。

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