GitLab流水线中Oracle TestContainer启动失败求助

针对本地测试正常、GitLab流水线（新Runner开启Enhanced Container Isolation）下Oracle容器启动失败的问题，以下是实际可落地的解决方向：

• 调整共享内存配置
  Oracle数据库容器需要足够的共享内存才能启动，Enhanced Isolation模式下默认的shm-size往往不足。可以从两个层面配置：

  1. 在GitLab CI的docker:dind服务中指定更大的共享内存：

     services:
       - name: docker:28.3.0-dind
         command: ["--shm-size=2g"]
     

  2. 通过Testcontainers代码直接给Oracle容器设置shm-size：

     @Container
     public static OracleContainer oracle = new OracleContainer("gvenzl/oracle-free:latest")
         .withCreateContainerCmdModifier(cmd -> cmd.withHostConfig(
             new HostConfig().withShmSize(2147483648L) // 分配2GB共享内存
         ));
     

• 优化镜像与依赖版本
  当前使用的Testcontainers Oracle依赖版本（1.20.1）和对应的Oracle镜像可能在Alpine+Enhanced Isolation环境下存在兼容性问题：

  1. 更新Testcontainers Oracle依赖到最新稳定版，比如1.20.3：

     testImplementation "org.testcontainers:oracle-free:1.20.3"
     

  2. 切换到gvenzl维护的Oracle Free镜像（Testcontainers底层默认使用该镜像），指定更稳定的版本，比如gvenzl/oracle-free:23.5-full，避免精简版镜像的潜在问题。

• 调整Runner的隔离配置
  确保GitLab Runner的配置满足Oracle容器的运行要求：

  • 必须开启privileged模式（DinD服务运行的必要条件）
  • 检查是否有security_opt限制了系统调用，可尝试添加--security-opt seccomp=unconfined来放宽限制
  • 给Runner分配足够的内存资源（建议至少4GB），Oracle数据库启动对内存需求较高

• 更换Gradle基础镜像
  当前使用的gradle:8.14-jdk21-alpine基于Alpine Linux，使用musl libc，而Oracle数据库依赖glibc，可能存在系统调用兼容性问题。换成基于Debian的非Alpine版Gradle镜像：

  image: gradle:8.14-jdk21
  

• 尝试主机网络模式（可选）
  如果流水线环境允许，给Oracle容器使用主机网络模式，减少隔离层带来的资源限制：

  @Container
  public static OracleContainer oracle = new OracleContainer("gvenzl/oracle-free:23.5-full")
      .withNetworkMode("host");
  

  注意：需确保流水线环境中1521端口未被占用，避免端口冲突。

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