KeyCloak 19.0.1管理控制台加载卡顿求助（Windows Server 2019环境）

以下是针对Windows环境的可行解决步骤：

1. 修改KeyCloak配置调整Cookie属性 #

找到KeyCloak安装目录下的conf/keycloak.conf文件，添加或修改以下配置项：

# 设置Cookie的SameSite属性为Lax（适配大多数浏览器）
spi-login-protocol-openid-connect-cookie-same-site=Lax

# 若需跨域访问，可设置为None（需确保HTTPS的secure属性开启）
# spi-login-protocol-openid-connect-cookie-same-site=None
# spi-login-protocol-openid-connect-cookie-secure=true

修改后重启KeyCloak服务。

2. 禁用第三方iframe检查 #

通过启动参数关闭第三方检查功能，适合内部测试环境：

• 打开命令提示符，进入KeyCloak安装目录的bin文件夹
• 执行启动命令时添加参数：

kc.bat start --spi-login-protocol-openid-connect-third-party-check-enabled=false

若KeyCloak已注册为Windows服务，需修改服务启动脚本，将上述参数加入启动命令中。

3. 信任自签名SSL证书（若使用自签证书） #

HTTPS访问localhost时，浏览器可能因不信任自签证书导致iframe加载失败：

• 在Chrome中访问https://localhost:8443，点击地址栏锁图标，选择「证书」
• 进入「详细信息」标签，点击「复制到文件」，按向导将证书导出为Base64编码的X.509格式
• 打开Windows「管理用户证书」，将导出的证书导入「受信任的根证书颁发机构」目录
• 重启浏览器后再次尝试访问管理控制台

4. 临时调整浏览器第三方Cookie设置（仅测试用） #

• 打开Chrome，输入chrome://settings/cookies
• 启用「允许所有Cookie」，或添加https://localhost:8443到「允许的网站」列表
• 刷新KeyCloak页面，测试是否能进入管理控制台

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