.NET Framework 4.6.2 WebAPI仅能成功调用一次问题排查

1. 检查全局格式化器的状态变更 #

Web API的媒体类型格式化器集合（config.Formatters）是全局状态，如果请求处理流程中存在动态修改（比如移除/替换Json格式化器），会导致后续请求找不到对应格式化器，从而 fallback 到application/octet-stream。

解决步骤： #

• 确保WebApiConfig.Register中仅在初始化阶段配置格式化器，不要在请求处理逻辑中修改：

  public static void Register(HttpConfiguration config)
  {
      // 初始化时一次性配置，后续不要动态修改
      config.Formatters.Clear();
      var jsonFormatter = new JsonMediaTypeFormatter();
      // 按需配置json序列化规则，比如忽略循环引用
      jsonFormatter.SerializerSettings.ReferenceLoopHandling = ReferenceLoopHandling.Ignore;
      config.Formatters.Add(jsonFormatter);
      
      // 路由等其他配置...
      config.MapHttpAttributeRoutes();
  }
  

• 排查自定义消息处理程序（DelegatingHandler）或全局过滤器，确认没有在处理请求时操作config.Formatters集合。

2. 验证Azure Web App的运行时配置 #

Azure Web App的应用池状态或预热配置可能间接导致全局状态异常：

• 在Azure门户开启始终开启（Always On），避免应用池闲置回收后全局状态未正确重建。
• 检查**应用初始化（Application Initialization）**配置，确保预热请求不会触发修改全局配置的逻辑。

3. 检查API方法与请求的参数绑定 #

即使设置了Content-Type: application/json，参数定义或请求体的问题也可能导致格式化器状态异常：

• 优先使用强类型参数而非dynamic或JObject，确保模型绑定逻辑稳定：

  [HttpPost]
  [Route("api/MyEndpoint")]
  public IHttpActionResult ProcessRequest([FromBody] RequestModel model)
  {
      // 业务逻辑
      return Ok(new ResponseModel { Success = true });
  }
  

• 验证请求体的json格式合法性，避免语法错误（比如 trailing comma），这类错误可能导致格式化器内部状态损坏。

4. 确保自定义格式化器线程安全 #

如果使用了自定义JsonMediaTypeFormatter或其他格式化器，必须保证其实现线程安全：

• 不要在ReadFromStreamAsync/WriteToStreamAsync方法中修改格式化器的实例属性，所有配置应在初始化阶段完成。

5. 开启详细日志定位根源 #

在Web.config中添加详细日志配置，捕获二次调用时的具体异常堆栈：

<system.web>
  <customErrors mode="Off" />
</system.web>
<system.webServer>
  <httpErrors errorMode="Detailed" />
</system.webServer>
<system.diagnostics>
  <sources>
    <source name="System.Web.Http" switchName="WebApiTrace" switchType="System.Diagnostics.SourceSwitch">
      <listeners>
        <add name="fileListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="WebApiErrors.log" />
      </listeners>
    </source>
  </sources>
  <switches>
    <add name="WebApiTrace" value="Verbose" />
  </switches>
</system.diagnostics>

部署后查看WebApiErrors.log，根据错误堆栈精准定位问题点。

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