启用preview特性后Keycloak无法启动及策略不显示问题求助

一、Helm部署下安全启用Preview特性，避免Pod崩溃 #

直接手动执行./bin/kc.sh start --features=preview在Helm集群环境下容易因为配置不兼容、资源不足或参数传递错误导致Pod崩溃，正确的做法是通过Helm配置文件统一传递参数：

• 通过values.yaml配置启动参数
  编辑Helm部署的values.yaml文件，通过command和args字段指定完整启动命令，或者利用官方chart的extraArgs字段：

  # 方式1：指定完整命令
  command:
    - "/opt/keycloak/bin/kc.sh"
  args:
    - "start"
    - "--features=preview"
    - "--optimized" # 生产环境建议添加，优化启动性能和资源占用
  
  # 方式2：使用官方chart的extraArgs（推荐，更简洁）
  extraArgs:
    - "--features=preview"
  

• 确认Keycloak版本兼容性
  Preview特性在Keycloak 21及以上版本稳定性更好，旧版本可能存在特性冲突导致崩溃，建议升级到21+版本。
• 调整Pod资源限制
  启用Preview特性会增加Keycloak的资源消耗，确保values.yaml中配置了足够的CPU和内存：

  resources:
    requests:
      cpu: "500m"
      memory: "1Gi"
    limits:
      cpu: "1"
      memory: "2Gi"
  

• 排查崩溃根源
  执行kubectl logs <keycloak-pod-name>查看Pod日志，常见原因包括数据库连接失败、权限不足、配置文件错误，根据日志提示针对性修复。

二、自定义JavaScript策略不显示的解决步骤 #

启用preview特性后仍看不到JavaScript策略，可按以下步骤排查：

• 确认子特性已开启
  部分Keycloak版本中，JavaScript策略需要显式开启子特性，尝试将启动参数改为：

  --features=preview,script
  

  （部分版本参数为--features=preview,javascript-policy，可参考对应版本官方文档）
• 检查UI的正确路径
  JavaScript策略不在全局Policies列表中，需要进入具体客户端的授权配置页：
  1. 登录Keycloak控制台，选择目标Realm
  2. 进入「Clients」，选中需要配置授权的客户端
  3. 切换到「Authorization」标签页
  4. 点击「Policies」->「Create Policy」，此时就能看到「JavaScript」选项
• 清除浏览器缓存
  浏览器缓存可能导致UI未更新，强制刷新页面（Ctrl+F5）后重试。
• 确认Realm授权功能已启用
  进入Realm的「Realm Settings」->「Features」，确保「Authorization」选项已勾选。

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