Elasticsearch/NEST中Dictionary类型Metadata字段索引配置问题：如何禁用默认分析器或设置自定义分析器

你的问题核心在于Elasticsearch默认会把Metadata字典里的字符串值映射成text类型，并用标准分析器处理（比如转小写、拆分词汇），而Term查询是精确匹配原始值，所以自然查不到结果。下面给你几种针对性的解决方案：

方案1：全局禁用Metadata下所有字符串的分析（最直接） #

如果你的需求是对Metadata里的所有字符串都做精确匹配，最省心的方式是通过动态模板，把所有字符串字段映射成keyword类型（不分词、保留原始值）。用NEST代码创建索引映射的示例如下：

client.CreateIndex("documents", c => c
    .Settings(s => s.NumberOfShards(1))
    .Mappings(m => m
        .Map<Document>(mm => mm
            .AutoMap()
            .Properties(p => p
                .Object<Dictionary<string, object>>(o => o
                    .Name(n => n.Metadata)
                    .DynamicTemplates(dt => dt
                        .DynamicTemplate("metadata_strings_as_keyword", t => t
                            .MatchMappingType("string")
                            .Mapping(mapping => mapping.Keyword(k => k.IgnoreAbove(256)))
                        )
                    )
                )
            )
        )
    )
);

这样配置后，Metadata里的所有字符串都会以原始形式存储，你的Term查询就能精准命中"RU"这类值了。

方案2：为Metadata设置自定义分析器 #

如果需要部分字段分词、部分字段精确匹配，可以自定义分析器，再通过动态模板分配规则。比如只让author_country用精确匹配，其他字符串用自定义分析器：

client.CreateIndex("documents", c => c
    .Settings(s => s
        .NumberOfShards(1)
        .Analysis(a => a
            .Analyzers(an => an
                // 自定义分析器：标准分词+转小写
                .Custom("my_custom_analyzer", ca => ca
                    .Tokenizer("standard")
                    .Filters("lowercase")
                )
            )
        )
    )
    .Mappings(m => m
        .Map<Document>(mm => mm
            .AutoMap()
            .Properties(p => p
                .Object<Dictionary<string, object>>(o => o
                    .Name(n => n.Metadata)
                    .DynamicTemplates(dt => dt
                        // 匹配author_country字段，用keyword精确匹配
                        .DynamicTemplate("metadata_special_fields_as_keyword", t => t
                            .Match("author_country")
                            .Mapping(mapping => mapping.Keyword())
                        )
                        // 其他字符串用自定义分析器
                        .DynamicTemplate("metadata_other_strings", t => t
                            .MatchMappingType("string")
                            .Mapping(mapping => mapping.Text(tx => tx.Analyzer("my_custom_analyzer")))
                        )
                    )
                )
            )
        )
    )
);

方案3：仅针对特定类型的值禁用分析 #

如果只想对字符串类型禁用分析，日期、数字等类型保持Elasticsearch的自动映射（比如publish_date自动识别为date类型），可以调整动态模板的匹配逻辑，只处理字符串：

client.CreateIndex("documents", c => c
    .Mappings(m => m
        .Map<Document>(mm => mm
            .AutoMap()
            .Properties(p => p
                .Object<Dictionary<string, object>>(o => o
                    .Name(n => n.Metadata)
                    .DynamicTemplates(dt => dt
                        .DynamicTemplate("metadata_strings_as_keyword", t => t
                            .MatchMappingType("string")
                            .Mapping(mapping => mapping.Keyword())
                        )
                    )
                )
            )
        )
    )
);

这个配置会让日期、数字等类型正常映射，只有字符串会被设为keyword，兼顾精确匹配和类型识别。

关键注意事项 #

1. 映射必须在创建索引前配置，如果索引已存在，需要用PutMapping更新后重新索引所有文档，新映射才会生效。
2. 如果需要不区分大小写的精确匹配，可以给keyword字段配置normalizer：

   // 在Settings里添加小写归一器
   .Settings(s => s
       .Analysis(a => a
           .Normalizers(n => n
               .Custom("lowercase_normalizer", cn => cn.Filters("lowercase"))
           )
       )
   )
   // 在keyword映射里指定归一器
   .Mapping(mapping => mapping.Keyword(k => k.Normalizer("lowercase_normalizer")))
   

   这样存储和查询时都会自动转小写，实现不区分大小写的精确匹配。

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