Docker容器中Keycloak独立服务器AWS启动忽略环境变量问题

看起来你遇到的是Keycloak在AWS Docker环境中无法读取环境变量切换MySQL数据源的问题——本地跑起来一切正常，到AWS上就失效，大概率是环境变量传递、配置加载逻辑或者AWS容器部署的特殊设置导致的，下面给你几个针对性的排查和解决方向：

1. 先确认环境变量是否真的传到了AWS容器里 #

先排除最基础的问题：你的production/local/test环境变量有没有成功注入到AWS的容器实例中。

• 登录到AWS的容器实例（比如ECS的任务节点），执行docker exec <container-id> printenv，查看目标环境变量是否存在。
• 如果不存在，检查AWS部署配置：比如ECS任务定义里的环境变量是否拼写正确；如果用了参数存储/Secrets Manager，要确认容器有读取权限，且变量映射关系没搞错。

2. 检查standalone.xml里的环境变量逻辑是否正确 #

你的standalone.xml应该是通过环境变量来动态启用对应数据源吧？比如用了类似${env.ENVIRONMENT:default}的表达式？

• 确保数据源的enabled属性逻辑正确：比如生产环境的数据源应该写<datasource ... enabled="${env.ENVIRONMENT} == 'production'">（或者对应你实际用的表达式语法）。
• 注意Keycloak版本对应的环境变量引用语法：不同版本的WildFly/Keycloak可能有细微差别，比如有些版本需要用${env:ENVIRONMENT}而非${env.ENVIRONMENT}。

3. 确认启动命令没有覆盖配置 #

有时候启动命令里的参数会直接覆盖standalone.xml的设置，比如如果AWS上的启动命令指定了-Dkeycloak.datasource.url这类参数，会直接忽略配置文件里的数据源逻辑。

• 对比本地和AWS的启动命令，确保AWS端没有硬编码数据源参数，或者参数是基于环境变量动态生成的。比如正确的启动命令应该类似：

  /opt/jboss/keycloak/bin/standalone.sh -c standalone.xml -Denv.ENVIRONMENT=$ENVIRONMENT
  

4. 排查AWS容器的权限与配置加载顺序 #

AWS容器偶尔会因为权限或配置加载顺序问题，导致环境变量或配置文件无法正常读取：

• 确保容器运行用户有读取standalone.xml的权限：本地可能用root用户，但AWS部署常使用非root用户，权限不足会导致配置解析失败。
• 检查是否有其他配置文件覆盖了standalone.xml：比如AWS部署默认用了standalone-ha.xml（高可用配置），而非你修改的standalone.xml，导致你的数据源配置没生效。

5. 改用Keycloak官方推荐的环境变量配置方式 #

其实Keycloak官方更推荐直接用环境变量配置数据源，而非手动修改standalone.xml，这种方式在不同环境下的一致性更好，也更符合Docker最佳实践：

• 直接设置以下环境变量即可自动对应MySQL数据源：

  DB_VENDOR=mysql
  DB_ADDR=<你的MySQL主机地址>
  DB_DATABASE=keycloak_${ENVIRONMENT}
  DB_USER=keycloak
  DB_PASSWORD=<你的数据库密码>
  

• 这种方式不需要修改任何配置文件，Keycloak会自动生成对应数据源，本地和AWS环境下的表现完全一致，不容易出现环境变量失效的问题。

如果还是没解决，建议拉取AWS容器的启动日志看看——Keycloak启动时会输出数据源加载的详细日志，从中能看到到底哪个数据源被启用，或者有没有环境变量读取失败的报错信息。

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