如何解决Elasticsearch模板中Mustache布尔值使用的空双引号问题？

问题场景 #

需要通过Mustache的反向条件判断（{{^isLocationFunctionNeeded}}），根据布尔参数决定是否在function_score的functions数组中包含location评分函数。但模板渲染后会生成空字符串""，导致Elasticsearch解析报错。

原始模板片段 #

"must": {
    "function_score": {
        "functions": [
            "{{^isLocationFunctionNeeded}}",
            {
                "exp": {
                    "location": {
                        "origin": {
                            "lat": "0.0",
                            "lon": "0.0"
                        },
                        "offset": "1km",
                        "scale": "50km"
                    }
                }
            },
            "{{/isLocationFunctionNeeded}}",
            {
                "random_score": {},
                "weight": 0.00001
            }
        ],
        "score_mode": "sum"
    }
}

渲染后错误结果 #

当isLocationFunctionNeeded: true时，渲染出的functions数组会包含空字符串：

"must": {
    "function_score": {
        "functions": [
            "",
            {
                "random_score": {},
                "weight": 1.0E-5
            }
        ],
        "score_mode": "sum"
    }
}

解析错误信息 #

"error": {
    "root_cause": [
        {
            "type": "parsing_exception",
            "reason": "failed to parse [START_OBJECT]. malformed query, expected a [VALUE_STRING] while parsing functions but got a [function_score] instead",
            "line": x,
            "col": x
        }
    ],
    "type": "x_content_parse_exception",
    "reason": "[bool] failed to parse field [must]",
    "caused_by": {
        "type": "parsing_exception",
        "reason": "failed to parse [START_OBJECT]. malformed query, expected a [VALUE_STRING] while parsing functions but got a [function_score] instead",
        "line": x,
        "col": x
    }
}

问题原因 #

Mustache渲染反向条件块时，若条件为true，会将条件标签前后的空白字符（换行、空格）渲染为空字符串，插入到functions数组中。而Elasticsearch要求function_score.functions的元素必须是评分函数对象，无法识别字符串类型元素，因此触发解析错误。

解决方案 #

调整Mustache标签的位置，将条件判断直接包裹整个评分函数对象及对应的数组分隔符，避免生成空字符串元素。修改后的模板如下：

"must": {
    "function_score": {
        "functions": [
            {{^isLocationFunctionNeeded}}{
                "exp": {
                    "location": {
                        "origin": {
                            "lat": "0.0",
                            "lon": "0.0"
                        },
                        "offset": "1km",
                        "scale": "50km"
                    }
                }
            },{{/isLocationFunctionNeeded}}
            {
                "random_score": {},
                "weight": 0.00001
            }
        ],
        "score_mode": "sum"
    }
}

关键调整点 #

• 移除条件标签前后的引号，直接将{{^isLocationFunctionNeeded}}放在location函数对象的前面，{{/isLocationFunctionNeeded}}放在对象后的逗号后面
• 这样当isLocationFunctionNeeded: true时，整个location函数块会被完全移除，functions数组中仅保留random_score对象，无多余元素

验证示例 #

修改后的完整模板 #

{
    "script": {
        "lang": "mustache",
        "source": {
            "must": {
                "function_score": {
                    "functions": [
                        {{^isLocationFunctionNeeded}}{
                            "exp": {
                                "location": {
                                    "origin": {
                                        "lat": "0.0",
                                        "lon": "0.0"
                                    },
                                    "offset": "1km",
                                    "scale": "50km"
                                }
                            }
                        },{{/isLocationFunctionNeeded}}
                        {
                            "random_score": {},
                            "weight": 0.00001
                        }
                    ],
                    "score_mode": "sum"
                }
            }
        }
    }
}

调用参数 #

{
    "id": "example_template",
    "params": {
        "isLocationFunctionNeeded": true
    }
}

正确渲染结果 #

"must": {
    "function_score": {
        "functions": [
            {
                "random_score": {},
                "weight": 1.0E-5
            }
        ],
        "score_mode": "sum"
    }
}

当isLocationFunctionNeeded: false时，会正常包含location评分函数：

"must": {
    "function_score": {
        "functions": [
            {
                "exp": {
                    "location": {
                        "origin": {
                            "lat": "0.0",
                            "lon": "0.0"
                        },
                        "offset": "1km",
                        "scale": "50km"
                    }
                }
            },
            {
                "random_score": {},
                "weight": 1.0E-5
            }
        ],
        "score_mode": "sum"
    }
}

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