Keycloak 22+Quarkus环境下Vert.x消息截断及HTTP 302错误求助

一、Vert.x message error: message truncated due to size 问题解决 #

原因：Quarkus/Vert.x默认对日志消息长度、HTTP请求/响应大小设有限制，超出上限后会截断内容。

解决步骤：

• 调整日志消息截断长度：在application.properties中添加或修改配置，增大日志消息的最大长度：

  # 全局日志消息最大长度（单位：字符）
  quarkus.log.max-length=20480
  # 针对Vert.x相关日志的单独配置
  quarkus.log.category."io.vertx".max-length=20480
  

• 调整HTTP请求/响应大小限制：如果是请求或响应体过大导致的截断，添加以下Vert.x HTTP配置：

  # 最大请求体大小（单位：字节，示例为10MB）
  quarkus.vertx.http.max-body-size=10485760
  # 最大分块大小（单位：字节，示例为1MB）
  quarkus.vertx.http.max-chunk-size=1048576
  

二、IdentityBrokerService的HTTP 302 Found异常问题解决 #

从堆栈信息来看，异常发生在身份代理流程的parseSessionCode阶段，通常和第三方身份提供商（IDP）的回调处理、会话配置有关。

解决步骤：

• 检查第三方IDP的回调URL配置：确保Keycloak中配置的身份提供商回调URL与第三方IDP侧的配置完全一致。正确格式为https://<your-keycloak-domain>/realms/<your-realm>/broker/<provider-id>/endpoint。
• 调整Keycloak会话超时设置：如果是认证流程中会话过期触发的异常，增大会话超时时间：

  # SSO会话超时时间（单位：秒，示例为1小时）
  quarkus.keycloak.session.sso-timeout=3600
  # SSO会话空闲超时时间（单位：秒，示例为30分钟）
  quarkus.keycloak.session.sso-idle-timeout=1800
  

  也可在Keycloak管理控制台的「领域设置」→「会话」中可视化调整。
• 检查反向代理配置：若Keycloak部署在反向代理（如Nginx）之后，确保代理正确传递请求头：
  • Nginx需添加proxy_set_header Host $host;和proxy_set_header X-Forwarded-For $remote_addr;
  • 在Keycloak配置中指定前端URL：

    quarkus.keycloak.frontend-url=https://<your-public-keycloak-domain>
    

额外提示 #

优先解决日志截断问题，获取完整的错误堆栈信息，能更精准定位302异常的具体触发原因。

内容的提问来源于stack exchange，提问作者Web Live Video Systems