自定义TimedAspect匹配范围引发Prometheus标签不一致问题

核心背景 #

Prometheus有硬性规则：同名指标的标签键集合必须完全一致，如果同一指标存在两组不同的标签键（比如你遇到的web_photos_gotten_list_seconds同时有[class, exception, method]和[exception, method, outcome, status, uri]两组标签），就会直接抛出IllegalArgumentException。

仅匹配@Timed时出错的原因 #

当你的TargetedTimedAspect切面仅拦截带@Timed注解的方法时，实际存在两个不同的逻辑在生成同名指标：

• 自定义切面为标记@Timed的方法生成带class标签的指标
• Spring Boot默认的WebMvcMetricsFilter（或其他内置Timed处理逻辑）会为HTTP请求方法自动生成带uri、status、outcome这些Web相关标签的同名指标
  这两个来源的指标标签键不统一，直接触发Prometheus的校验报错。

结合其他切入点后正常的原因 #

把切面切入点改成同时匹配@Timed和asyncAnnotatedPointcut/allowedMethodPointcut，本质是解决了「多逻辑生成同名指标」的问题：

1. 统一生成逻辑：自定义切面优先拦截了原本会被默认切面处理的方法，让所有生成web_photos_gotten_list_seconds指标的路径都走同一个标签生成规则，确保标签键完全一致
2. 限定处理范围：allowedMethodPointcut可能缩小了切面的处理范围，避免自定义切面和默认切面处理同一批方法，从根源上消除了标签冲突

额外注意事项 #

• 检查Spring Boot Actuator的Metrics配置，确认是否开启了默认的Web指标自动生成
• 自定义Timed切面时，要么统一所有同名指标的标签规则，要么通过切入点明确划分处理范围，避免和默认逻辑产生冲突

内容的提问来源于stack exchange，提问作者Шатов Данил