KeyCloak调用/userinfo接口偶发连接超时问题排查咨询

1. KeyCloak是否存在连接限制？ #

KeyCloak 17.0.1（基于Quarkus）确实存在默认的连接及资源限制，主要涉及以下维度：

• Undertow Web服务器限制：默认对并发请求数、请求队列大小设有限值，当请求量超出阈值时，新请求会进入排队等待或被直接拒绝，最终表现为客户端侧的连接超时。可通过quarkus.http.limits.max-active-requests、quarkus.http.limits.max-queued-requests参数调整阈值。
• Quarkus工作线程池限制：处理请求的线程池有默认核心线程数与最大线程数，若突发请求耗尽所有线程，后续请求会等待线程释放，进而引发超时。相关配置参数为quarkus.thread-pool.core-threads、quarkus.thread-pool.max-threads。
• 用户存储层资源限制：/userinfo接口需拉取用户信息，若使用数据库作为用户存储，HikariCP连接池默认大小不足会导致查询等待，间接引发接口超时；若对接LDAP，LDAP服务器的连接限制也可能影响接口响应。
• 可选的速率限制：KeyCloak默认未对OAuth2端点强制限速，但如果部署时配置了keycloak.limits相关参数（如针对特定客户端的请求频率限制），也可能触发超时或请求拒绝。

2. 可开启的额外日志配置 #

KeyCloak服务器端 #

• Undertow访问与连接日志：追踪请求全生命周期，包括连接建立时长、处理耗时、响应状态。在application.properties中添加：

  quarkus.http.access-log.enabled=true
  quarkus.http.access-log.pattern=%h %l %u %t "%r" %s %b %D
  

  其中%D记录请求处理总耗时（毫秒），可快速定位慢请求。
• HTTP客户端内部调用日志：若KeyCloak需调用外部服务（如用户存储），开启客户端日志排查内部请求延迟：

  quarkus.log.category."org.jboss.resteasy.reactive.client".level=DEBUG
  quarkus.log.category."io.quarkus.http.client".level=DEBUG
  

• 线程池状态日志：监控线程池的线程占用、队列等待情况，判断是否存在线程耗尽：

  quarkus.log.category."io.quarkus.threadpool".level=DEBUG
  quarkus.log.category."org.jboss.threads".level=DEBUG
  

• 用户存储层日志：若/userinfo依赖数据库查询，开启JDBC日志排查慢查询：

  quarkus.log.category."org.hibernate.SQL".level=DEBUG
  quarkus.log.category."org.hibernate.type.descriptor.sql".level=TRACE
  

客户端应用端 #

• 开启HTTP请求详细日志，记录与KeyCloak通信的连接建立、请求发送、响应接收全流程耗时及异常信息。以Spring Boot为例：

  logging.level.org.springframework.web.client.RestTemplate=DEBUG
  logging.level.okhttp3=DEBUG
  

• 记录客户端自身连接池状态（如活跃连接数、空闲连接数、等待队列长度），排查是否因客户端连接池耗尽导致超时。

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