Docker Compose启动Keycloak时如何分开导入领域与测试用户？

关键逻辑 #

Keycloak用--import-realm导入文件时，是按文件名的字典顺序加载的。之前的问题是用户文件先被读取并创建了领域，后续的领域文件因为领域已存在被跳过。所以只要让领域定义文件的文件名排在用户文件前面，就能先创建领域，再导入用户（用户文件会直接往已有的领域里添加用户，不会被跳过）。

具体解决办法 #

方法1：给文件名加数字前缀（最简单） #

直接修改两个文件的名字，用数字前缀强制控制加载顺序：

• 将my-realm.json重命名为01-my-realm.json
• 将my-realm-users.json重命名为02-my-realm-users.json

然后在Docker Compose中把这两个文件挂载到Keycloak的默认导入目录/opt/keycloak/data/import：

services:
  keycloak:
    image: quay.io/keycloak/keycloak:19.0.1
    command: start-dev --import-realm
    volumes:
      - ./01-my-realm.json:/opt/keycloak/data/import/01-my-realm.json
      - ./02-my-realm-users.json:/opt/keycloak/data/import/02-my-realm-users.json
    environment:
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=admin
    ports:
      - "8080:8080"

启动后，Keycloak会先加载01-my-realm.json创建领域，再加载02-my-realm-users.json把测试用户添加到该领域中，完美解决顺序问题。

方法2：用子目录排序（不想改文件名可选） #

如果不想修改文件名，可以通过子目录的命名顺序来控制加载优先级：

• 创建import/realm文件夹，放入my-realm.json
• 创建import/users文件夹，放入my-realm-users.json

Keycloak会递归读取导入目录，子目录的名字也参与排序，realm在users前面，因此领域文件会被优先加载。对应的Docker Compose挂载配置如下：

services:
  keycloak:
    image: quay.io/keycloak/keycloak:19.0.1
    command: start-dev --import-realm
    volumes:
      - ./import/realm:/opt/keycloak/data/import/realm
      - ./import/users:/opt/keycloak/data/import/users
    environment:
      - KEYCLOAK_ADMIN=admin
      - KEYCLOAK_ADMIN_PASSWORD=admin
    ports:
      - "8080:8080"

补充说明 #

不用怕用户文件导入时领域已存在的问题——Keycloak遇到已存在的领域，不会跳过整个文件，而是会合并更新该领域的配置，包括添加新用户，只要顺序正确，用户就能正常导入。

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