spring jpa/hibernate 查询缓存导致内存溢出

最新推荐文章于 2025-04-28 16:18:36 发布

路过君_P

最新推荐文章于 2025-04-28 16:18:36 发布

阅读量2.5k

点赞数 1

CC 4.0 BY-SA版权

分类专栏： spring 文章标签： hibernate spring 缓存 jpa 内存溢出

本文链接：https://blog.csdn.net/zhoudingding/article/details/130819658

spring 专栏收录该内容

121 篇文章

订阅专栏

当应用使用Hibernate并频繁进行in查询时，由于参数数量差异导致QueryPlanCache缓存大量SQL，引发堆空间不足的内存溢出问题。为解决此问题，可以设置hibernate.query.plan_cache_max_size和hibernate.query.plan_parameter_metadata_max_size来限制缓存的SQL数量，以及启用in_clause_parameter_padding以优化in查询的参数填充，但需注意其对查询效率和参数数量的影响。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

版本

hibernate-5.6.10

问题

应用运行一段时间后发生堆空间不足内存溢出
根据内存快照可见大量org.hibernate.engine.query.spi.QueryPlanCache对象
在这里插入图片描述

原因

QueryPlanCache会缓存sql，以便于相同的sql重复编译
如果大量使用in查询，由于参数数量不同，hibernate会把其当成不同的sql进行缓存，从而缓存大量的sql导致heap内存溢出。

解决

添加配置参数限制缓存的sql数量

spring:  
  jpa:
    hibernate:
    properties:
      hibernate:
        query:
          plan_cache_max_size: 64 #缓存大小,默认值2048
          plan_parameter_metadata_max_size: 32 #参数元数据大小,默认值128
          in_clause_parameter_padding: true #对于in查询生成sql语句参数数量使用2的幂

注

in_clause_parameter_padding参数让in查询条件的参数数量自动填充到2的幂以减少不同sql的数量
例如，1或2个参数则自动构建为 ‘in (?,?)’ 3,4个参数构建为 ‘in (?,?,?,?)’。
对于填充的绑定参数，将使用提供的最后一个参数值

以下情况避免使用此参数：

如果不缓存执行计划，此参数起不到减少缓存的效果，反而因为额外的绑定参数降低了查询效率。
如果in查询包含大量元素，参数填充可能会大大增加 IN 子句中的参数数量。例如，包含 129 个元素的列表将填充到 256 个参数。

源码

org.hibernate:hibernate-core
org.hibernate.engine.query.spi.QueryPlanCache

/**
 * Acts as a cache for compiled query plans, as well as query-parameter metadata.
 *
 * @see Environment#QUERY_PLAN_CACHE_PARAMETER_METADATA_MAX_SIZE
 * @see Environment#QUERY_PLAN_CACHE_MAX_SIZE
 *
 * @author Steve Ebersole
 */
public class QueryPlanCache implements Serializable {
	/**
	 * The default strong reference count.
	 */
	public static final int DEFAULT_PARAMETER_METADATA_MAX_COUNT = 128;
	/**
	 * The default soft reference count.
	 */
	public static final int DEFAULT_QUERY_PLAN_MAX_COUNT = 2048;
	public QueryPlanCache(final SessionFactoryImplementor factory, QueryPlanCreator queryPlanCreator) {
		this.factory = factory;
		this.queryPlanCreator = queryPlanCreator;

		Integer maxParameterMetadataCount = ConfigurationHelper.getInteger(
				Environment.QUERY_PLAN_CACHE_PARAMETER_METADATA_MAX_SIZE,
				factory.getProperties()
		);
		if ( maxParameterMetadataCount == null ) {
			maxParameterMetadataCount = ConfigurationHelper.getInt(
					Environment.QUERY_PLAN_CACHE_MAX_STRONG_REFERENCES,
					factory.getProperties(),
					DEFAULT_PARAMETER_METADATA_MAX_COUNT
			);
		}
		Integer maxQueryPlanCount = ConfigurationHelper.getInteger(
				Environment.QUERY_PLAN_CACHE_MAX_SIZE,
				factory.getProperties()
		);
		if ( maxQueryPlanCount == null ) {
			maxQueryPlanCount = ConfigurationHelper.getInt(
					Environment.QUERY_PLAN_CACHE_MAX_SOFT_REFERENCES,
					factory.getProperties(),
					DEFAULT_QUERY_PLAN_MAX_COUNT
			);
		}

		queryPlanCache = new BoundedConcurrentHashMap( maxQueryPlanCount, 20, BoundedConcurrentHashMap.Eviction.LIRS );
		parameterMetadataCache = new BoundedConcurrentHashMap<>(
				maxParameterMetadataCount,
				20,
				BoundedConcurrentHashMap.Eviction.LIRS
		);

		nativeQueryInterpreter = factory.getServiceRegistry().getService( NativeQueryInterpreter.class );
	}
}