WebClient构造复杂查询抛出java.lang.IllegalArgumentException如何解决

该异常是Spring WebClient的UriBuilder默认会将URI中{xxx}格式的内容识别为URI模板占位符，需要传入对应变量值才可完成展开，而PromQL的标签选择器语法恰好使用{}包裹标签匹配规则，因此被误判为未声明的模板变量，触发Not enough variable values available to expand报错。

Prometheus的/api/v1/query接口原生支持POST请求提交查询参数，无需将参数拼接在URL上，可完全规避特殊字符转义问题，正确写法如下：

// 直接构造完整PromQL，不需要额外处理URL转义
String promQl = "(sum(cluster_health{Component='kafka'}))/count(cluster_health{Component='kafka'})";

Mono<PrometheusResponse> responseMono = this.webClient.post()
        .uri("http://myserver:1234/api/v1/query")
        // 使用表单格式提交参数，符合Prometheus POST接口规范
        .contentType(MediaType.APPLICATION_FORM_URLENCODED)
        .bodyValue("query=" + promQl)
        .retrieve()
        .bodyToMono(PrometheusResponse.class);

如果需要附带时间戳等其他参数，直接拼接在请求体内容中即可，格式为query=xxx&time=123456。

你之前的写法不生效，是因为模板中{DPCOMP}被替换为包含{}的字符串后不会被二次解析为占位符，且未做URL编码，最终传到Prometheus的查询语法不符合要求。正确实现有两种可选：

• 方案1：仅将标签值作为占位符单独替换，避免整个选择器包含{}被误判

String componentVal = "kafka";
Mono<PrometheusResponse> responseMono = this.webClient.get()
        .uri(uriBuilder -> uriBuilder
                .scheme("http")
                .host("myserver")
                .port(1234)
                .path("/api/v1/query")
                // PromQL的{}结构直接写死在模板中，仅把动态的标签值设为占位符，不会被识别为URI模板变量
                .queryParam("query", "(sum(sa_cluster_health{Component='{component}'}))/count(sa_cluster_health{Component='{component}'})", componentVal)
                .build()
        )
        .retrieve()
        .bodyToMono(PrometheusResponse.class);

• 方案2：先对PromQL做URL编码，直接传入不使用模板解析

import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;

// 先构造完整PromQL
String promQl = "(sum(cluster_health{Component='kafka'}))/count(cluster_health{Component='kafka'})";
// 手动编码后作为query参数值，UriBuilder不会再解析内容里的{}
String encodedPromQl = URLEncoder.encode(promQl, StandardCharsets.UTF_8);

Mono<PrometheusResponse> responseMono = this.webClient.get()
        .uri("http://myserver:1234/api/v1/query?query=" + encodedPromQl)
        .retrieve()
        .bodyToMono(PrometheusResponse.class);

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