Keycloak 14.0.0（无发行版Docker镜像）恢复PostgreSQL备份后持续重启问题求助

问题原因拆解 #

首先得搞清楚为啥会出现这个报错：Keycloak启动时会自动读取/opt/jboss/keycloak/standalone/configuration/keycloak-add-user.json里的配置，尝试把文件里定义的用户导入到数据库。你遇到的问题，说明su_0317912这个用户的配置还留在这个JSON文件里，但启动时的导入逻辑和恢复后的数据库状态产生了冲突——哪怕数据库里没这个用户，只要JSON文件里有这条配置，Keycloak就会尝试执行导入，一旦检测到异常（比如之前残留的导入记录、配置和数据库元数据不匹配），就会抛出这个错误导致容器重启。

一步步解决的方案 #

1. 先让容器“停下来”，进入bash环境 #

现在容器一直在重启循环，直接docker exec肯定进不去。咱们可以临时修改启动命令，让容器启动后保持运行状态：

# 先停止当前循环的容器
docker stop <你的Keycloak容器名称>

# 基于原容器的卷，启动一个临时容器，用tail命令让它一直跑着
docker run -d --name temp-keycloak --volumes-from <你的Keycloak容器名称> <你的Keycloak镜像名> tail -f /dev/null

等临时容器启动后，就能进入bash了：

docker exec -it temp-keycloak bash

2. 清理冲突的用户配置 #

进入容器后，直接定位到那个出问题的配置文件：

cd /opt/jboss/keycloak/standalone/configuration
cat keycloak-add-user.json

你会看到里面有su_0317912的用户条目，直接删除这条记录，或者如果不需要预定义启动用户的话，干脆清空整个文件（记得备份一下原文件以防万一）。修改后保存退出。

3. 验证数据库用户状态（可选） #

如果想确认数据库里确实没这个用户，可以连接到PostgreSQL数据库查询：

# 连接到Keycloak的数据库
psql -h <你的数据库地址> -U <数据库用户名> -d <Keycloak数据库名>

# 查询Keycloak的用户表（14版本的用户表是user_entity）
SELECT username FROM user_entity;

确认没有su_0317912后，就可以继续下一步了。

4. 恢复正常启动容器 #

先删掉临时容器：

docker stop temp-keycloak
docker rm temp-keycloak

然后用原来的启动命令重新启动你的Keycloak容器：

docker start <你的Keycloak容器名称>

这时候容器应该能正常启动，不会再出现那个重复添加用户的报错了。

后续建议 #

• 备份Keycloak时，除了数据库备份，最好同步备份standalone/configuration目录，避免恢复时配置和数据库状态不匹配。
• 如果需要预定义启动用户，优先用Keycloak管理界面创建，别手动改keycloak-add-user.json，这样配置和数据库能保持同步。
• 尽量用挂载外部配置目录的方式管理Keycloak容器，别直接在容器内改配置，后续修改和备份都更方便。

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