如何在Kubernetes上的Quarkus版Keycloak中设置空闲连接超时

1. 在Kubernetes中通过环境变量设置quarkus.datasource.jdbc.idle-removal-interval #

Quarkus支持将配置参数转换为环境变量，转换规则为：

• 将参数名的点（.）替换为下划线（_）
• 所有字母转为大写
• 添加前缀QUARKUS_

因此quarkus.datasource.jdbc.idle-removal-interval对应的环境变量是QUARKUS_DATASOURCE_JDBC_IDLE_REMOVAL_INTERVAL。你可以在Kubernetes Deployment的容器env字段中添加该变量，值采用ISO-8601时长格式（例如PT1M表示1分钟，PT30S表示30秒）：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: keycloak
spec:
  template:
    spec:
      containers:
      - name: keycloak
        image: quay.io/keycloak/keycloak:22.0.4
        env:
          # 其他必要环境变量（如数据库连接信息、管理员账号等）
          - name: QUARKUS_DATASOURCE_JDBC_IDLE_REMOVAL_INTERVAL
            value: "PT1M"
          - name: QUARKUS_DATASOURCE_JDBC_MAX_IDLE_TIME
            value: "PT4M" # 配合清理间隔，设置连接空闲4分钟后被移除

2. 该参数是否生效？ #

完全生效。quarkus.datasource.jdbc.idle-removal-interval是Quarkus数据源的标准配置，用于控制连接池清理空闲连接的检查频率——它指定连接池每隔多久执行一次扫描任务，移除超过max-idle-time阈值的空闲连接。

Keycloak 22.0.4基于Quarkus构建，完全继承其数据源配置体系，只要环境变量设置正确，启动时会自动加载到默认的HikariCP连接池配置中。你可以通过Keycloak启动日志验证：搜索包含HikariPool的条目，会看到housekeepingIntervalMillis参数值（对应你设置的清理间隔，例如PT1M会转为60000毫秒）。

3. 数据库连接管理经验与建议 #

对齐数据库端的空闲清理策略 #

你目前数据库每5分钟清理空闲连接，建议应用端quarkus.datasource.jdbc.max-idle-time设置为比数据库超时短30-60秒（比如4分钟），避免数据库先断开连接，导致应用拿到失效连接引发异常。

优化其他核心连接池参数 #

• quarkus.datasource.jdbc.max-pool-size：根据Keycloak并发请求量调整，避免连接池过大占用过多数据库资源；
• quarkus.datasource.jdbc.min-pool-size：建议设为0或较小值，防止保留大量闲置连接浪费资源；
• quarkus.datasource.jdbc.max-lifetime：设置连接最大存活时间（例如PT30M），防止连接长期存活被数据库强制回收。

监控连接池状态 #

开启Quarkus Metrics功能（通过QUARKUS_METRICS_ENABLED=true环境变量），暴露HikariCP的连接池指标（如hikaricp_connections_active、hikaricp_connections_idle），结合Prometheus+Grafana监控连接池运行状态，根据实际负载动态调整配置。

验证配置效果 #

部署完成后可通过以下方式确认配置生效：

• 查看Keycloak启动日志中的HikariCP配置条目，确认参数已正确加载；
• 模拟低负载场景，观察数据库端空闲连接数量是否随时间减少；
• 通过kubectl exec进入容器，若开启JMX可直接查看HikariCP实时连接状态。

内容的提问来源于stack exchange，提问作者Ehsan Moradi