Lettuce 无法直接暴露 Prometheus 指标，因其无 HTTP 端点、不内置 Actuator 接口且默认关闭指标采集；必须通过 Spring Boot + Micrometer + Actuator 桥接，手动配置 ClientOptions 注入 MicrometerMetricCollector 并绑定 MeterRegistry，同时确保 Actuator 正确暴露 /actuator/prometheus 端点。
直接暴露 Lettuce 的指标给 Prometheus 不可行——它本身不提供 HTTP metrics 端点，也不内置 Actuator 风格的监控接口。必须通过 Spring Boot + Micrometer + Actuator 桥接，再配合自定义指标注册逻辑才能让 Redis 连接行为（如超时、连接数、命令延迟）变成 Prometheus 可抓取的时序数据。
为什么不能直接用 lettuce-core 暴露 /actuator/prometheus
Lettuce 是纯客户端库，没有 Web 层、不启动 HTTP 服务、也不自动注册 Micrometer 指标。即使你引入了 micrometer-registry-prometheus，若没显式配置并绑定指标到 MetricsMeterRegistry，Prometheus 抓到的 /actuator/prometheus 里根本不会出现任何 Redis 相关指标。
- 常见错误现象：
curl localhost:8080/actuator/prometheus | grep redis返回空 - 根本原因：Lettuce 默认关闭所有指标采集，且不参与 Spring Boot AutoConfiguration 的 MeterBinder 自动装配
- 关键动作：必须手动启用 Lettuce 的 Micrometer 支持，并将
RedisClient或StatefulRedisConnection关联到全局MeterRegistry
启用 lettuce-core 的 Micrometer 指标采集
在创建 RedisClient 实例时，需传入带 Micrometer 配置的 ClientOptions，否则所有连接池、命令、延迟等维度的指标都不会产生。
- 必须使用
ClientOptions.builder().metricCollector(...)显式注入MicrometerMetricCollector - Spring Boot 3.x 中推荐方式是通过
@Bean定义RedisClient，并在构造时注入MeterRegistry - 示例代码片段：
@Bean
public RedisClient redisClient(MeterRegistry meterRegistry) {
ClientOptions options = ClientOptions.builder()
.metricCollector(new MicrometerMetricCollector(meterRegistry))
.build();
RedisURI uri = RedisURI.create("redis://localhost:6379");
return RedisClient.create(ClientResources.create(), uri, options);
}
- 注意：
MicrometerMetricCollector来自io.lettuce.core.metrics.micrometer包，需额外引入lettuce-core6.2+（低版本无此类） - 漏掉
ClientResources.create()可能导致连接池未被监控——该对象承载连接生命周期管理，指标依赖其内部事件发布机制
确保 /actuator/prometheus 能暴露 Redis 指标
即使指标已注册，若 Actuator 配置或包扫描有误，依然无法在端点中看到它们。这不是 Lettuce 的问题，而是 Spring Boot 的暴露控制逻辑。
- 检查
application.yml是否包含：
management:
endpoints:
web:
exposure:
include: health,info,metrics,prometheus
endpoint:
prometheus:
show-details: when_authorized
- 确认项目已引入
spring-boot-starter-actuator和micrometer-registry-prometheus - 验证指标是否注册成功（非端点）：
curl localhost:8080/actuator/metrics | jq '.names[] | select(contains("redis"))'—— 若返回空，说明指标压根没注册进去 - 常见陷阱：多个
RedisClientBean 导致指标重复注册或覆盖；或@Primary缺失引发自动配置 fallback 到默认无监控的 client
抓取不到数据？先查 Prometheus targets 页面
Prometheus 抓取失败往往不是 Lettuce 配置问题，而是网络、路径或权限卡住。别急着改 Java 代码，先看 targets。
- 访问
http://<prometheus>/targets</prometheus>，确认你的应用实例状态为UP，且抓取路径是/actuator/prometheus（不是/prometheus或/metrics） - 如果显示
context deadline exceeded，优先检查应用是否监听在 0.0.0.0（而非 localhost），以及防火墙/ServiceMesh 是否拦截了 8080 端口 - 如果指标名是
redis.command.latency但无标签，大概率是ClientOptions里没传tags——Lettuce 默认只打基础标签（如command,result），业务维度（如cluster,env）得自己加
真正容易被忽略的是：Lettuce 的指标只有在**实际发生 Redis 命令调用后**才会首次上报。空跑 client 不会产生任何样本值，Prometheus 里会显示 “no data” 而不是报错——这点和 JVM 或 Nginx Exporter 完全不同。
