Azure Functions v4 .NET孤立模式HTTP触发对象反序列化失败

我有如下POST触发的Azure Functions函数：

[Function("save")]
public async Task<HttpResponseData?> SaveAppAsync([HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "v1/save")] HttpRequestData req) { ... }

尝试通过以下方法将请求体反序列化为目标模型，但一直失败，推测是接收到的JSON格式异常：

protected async Task<T?> InstantiateAsync<T>(HttpRequestData requestData)
{
    try
    {
        var body = await new StreamReader(requestData.Body).ReadToEndAsync();
        return Newtonsoft.Json.JsonConvert.DeserializeObject<T>(body);
    }
    catch (Exception ex)
    {
        _logger?.LogError(ex, ex.Message);
    }
    return default;
}

获取到的body字符串示例如下：

"{\n    \"id\": \"-1\",\n    \"name\": \"MyWebApp\",\n    \"comments\": \"My web app comments\",\n    \"tenantId\": \"1224\",\n    \"components\": [\n        {\n            \"id\": \"-1\",\n            \"name\": \"Component1\",\n            \"comments\": \"Some comments for this component\"\n        }\n    ]\n}"

已配置如下中间件，但不确定是否缺少Azure Functions相关配置：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults(app =>
    {
        app.UseNewtonsoft();
    })

直接替换转义字符为空字符串无效，想了解是否需要对字符串做特殊处理，或是配置上存在遗漏。

核心问题 #

你获取到的body是被额外包裹了一层双引号的JSON字符串（示例首尾可见"），Newtonsoft.Json会将其识别为单个字符串值，而非可反序列化的JSON对象，这才是反序列化失败的根本原因。

处理方案 #

1. 修复字符串格式后反序列化 #

可以通过两种方式处理外层的包裹：

• 方式一：手动清理字符串

  protected async Task<T?> InstantiateAsync<T>(HttpRequestData requestData)
  {
      try
      {
          var body = await new StreamReader(requestData.Body).ReadToEndAsync();
          // 去除首尾双引号，还原转义的引号和换行符
          var cleanedBody = body.Trim('"').Replace("\\\"", "\"").Replace("\\n", "\n");
          return Newtonsoft.Json.JsonConvert.DeserializeObject<T>(cleanedBody);
      }
      catch (Exception ex)
      {
          _logger?.LogError(ex, ex.Message);
      }
      return default;
  }
  

• 方式二：利用Newtonsoft.Json解析外层字符串
  更稳妥的方式是先把包裹的字符串反序列化为真实的JSON内容：

  protected async Task<T?> InstantiateAsync<T>(HttpRequestData requestData)
  {
      try
      {
          var body = await new StreamReader(requestData.Body).ReadToEndAsync();
          // 先解析外层字符串，得到真实的JSON内容
          var actualJson = Newtonsoft.Json.JsonConvert.DeserializeObject<string>(body);
          return Newtonsoft.Json.JsonConvert.DeserializeObject<T>(actualJson);
      }
      catch (Exception ex)
      {
          _logger?.LogError(ex, ex.Message);
      }
      return default;
  }
  

2. 排查请求发送端 #

这种外层包裹双引号的情况，通常是发送端错误地对JSON对象做了两次序列化，或者直接将JSON字符串作为请求体发送（而非JSON对象）。建议检查发送端代码，确保直接发送JSON对象，从根源避免格式问题。

3. 优化Azure Functions配置与使用 #

• 全局序列化配置：你已配置app.UseNewtonsoft()，如果是Isolated Worker模式，可以进一步统一序列化规则：

  var host = new HostBuilder()
      .ConfigureFunctionsWorkerDefaults(app =>
      {
          app.UseNewtonsoft();
      })
      .ConfigureServices(services =>
      {
          services.Configure<NewtonsoftJsonSerializerOptions>(options =>
          {
              // 按需配置，例如忽略空值、设置日期格式
              options.SerializerSettings.NullValueHandling = Newtonsoft.Json.NullValueHandling.Ignore;
          });
      })
      .Build();
  

• 使用参数绑定简化操作：无需手动读取流，直接利用Functions的参数绑定特性自动反序列化：

  [Function("save")]
  public async Task<HttpResponseData?> SaveAppAsync(
      [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "v1/save")] YourTargetModel model) 
  { 
      // 直接使用model即可，框架会自动完成反序列化
  }
  

  这种方式更简洁，也能避免手动处理流时的格式问题。

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