ASP.NET Core Web API中HttpGet传复杂类型Where属性为空问题排查

可能的问题原因及排查方向 #

1. StandardRequest<T>的Where属性可访问性问题 #

检查Where属性是否具备public的getter和setter，模型绑定器无法为私有/内部属性或只读属性赋值：

// 错误示例：无setter或访问级别不足
public Expression<Func<Employee, bool>> Where { get; }

// 正确示例
public Expression<Func<Employee, bool>> Where { get; set; }

如果Where是自定义复杂类型，需确保该类型的所有子属性也符合public可访问要求。

2. Expression类型的序列化限制 #

Expression<Func<T,bool>>是表达式树结构，无法被JSON序列化器直接处理——这大概率是核心问题。JSON只能序列化简单值类型、常规类/结构体，表达式树包含编译后的代码节点，序列化时会被忽略或抛出异常。

3. 模型绑定配置与请求方式不匹配 #

• 若使用POST请求，必须在控制器参数上标记[FromBody]，否则模型绑定器不会从请求体解析参数：

  [HttpPost("retrieve-multiple")]
  public IActionResult RetrieveMultipleEmployees([FromBody] StandardRequest<Employee> request)
  {
      // 业务逻辑
  }
  

• 检查请求的Content-Type是否为application/json，否则JSON序列化器无法识别请求体内容。
• 若通过URL查询字符串传递复杂对象，ASP.NET Core模型绑定对嵌套属性/复杂类型支持有限，建议改用POST请求体传递。

4. JSON序列化配置异常 #

检查Program.cs中的序列化配置，是否存在忽略属性的设置：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 若使用字段而非属性，需开启IncludeFields；默认只序列化属性
        options.JsonSerializerOptions.IncludeFields = false;
        // 确保大小写不敏感匹配
        options.JsonSerializerOptions.PropertyNameCaseInsensitive = true;
    });

5. 路由生成方法的参数传递错误 #

检查RetrieveMultipleEmployeesRoute方法是否正确传递参数：

• 使用HttpClient发送请求时，必须用PostAsJsonAsync将对象序列化为JSON放入请求体：

  var response = await _httpClient.PostAsJsonAsync("api/employees/retrieve-multiple", request);
  

• 禁止通过URL拼接传递复杂对象属性，否则Where这类嵌套/复杂属性会被丢弃。

技术建议 #

1. 替换Expression类型为可序列化DTO：定义简单的查询条件DTO，替代无法序列化的表达式树，在控制器中再转换为查询逻辑：

   public class FilterCondition
   {
       public string Field { get; set; }
       public string Operator { get; set; } // 如"Equals"、"Contains"
       public object Value { get; set; }
   }
   
   public class StandardRequest<T>
   {
       public List<FilterCondition> Where { get; set; }
   }
   

   可借助Dynamic LINQ库，将FilterCondition转换为对应的Expression。
2. 统一使用POST请求体传递复杂参数：避免用URL查询字符串传递嵌套对象，减少模型绑定失败概率。
3. 验证模型绑定状态：在控制器中检查ModelState.IsValid，快速定位参数绑定错误：

   if (!ModelState.IsValid)
   {
       return BadRequest(ModelState);
   }
   

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