带状态的Quarkus（Keycloak 18）容器在Apple M1上启动异常求助

核心原因 #

你当前用docker commit生成的镜像基于x86架构构建，Apple M1是arm64架构，运行时依赖Rosetta 2模拟，这会导致严重的性能损耗甚至启动超时。另外docker commit本身生成的镜像层不规范，也会加剧跨架构运行的问题。

解决方案 #

1. 重构镜像构建流程，生成多架构镜像 #

抛弃docker commit的方式，改用Dockerfile+docker buildx构建支持x86/arm64的多架构镜像，步骤调整如下：

• 在Github Action流水线中，启动Keycloak容器并完成Terraform状态填充
• 将容器内的Keycloak数据目录复制到主机：

  docker cp running-container:/opt/keycloak/data ./keycloak-data
  

• 编写Dockerfile，基于官方多架构基础镜像打包数据：

  FROM quay.io/keycloak/keycloak:18.0.0
  # 复制预填充的Keycloak数据
  COPY ./keycloak-data /opt/keycloak/data
  # 预构建Keycloak（Quarkus版本需要此步骤优化启动速度）
  RUN /opt/keycloak/bin/kc.sh build
  

• 使用docker buildx构建并推送多架构镜像：

  docker buildx create --use
  docker buildx build --platform linux/amd64,linux/arm64 -t my-filled-keycloak-image --push .
  

2. M1本地运行临时优化（若无法立即重构构建流程） #

如果暂时没法调整流水线，M1用户可以通过以下参数缓解问题：

• 在Docker Desktop设置中，给容器分配至少4GB内存（Keycloak Quarkus版本本身内存需求较高，模拟运行时需要更多资源）
• 强制使用arm64架构运行（Keycloak 18官方镜像已支持arm64）：

  docker run --platform linux/arm64 -p 8080:8080 my-filled-keycloak-image
  

• 添加JVM启动参数优化性能：

  docker run -e JAVA_OPTS="-Dquarkus.thread-pool.core-threads=2 -Dquarkus.thread-pool.max-threads=8 -Dquarkus.http.access-log.enabled=false" my-filled-keycloak-image
  

3. 避免使用docker commit构建自定义镜像 #

docker commit会保留原容器的架构信息和临时运行状态，生成的镜像无法适配多架构，且启动逻辑不透明。用Dockerfile构建的镜像可以基于官方多架构基础镜像，自动生成对应架构的自定义镜像，从根源解决跨架构运行问题。

内容的提问来源于stack exchange，提问作者Ömer Genc