Spring WebClient中如何格式化URL避免URI标签数量超限？

问题背景 #

我们在日志中收到来自org.springframework.boot.actuate.autoconfigure.metrics.OnlyOnceLoggingDenyMeterFilter的警告：

Reached the maximum number of URI tags for 'http.client.requests'. Are you using 'uriVariables'

该警告表明系统生成了过多不同的URI标签，导致Micrometer指标维度超限。我们尝试了两种WebClient写法都未解决问题：

第一种写法（无效） #

return webClient
    .get()
    .uri(
        builder ->
            builder
                .path("users/{userId}/summary")
                .queryParam("timezone", "{timezone}")
                .build(Map.of("userId", userId, "timezone", timezone)))

这种写法直接在UriBuilder中调用build(Map...)生成具体URI，Micrometer无法捕获原始模板，只能将每个带具体参数的URI作为独立标签，最终触发超限警告。

第二种写法（无效） #

String uri = UriComponentsBuilder.fromPath("users/{userId}/summary")
    .queryParam("timezone", "{timezone}")
    .toUriString();
return webClient
    .get()
    .uri(uri, Map.of("userId", userId, "timezone", timezone));

toUriString()会将URI模板中的{}编码为%7B和%7D，导致WebClient无法识别并替换变量，最终还是生成带具体参数的URI，无法解决标签超限问题。

正确解决方案 #

要让Micrometer捕获统一的URI模板，需让WebClient保留模板信息，再由框架处理变量替换。以下是两种简洁规范的写法：

写法一：使用UriBuilder.expand() #

通过expand()传递变量后再调用build()生成URI，Micrometer可识别原始模板：

return webClient
    .get()
    .uri(builder -> builder
        .path("users/{userId}/summary")
        .queryParam("timezone", "{timezone}")
        .expand(Map.of("userId", userId, "timezone", timezone))
        .build());

写法二：直接传递模板和变量 #

利用WebClient的uri(String, Object...)或uri(String, Map<String, ?>)重载，直接传入模板和变量，框架自动处理模板识别与变量替换：

// 可变参数形式
return webClient
    .get()
    .uri("users/{userId}/summary?timezone={timezone}", userId, timezone);

// Map形式
return webClient
    .get()
    .uri("users/{userId}/summary?timezone={timezone}", Map.of("userId", userId, "timezone", timezone));

原理说明 #

当WebClient采用「模板+变量」的方式构建请求时，Micrometer会拦截原始模板字符串，将其作为uri标签值上报，而非每个具体的参数化URI。所有同模板的请求会归为同一个指标标签，避免生成大量重复维度，解决标签超限问题。

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