Spring Boot Actuator未自动生成Hibernate指标问题及疑问

核心问题场景 #

使用Spring Boot 2.7.16 + Hibernate-core 5.6.15.Final + Hibernate-micrometer 6.3.1.Final，通过编程方式手动配置多个Hibernate连接（未使用application.properties的JPA自动配置），已开启hibernate.generate_statistics=true，但HibernateMetricsAutoConfiguration未自动生成HibernateMetrics和HibernateQueryMetrics指标；自行创建HibernateMetrics Bean后指标也无法更新。调整配置（改为单例Bean、引入c3p0等）后指标恢复正常，但疑惑为何hibernate-c3p0-micrometer-actuator-spring无法自动创建指标。

自动配置失效的原因 #

1. 自动配置的触发范围限制
   Spring Boot的HibernateMetricsAutoConfiguration默认只识别由Spring Boot自动配置生成的EntityManagerFactory（即通过spring.jpa.*系列配置初始化的实例）。而你通过编程手动创建的SessionFactory/EntityManagerFactory属于自定义Bean，不在自动配置类的扫描绑定范围内，因此不会自动触发指标注册。

2. 版本兼容性问题
   你使用的Hibernate-core是5.6.x版本，但Hibernate-micrometer是6.3.x版本。Hibernate 6对micrometer的集成逻辑与Hibernate 5存在API差异，hibernate-c3p0-micrometer-actuator-spring的自动适配逻辑是针对特定版本组合设计的，跨大版本的依赖会导致自动绑定逻辑无法兼容旧版本的SessionFactory，无法自动创建MeterBinder。

3. Bean生命周期不匹配
   之前使用@Scope("prototype")的按需创建连接模式，会导致每次获取Bean时生成新的SessionFactory实例。而MeterBinder需要绑定到长期稳定存在的SessionFactory才能持续收集指标数据，频繁销毁重建的实例会让指标绑定失效，即使手动创建HibernateMetrics Bean，也无法跟踪到新生成的SessionFactory的统计数据。

为什么调整配置后指标恢复正常 #

你采取的以下操作解决了核心问题：

• 改为单例Bean：固定了SessionFactory实例的生命周期，MeterBinder可以持续绑定到同一个实例，实时收集统计数据。
• 引入c3p0连接池：hibernate-c3p0提供了稳定的连接管理，同时hibernate-c3p0-micrometer-actuator-spring可以捕获连接池的统计指标，配合Hibernate自身的统计开关，完成指标数据的传递。
• 明确开启统计配置：通过hibernate.generate_statistics=true确保Hibernate内部生成统计数据，为Metrics提供数据源。

关于hibernate-c3p0-micrometer-actuator-spring无法自动创建指标的疑问解答 #

1. 自动配置依赖Spring Boot JPA自动流程
   该组件的自动配置类仅在Spring Boot通过spring.jpa.*配置自动创建EntityManagerFactory时才会触发，你的手动编程配置绕过了这个自动流程，因此自动配置逻辑不会生效。

2. 版本跨大版本不兼容
   Hibernate 6的micrometer集成API与Hibernate 5不兼容，你使用的Hibernate-micrometer 6.3.1无法正确识别Hibernate-core 5.6.15的SessionFactory实例，导致自动绑定失败。建议保持Hibernate核心与micrometer组件的版本一致（比如都用5.6.x版本的hibernate-micrometer）。

3. 之前的prototype scope导致实例不稳定
   即使自动配置触发，频繁创建销毁的SessionFactory也会让MeterBinder无法绑定到有效实例，指标无法持续更新，改成单例后才解决了这个生命周期问题。

内容的提问来源于stack exchange，提问作者Mr. Nobody