Solr中宏扩展${}与参数解引用$写法的核心区别

两种写法的核心差异来自执行阶段、实现逻辑的本质不同，和LTR模块的参数解析规则直接相关：

• efi.some_name=${queryParam}：通用宏文本替换
  这种写法是Solr全局通用的宏扩展机制，执行时机早于查询解析器的正式解析流程，本质是无语义的纯字符串替换：解析器工作前，会直接把${queryParam}这段文本原样替换成对应请求参数的字符串值，完全不感知参数的语义边界。
  当传入的queryParam值为multi worded string时，替换后实际交给解析器的内容是efi.some_name=multi worded string，此时空格会被识别为参数分隔符，仅multi会被赋值给some_name，剩余内容会被判定为无效查询片段，必须手动给替换位加引号包裹（即写成efi.some_name="${queryParam}"）才能正确识别完整值；如果参数值本身包含引号、特殊符号，还需要额外做转义，否则依然会抛出解析异常。
• efi.some_name=$queryParam：LTR解析器内置参数绑定
  这种写法是LTR模块专属的参数占位符逻辑，执行时机在查询解析阶段，不属于全局宏替换范畴：LTR查询解析器识别到$前缀的占位符时，会直接读取对应请求参数的完整值，绑定到指定的efi属性上，全程不会做文本层面的替换，天然保留参数值的完整边界。
  不管参数值是否包含空格、特殊符号，解析器都会将其作为一个完整的属性值处理，不需要额外加引号、手动转义，不会出现文本替换导致的参数截断问题，是LTR场景下传入外部特征的推荐写法。

补充说明：${}宏替换能力并非LTR模块专属，所有支持Solr宏扩展的查询解析器都可以使用该写法；而$单前缀的参数绑定仅在LTR相关查询（包含LTR ReRankQuery重排流程）中生效，不具备通用性。

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