apache-common-pool2（配置参数详解，以及资源回收，从池中获取资源，将资源返还给池逻辑解析）

关注

原创最新推荐文章于 2026-07-18 23:31:54 发布 1.2w 阅读 AI 写同款· GEO 优化 ›

OAuth2.0集成SpringSecurity加JWT实现单点登录单点登录(Single sign on)，英文名称缩写SSO，SSO的意思就是在多系统的环境中，登录单方系统，就可以在不用再次登录的情况下访问相关受信任的系统。也就是说只要登录一次单体系统就可以阅读详情

本人基于 commons-pool2-2.3.jar 进行分析的，查看了jar的源码，分析源码的工作原理，总结出来的。

maxTotal 允许创建资源的最大数量，默认值 8，-1 代表无数量限制（int类型）

blockWhenExhausted 默认值 true ，当资源耗尽时，是否阻塞等待获取资源

maxWaitMillis 获取资源时的等待时间，单位毫秒。当 blockWhenExhausted 配置为 true 时，此值有效。 -1 代表无时间限制，一直阻塞直到有可用的资源。（long类型）

testOnBorrow 默认值 false ，当设置为true时，每次从池中获取资源时都会调用 factory.validateObject() 方法
testOnCreate 默认值 false，当设置为true时，只有当创建资源时才会调用 factory.validateObject() 方法

lifo 资源的存取数据结构，默认值 true，true 资源按照栈结构存取，false 资源按照队列结构存取

fairness 当从池中获取资源或者将资源还回池中时是否使用 java.util.concurrent.locks.ReentrantLock.ReentrantLock 的公平锁机制。默认值 false， true 使用公平锁，false 不使用公平锁，

timeBetweenEvictionRunsMillis 回收资源线程的执行周期，单位毫秒。默认值 -1 ，-1 表示不启用线程回收资源。（long类型）

evictionPolicyClassName 资源回收策略，默认值 org.apache.commons.pool2.impl.DefaultEvictionPolicy（String类型）

minEvictableIdleTimeMillis 资源最小空闲时间，默认值 1800000，单位毫秒，（long类型）
softMinEvictableIdleTimeMillis 软资源最小空闲时间，默认值 1800000，单位毫秒，（long类型）
（备注，这个两个参数，在资源回收策略中，会使用到）

maxIdle 最大空闲资源数，默认值 8 （int类型）

minIdle 最小空闲资源数，默认值 0 （int类型，当使用pool2编写自己的资源池时，结合spring的IOC，当项目启动时，会自动创建minIdle个资源。如何使用pool2，见我的另一篇文章 http://blog.youkuaiyun.com/liang_love_java/article/details/50511012）

testWhileIdle 默认值 false；设置为 true 时，当回收策略返回false时，则调用 factory.activateObject()和factory.validateObject()

testOnReturn 默认值 false；设置为 true 时，当将资源返还个资源池时候，验证资源的有效性，调用 factory.validateObject()方法，如果无效，则调用 factory.destroyObject()方法

numTestsPerEvictionRun 资源回收线程执行一次回收操作，回收资源的数量。默认值 3，（int类型）。
备注：
当设置为0时，不回收资源。
设置为小于0时，回收资源的个数为 (int)Math.ceil( 池中空闲资源个数 / Math.abs(numTestsPerEvictionRun) );
设置为大于0时，回收资源的个数为 Math.min( numTestsPerEvictionRun,池中空闲的资源个数 );

从池中获取资源的逻辑
1：
如果 blockWhenExhausted 配置的为 false，从资源池中获取资源，如果获取不到，则判断当前池中的对象数量是否超过了 maxTotal 设置的数量，如果没有超过，
则通过调用factory.makeObject() 创建对象，并将对象放入池中，执行第2步。如果超过了，则返回 null，逻辑到此结束。
如果 blockWhenExhausted 配置的为 true ，从资源池中获取资源，如果获取不到，则判断当前池中的对象数量是否超过了 maxTotal 设置的数量，如果没有超过，
则通过调用factory.makeObject() 创建对象，并将对象放入池中，执行第2步。如果超过了，则阻塞等待，如果 MaxWaitMillis 配置的为 -1 则阻塞等待，直到有可用的资源为止。
如果 maxWaitMillis 配置为 1000 则阻塞等待 1000毫秒，如果有可用资源，执行第2步，如果没有则返回 null，逻辑到此结束。
2：将资源的状态修改为已分配，执行第 3 步
3：调用 factory.activateObject() 方法，执行第 4步
4：如果 testOnBorrow 或者 testOnCreate 中有一个配置为 true 时，则调用 factory.validateObject() 方法
5：以上步骤都完成了，返回资源对象

将资源返还给池的逻辑
1：检查配置参数 testOnReturn，如果为 true，调用 factory.validateObject()方法，验证资源对象的有效性，验证结果为 false，则调用 factory.destroyObject()方法，逻辑到此结束。
验证结果为 true，则执行第 2 步。
2：调用 factory.passivateObject()方法，然后执行第 3 步
3：将资源的状态修改为未分配，执行第 4 步
4：进行判断（资源池是否关闭 || （maxIdle > -1 ) && ( maxIdle <= 资源池空闲资源个数) ）
如果判断为 true，则调用 factory.destroyObject()方法，逻辑到此结束。
如果判断为 false，则将资源返还给资源池，逻辑到此结束。

Apache_common_pool 启动一个线程执行释放资源的工作（使用 java.util.Timer 实现）从池中回收资源逻辑（回收资源的意思是，将资源从池中删除掉，例如，如果是TCP链接，则需要将链接断开，并从池中删除掉。）
1：根据 evictionPolicyClassName 配置的参数创建回收策略，
默认回收策略源码

import org.apache.commons.pool2.PooledObject;
public class DefaultEvictionPolicy
implements EvictionPolicy
{
public boolean evict(EvictionConfig config, PooledObject underTest, int idleCount)
{
if (((config.getIdleSoftEvictTime() < underTest.getIdleTimeMillis()) && (config.getMinIdle() < idleCount)) || (config.getIdleEvictTime() < underTest.getIdleTimeMillis()))
{
return true;
}
return false;
}
}
if条件判断与
(softMinEvictableIdleTimeMillis < 资源的空闲时间 && Math.min(maxIdle,minIdle) < 目前池中空闲的资源数) ||
minEvictableIdleTimeMillis < 资源的空闲时间
等价
2：根据配置的参数 numTestsPerEvictionRun 计算，要回收的资源数量（具体的计算规则，请参照源码）
3：根据回收策略判断，资源是否需要回收。如果是则将资源从池中删除，并调用factory.destroyObject()方法。
如果否则根据配置的 testWhileIdle 参数，判断是否执行 factory.activateObject()和factory.validateObject() ，factory.passivateObject() 方法。如果 testWhileIdle 配置为 true，则以次执行 factory.activateObject()，factory.validateObject()，factory.passivateObject()