Keycloak 24.x性能衰退问题排查及配置优化咨询

一、核心排查方向 #

1. 数据库连接池瓶颈 #

当前KC_DB_POOL_INITIAL_SIZE/MAX_SIZE/MIN_SIZE均设为20，虽CPU、内存使用率未达阈值，但数据库连接池可能成为隐性瓶颈：

• 检查数据库端连接状态：是否存在大量空闲未释放的连接，或连接等待队列过长
• 验证查询性能：令牌生成涉及的用户、会话查询是否存在慢SQL（例如未命中索引）
• 临时调大连接池最大尺寸至30-40，观察性能衰退是否缓解

2. HTTP线程池配置不匹配 #

KC_HTTP_POOL_MAX_THREADS=20与每秒20并发用户的场景不匹配，易导致请求排队积压：

• 结合KC_HTTP_MAX_QUEUED_REQUESTS=500，线程池占满后请求进入队列，若处理不及时会触发连接超时，进而出现closedChannelException
• 监控请求排队时长指标，若等待时间持续增加，说明线程池容量不足

3. Infinispan缓存异常 #

Keycloak依赖Infinispan处理会话、令牌缓存，即使日志级别为INFO，仍可能存在缓存问题：

• 检查缓存命中率：若命中率过低，会导致频繁回源数据库，拖慢整体性能
• 验证缓存配置：非集群场景是否启用本地缓存，集群模式下缓存同步策略是否过于保守
• 排查缓存泄漏：会话、令牌是否未及时过期，导致缓存占用过高间接影响性能

4. 网络与连接超时 #

closedChannelException和IOException多与连接中断相关：

• 检查反向代理超时设置：是否代理端提前关闭未完成的请求连接
• 验证Keycloak的HTTP超时配置：是否存在请求处理超时未合理设置，导致连接被强制关闭
• 排查Pod网络状态：是否存在网络丢包或延迟增加，即使CPU内存正常，网络问题也会触发IO异常

二、推荐配置调整 #

针对当前场景，建议调整以下配置参数：

# 数据库连接池：预留缓冲空间，适配数据库处理能力
KC_DB_POOL_INITIAL_SIZE : 25
KC_DB_POOL_MAX_SIZE : 40
KC_DB_POOL_MIN_SIZE : 20

# HTTP线程池：匹配并发负载，减少排队积压
KC_HTTP_POOL_MAX_THREADS: 40
KC_HTTP_POOL_MIN_THREADS: 10

# 缓存优化：非集群场景启用本地缓存提升性能
KC_CACHE_STACK : local
KC_CACHE_TYPE : local

# 超时配置：避免连接过早关闭
KC_HTTP_CONNECTION_TIMEOUT : 30000
KC_HTTP_SOCKET_TIMEOUT : 60000

# 日志调试：增加缓存、连接池的DEBUG日志，便于定位问题
KC_LOG_LEVEL : INFO,org.infinispan:DEBUG,org.jgroups:DEBUG,com.zaxxer.hikari:DEBUG

三、额外排查动作 #

• 抓取性能衰退阶段的线程dump：排查是否存在线程阻塞（如数据库连接等待、锁竞争）
• 分析数据库慢查询日志：定位令牌生成流程中的耗时SQL
• 监控Keycloak内置指标：通过Prometheus+Grafana查看keycloak_requests_total、keycloak_db_connections_used、infinispan_cache_hits_total等关键指标

内容的提问来源于stack exchange，提问作者Jafar Sadik