.NET 7中JsonModelBinder在IIS处理大POST请求失效问题

问题概况 #

• 实现的批量消息发送功能在本地IIS Express运行正常，但部署到生产IIS后，控制器参数newMessages列表为空，触发空值错误
• 控制器参数定义：[FromBody][ModelBinder(BinderType = typeof(JsonModelBinder))] List<NewMailDTO> newMessages，数据通过multipart/form-data表单提交
• 已配置的请求大小限制：
  应用层FormOptions配置：

  services.Configure<FormOptions>(x =>
              {
                  x.MultipartBodyLengthLimit = int.MaxValue;
                  x.MultipartHeadersLengthLimit = int.MaxValue;
                  x.ValueLengthLimit = int.MaxValue;
              });
  

  Web.config配置：<requestLimits maxAllowedContentLength="2147483648" />
• 调整请求大小相关配置无效，仅本地可用，怀疑自定义JsonModelBinder反序列化存在问题，Binder代码如下：

  public class JsonModelBinder : IModelBinder
  {
      public Task BindModelAsync(ModelBindingContext bindingContext)
      {
          if (bindingContext == null)
          {
              throw new ArgumentNullException(nameof(bindingContext));
          }
  
  
          var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
          if (valueProviderResult != ValueProviderResult.None)
          {
              bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueProviderResult);
  
              var valueAsString = valueProviderResult.FirstValue;
              var result = Newtonsoft.Json.JsonConvert.DeserializeObject(valueAsString, bindingContext.ModelType);
              if (result != null)
              {
                  bindingContext.Result = ModelBindingResult.Success(result);
                  return Task.CompletedTask;
              }
          }
  
          return Task.CompletedTask;
      }
  }
  

原因分析 #

1. 注解与提交格式冲突：[FromBody]默认处理纯JSON请求体，而multipart/form-data是多部分表单格式，两者绑定逻辑不兼容，本地IIS Express对这种冲突的处理更宽松，生产IIS则严格遵循规则。
2. 自定义Binder存在缺陷：当前Binder仅尝试获取单个值反序列化，若表单中JSON字段传递异常或反序列化失败，直接返回空结果且未记录错误，无法定位问题；同时未处理multipart/form-data下的表单字段读取逻辑。
3. 生产IIS环境差异：应用池的.NET版本、托管模式可能与本地不一致，或存在IIS模块（如请求过滤）的额外限制，导致绑定逻辑异常。

解决方案 #

1. 修正注解匹配提交格式 #

移除[FromBody]注解，仅保留[ModelBinder]，因为multipart/form-data提交不适用[FromBody]：

[ModelBinder(BinderType = typeof(JsonModelBinder))] List<NewMailDTO> newMessages

同时确保前端将JSON数据作为名为newMessages的表单字段提交。

2. 完善自定义JsonModelBinder #

添加错误捕获与日志记录，便于排查反序列化问题：

public class JsonModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        if (bindingContext == null)
        {
            throw new ArgumentNullException(nameof(bindingContext));
        }

        var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueProviderResult != ValueProviderResult.None)
        {
            bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueProviderResult);
            var valueAsString = valueProviderResult.FirstValue;

            try
            {
                var result = Newtonsoft.Json.JsonConvert.DeserializeObject(valueAsString, bindingContext.ModelType);
                if (result != null)
                {
                    bindingContext.Result = ModelBindingResult.Success(result);
                }
                else
                {
                    bindingContext.ModelState.AddModelError(bindingContext.ModelName, "无法将数据反序列化为有效对象");
                }
            }
            catch (JsonException ex)
            {
                bindingContext.ModelState.AddModelError(bindingContext.ModelName, $"反序列化失败：{ex.Message}");
            }
        }
        else
        {
            bindingContext.ModelState.AddModelError(bindingContext.ModelName, "未找到对应字段的提交数据");
        }

        return Task.CompletedTask;
    }
}

之后可通过检查ModelState.IsValid获取具体错误信息。

3. 改用纯JSON提交（推荐） #

若业务允许，将提交方式改为application/json，保留[FromBody]注解并移除自定义Binder，让ASP.NET Core自动处理反序列化：

[FromBody] List<NewMailDTO> newMessages

这种方式符合框架默认逻辑，减少自定义代码带来的问题。

4. 检查生产IIS配置 #

• 确认应用池的.NET版本与本地开发环境一致
• 通过IIS管理器的“配置编辑器”检查system.webServer/security/requestFiltering/requestLimits的实际配置是否生效
• 排查是否存在URL Rewrite等模块的额外请求限制

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