配置Keycloak以处理MySQL连接超时问题

我之前碰到过一模一样的场景——用托管MySQL服务没法改数据库的空闲超时配置，结果Keycloak复用被MySQL关掉的连接时各种报错。确实，Keycloak官方文档里没把这些细节写全，但因为它底层是基于Quarkus的，所以我们可以通过Quarkus的JDBC数据源配置来解决这个问题，亲测有效。

核心思路就是让Keycloak的连接池主动管理连接生命周期，在MySQL关闭连接前就把旧连接换掉，同时在复用连接前先校验有效性。具体可以通过以下几个配置项实现：

• quarkus.datasource.jdbc.max-lifetime：设置连接的最大存活时间，这个值必须小于MySQL的wait_timeout（托管服务一般默认8小时），比如设成7小时（25200S）。这样Keycloak会在连接被MySQL标记为失效前主动丢弃并新建，从根源避免复用过期连接。
• quarkus.datasource.jdbc.validation-query：配置一个轻量的校验查询，比如SELECT 1。连接池在复用闲置连接前会先执行这个查询，如果连接已经失效（比如被MySQL关闭），就自动新建一个可用连接。
• quarkus.datasource.jdbc.validation-query-timeout：给校验查询设置超时时间，比如5S，避免校验过程卡住拖慢请求。
• quarkus.datasource.jdbc.idle-timeout：设置空闲连接的超时回收时间，建议比MySQL的空闲超时短，比如设成30分钟（1800S），让池子里的闲置连接在被MySQL关闭前就被清理掉。

接下来看怎么把这些配置应用到Keycloak：

1. 容器部署（Docker/K8s等） #

直接通过环境变量传递配置，比如启动Docker容器时：

docker run -d \
  -e KEYCLOAK_ADMIN=admin \
  -e KEYCLOAK_ADMIN_PASSWORD=admin \
  -e QUARKUS_DATASOURCE_JDBC_MAX_LIFETIME=25200S \
  -e QUARKUS_DATASOURCE_JDBC_VALIDATION_QUERY="SELECT 1" \
  -e QUARKUS_DATASOURCE_JDBC_VALIDATION_QUERY_TIMEOUT=5S \
  -e QUARKUS_DATASOURCE_JDBC_IDLE_TIMEOUT=1800S \
  quay.io/keycloak/keycloak:latest start-dev

2. 使用配置文件（Keycloak 17+） #

如果是用keycloak.conf配置文件，直接在文件里添加以下内容：

quarkus.datasource.jdbc.max-lifetime=25200S
quarkus.datasource.jdbc.validation-query=SELECT 1
quarkus.datasource.jdbc.validation-query-timeout=5S
quarkus.datasource.jdbc.idle-timeout=1800S

如果不确定MySQL的具体超时时间，可以先通过SQL查询确认：

SHOW VARIABLES LIKE '%timeout';

找到wait_timeout和interactive_timeout的值，然后把max-lifetime设为比它们小30分钟到1小时的时间，留足够的缓冲空间。

备注：内容来源于stack exchange，提问作者DurandA