.NET 4.7.1 API同配置服务器返回不同MIME类型问题排查

问题描述 #

我有一个.NET 4.7.1后端服务，调用某API接口时预期获取text/html响应。两台服务器运行相同版本的WinServer与IIS，且部署了相同代码，但其中一台返回预期的text/html，另一台却返回XML。该接口定义如下：

<Route("news/GetVarsDue/{lastMonthAct}/{acctType}")>
<HttpGet>
Public Function GetVarsDue(lastMonthAct As String, acctType As string) As HttpResponseMessage
    Dim response = New HttpResponseMessage(HttpStatusCode.OK)
    response.Content = New StringContent("<label>helloBrad</label>", Encoding.UTF8, "text/html")
    Return response
End Function

在Chrome或Edge中访问该API时，正常服务器返回正确的text/html响应，异常服务器返回XML。两台服务器的相关MIME类型配置一致，认证方式相同且同属一个AD域，还出现了一处未知含义的错误提示。

可能的原因及排查方向 #

• Web API内容协商机制干扰：ASP.NET Web API默认会依据请求头的Accept字段执行内容协商，即便代码中显式设置了Content-Type，若异常服务器的Web API配置强制提升XML格式化器优先级，或请求的Accept字段被浏览器插件、代理篡改（添加了优先级更高的application/xml），都可能导致响应被重新格式化。可在异常服务器抓包查看请求头Accept内容，或在接口配置中禁用内容协商：

  config.Formatters.Clear()
  config.Formatters.Add(New System.Net.Http.Formatting.StringMediaTypeFormatter())
  

• IIS模块篡改响应：异常服务器可能存在额外IIS模块（如URL Rewrite、安全类模块），在响应返回前修改了Content-Type。可临时禁用非必要IIS模块，逐一排查是否有模块干预响应头。
• .NET框架补丁版本不一致：虽同为.NET 4.7.1，但两台服务器的.NET补丁可能存在差异，部分补丁会影响HttpResponseMessage的Content-Type处理逻辑。对比两台服务器的.NET框架更新记录，确保补丁版本统一。
• 应用程序池配置差异：检查两台服务器的应用程序池设置，如32位模式是否启用、托管管道模式（集成/经典）是否一致，这类配置差异可能引发响应处理逻辑偏差。
• 未知错误提示的关联问题：那处未知错误提示是关键线索，可能对应组件加载失败、权限问题等导致响应处理流程异常。查看异常服务器的Windows事件日志、IIS日志，定位错误提示对应的具体事件，排查根源。

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