MarkLogic Lexicon扩展未按预期工作：cts.jsonPropertyValueQuery使用疑问

核心原因 #

cts.jsonPropertyValueQuery()默认不会自动触发Lexicon扩展做通配符搜索，它的默认逻辑是直接在倒排索引中做词项片段匹配，这就是你拿到大量无关结果的根源——倒排索引的通配符匹配是基于词项的部分片段匹配，而非先通过Lexicon扩展出所有符合通配规则的完整词项再执行搜索。

为什么Lexicon扩展没生效？ #

你看到的lexicon-expansion-limit这类参数，是当查询触发Lexicon扩展后，用来限制返回词项数量的参数，而非开启Lexicon扩展的开关。要让cts.jsonPropertyValueQuery()启用Lexicon扩展，必须满足两个前提：

• 目标JSON属性已配置范围索引（Range Index）——Lexicon的词项列表完全依赖范围索引生成；
• 查询中需显式指定wildcarded选项为true，同时确保lexicon-expansion-limit数值足够覆盖匹配到的词项数（你的场景中3066小于默认的4096，这个条件是满足的）。

正确调用示例：

cts.jsonPropertyValueQuery(
  "target-property-name", 
  "*your-wildcard-pattern*", 
  ("wildcarded", "lexicon-expansion-limit=4096")
)

手动调用cts.valueMatch()与Lexicon扩展的关系 #

你手动用cts.valueMatch()获取词项再执行搜索，逻辑上和Lexicon扩展一致，但Lexicon扩展是查询内部自动完成的优化流程，无需手动拼接词项列表，效率更高。既然手动方式有效，说明目标属性已经配置了范围索引（否则cts.valueMatch()也无法返回结果），只是你没在cts.jsonPropertyValueQuery()中正确触发Lexicon扩展而已。

快速排查步骤 #

• 确认目标属性的范围索引已创建并生效；
• 在查询中添加wildcarded选项，触发Lexicon扩展路径；
• 检查查询是否存在其他冲突参数（比如大小写敏感设置这类可能干扰词项匹配的选项）。

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