ElasticSearch返回嵌套属性无法映射到C#类且属性始终为NULL问题

根因分析 #

你遇到的嵌套对象反序列化为null的核心问题是序列化映射规则不匹配，结合代码细节具体原因如下：

1. NEST的[Keyword]、[Nested]等特性仅用于索引映射配置、查询构建，不会用于_source内容的反序列化字段匹配，反序列化遵循的是你项目所用JSON序列化器（System.Text.Json/ Newtonsoft.Json）的规则。
2. PartPricing类中Application、IsFreeShipping两个属性没有添加对应的序列化字段映射特性，反序列化时无法匹配ES返回的PascalCase字段名，导致整个List反序列化失败返回null。
3. 额外冗余配置：PartPricing类上的[ElasticsearchType(RelationName = "Pricing")]是用于ES Join字段的关系声明，嵌套对象不需要该配置，可能引发额外映射冲突。

修复步骤 #

方案1：补充序列化映射特性 #

根据你项目使用的序列化器，给PartPricing所有属性补充对应的字段映射：

若使用System.Text.Json作为序列化器

// 移除多余的ElasticsearchType特性
public class PartPricing
{
    [JsonPropertyName("Application")]
    [Keyword(Name = "Application")]
    public string Application { get; set; }

    [JsonPropertyName("BasePrice")]
    [Number(NumberType.Double, Name = "BasePrice")]
    public decimal BasePrice { get; set; }

    [JsonPropertyName("IsFreeShipping")]
    [Boolean(Name = "IsFreeShipping")]
    public bool IsFreeShipping { get;set; }

    [JsonPropertyName("CustomerPrice")]
    [Number(NumberType.Double, Name = "CustomerPrice")]
    public decimal CustomerPrice { get; set; }
}

若使用NEST默认的Newtonsoft.Json作为序列化器

将上述代码中的[JsonPropertyName]替换为[JsonProperty]（需要引用Newtonsoft.Json命名空间）即可。

方案2：全局配置NEST字段映射规则 #

如果你不想给每个属性单独加映射特性，可以在NEST客户端初始化时关闭默认的驼峰转换，直接匹配PascalCase字段：

var settings = new ConnectionSettings(new Uri("你的ES服务地址"))
    // 关闭默认驼峰转换，直接使用C#属性名匹配ES中的字段名
    .DefaultFieldNameInferrer(fieldName => fieldName)
    .DefaultIndex("parts");
var client = new ElasticClient(settings);

验证步骤 #

修复后可先拿到ES返回的原始JSON字符串，手动用对应序列化器反序列化到Product类，确认映射正常后再验证NEST查询结果即可。

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