使用Azure Search SDK如何配置indexer映射CSV到Edm.ComplexType

两个报错本质都是踩了Azure Search索引字段映射的认知偏差，没有搞清楚两个基础规则：

• 索引的FieldMapping机制中，TargetFieldName仅支持匹配索引的一级顶层字段，不支持用点分隔的路径直接定位复杂类型的嵌套子字段
• 嵌套在复杂类型下的子字段，根本不在一级字段的校验列表里，自然会触发“目标字段在索引中不存在”的报错。
  你之前能跑通_ref到RefIs的映射，是因为RefIs是Instrument类的一级简单字段，完全符合FieldMapping的匹配规则。

先核对索引用SDK生成的实际结构 #

你用C#特性标记生成复杂类型索引时，系统会自动生成两层字段结构：

• 一级字段：名为Identifier的非集合复杂类型（对应你定义的public Identifier Identifier { get; set; }）
• 嵌套子字段：Identifier节点下的Code字段（对应Identifier类里标记了Searchable的属性）
  这个结构下，如果你用扁平CSV做源数据，是没有办法直接把子字段值塞进复杂类型的子节点里的，必须配合对应规则做适配。

两种可直接落地的适配方案 #

方案1：通过映射函数构造复杂类型需要的结构 #

因为FieldMapping的目标不能直接指向嵌套子字段，你可以直接把目标对准一级的复杂字段本身，用内置映射函数把扁平的_code值包装成复杂类型要求的JSON对象结构：

// 删掉之前写的两个指向Code、Identifier.Code的错误映射
indexer.FieldMappings.Add(new FieldMapping("_code")
{
    TargetFieldName = "Identifier", // 直接对准一级的复杂类型字段
    MappingFunction = new FieldMappingFunction("jsonObject", new Dictionary<string, object>
    {
        // 用jsonObject函数把源字段值拼成和Identifier结构匹配的对象，{0}会自动替换为当前_code的实际值
        { "Code", "{0}" }
    })
});

注意使用这个方案时，要确保索引里的Identifier复杂类型不是集合类型（和你类里单个Identifier对象的定义保持一致），否则会出现结构不匹配的报错。

方案2：纯扁平适配（最稳定，适合CSV场景） #

如果不想依赖映射函数的逻辑，完全可以跳过嵌套复杂类型的结构，把需要的Code字段定义为Instrument类的一级字段，从根源上规避复杂类型的映射限制：
调整后的类结构参考：

public class Instrument
{
    public Identifier Identifier { get; set; }
        
    [SearchableField(IsSortable = true, IsKey = true)]
    public string Id { get; set; }

    [SearchableField(IsSortable = true)]
    public string RefIs { get; set; }

    [SearchableField(IsSortable = true)]
    public string IdentifierCode { get; set; }
}

对应的字段映射和之前的_ref写法完全一致，没有额外逻辑：

indexer.FieldMappings.Add(new FieldMapping("_code")
{
    TargetFieldName = "IdentifierCode"
});

这种方式没有任何复杂的规则依赖，对扁平CSV数据源的适配性最好，排查问题的成本最低。

• 把TargetFieldName写为Code：当前索引的一级字段列表里根本没有叫Code的字段，这个字段是嵌套在Identifier复杂类型下的，系统遍历校验一级字段时自然找不到匹配项。
• 把TargetFieldName写为Identifier.Code：索引的FieldMapping校验逻辑根本不识别点分隔的嵌套路径，只会拿这个字符串和一级字段名做精确匹配，匹配不上就会触发不存在的报错。

补充关键规则：只有当数据源本身就是嵌套JSON结构、和索引的复杂类型schema完全对齐时，才不需要写字段映射就能自动同步嵌套字段。只要源数据是扁平结构（比如CSV、TSV），所有嵌套到复杂类型的字段都没法通过点路径直接做TargetFieldName映射。

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