GitLab Pipeline构建Gradle Java应用：嵌入式MongoDB Bean创建失败求助

我之前在GitLab Pipeline里跑带嵌入式Mongo的Spring Boot测试时，也碰到过一模一样的BeanCreationException报错，结合你的场景（用了自己打包的Java+Mongo容器），给你梳理几个亲测有效的排查方向和解决方案：

1. 端口冲突是最常见的元凶 #

你自定义容器里已经跑了一个MongoDB实例，默认会占用27017端口，而Spring Boot的EmbeddedMongoAutoConfiguration也会默认用这个端口启动嵌入式Mongo，直接导致端口被占，启动失败。

解决办法二选一：

• 修改嵌入式Mongo的端口：在测试配置类里指定一个未被占用的端口，比如27018：

  @TestConfiguration
  public class EmbeddedMongoTestConfig {
      @Bean
      public MongoProperties mongoTestProperties() {
          MongoProperties properties = new MongoProperties();
          properties.setPort(27018);
          return properties;
      }
  }
  

• 修改容器内Mongo的端口：在GitLab CI的job启动容器时，把内部Mongo的端口映射到其他端口，比如让容器内Mongo用27019：

  docker run -d -p 27017:27019 your-custom-image:latest
  

2. 容器资源不够拖垮嵌入式Mongo #

GitLab Runner默认给容器的资源（内存、CPU）可能比较有限，嵌入式Mongo启动时需要下载二进制包、初始化数据，很容易因为资源不足卡死或启动失败。

解决办法：

• 在GitLab CI配置里给测试job加资源限制，比如分配2G内存和2核CPU：

  test-stage:
    script: ./gradlew clean test
    resources:
      limits:
        memory: 2G
        cpu: 2
  

• 提前在自定义容器里预装嵌入式Mongo的二进制包，避免测试时临时下载。比如在Dockerfile里添加对应版本的下载命令（版本要和你项目依赖的flapdoodle.embed.mongo一致）：

  RUN curl -o /tmp/mongo.tgz https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-6.0.5.tgz && \
      tar -xzf /tmp/mongo.tgz -C /opt && \
      ln -s /opt/mongodb-linux-x86_64-6.0.5/bin/mongod /usr/local/bin/
  

3. 版本不兼容导致启动失败 #

Spring Boot的自动配置默认使用的嵌入式Mongo版本，可能和你容器里装的Mongo版本，或者你的Spring Boot版本不匹配，引发兼容性问题。

解决办法：

• 在build.gradle里手动指定兼容的嵌入式Mongo版本，比如针对Spring Boot 3.x，用最新的flapdoodle版本：

  dependencies {
      testImplementation 'de.flapdoodle.embed:de.flapdoodle.embed.mongo:4.10.0'
  }
  

  可以查一下Spring Boot官方文档，确认对应版本的兼容依赖。

4. 文件权限问题阻止嵌入式Mongo写临时文件 #

嵌入式Mongo需要在临时目录创建数据文件，如果容器的运行用户没有/tmp目录的读写权限，会直接启动失败。

解决办法：

• 在Dockerfile里给/tmp目录添加全局读写权限：

  RUN chmod 777 /tmp
  

• 或者在gradle测试命令里指定一个自定义临时目录，提前在容器里创建并授权：

  ./gradlew test -Djava.io.tmpdir=/app/test-tmp
  

  对应的Dockerfile里要加：

  RUN mkdir -p /app/test-tmp && chmod 777 /app/test-tmp
  

如果以上方法都没解决，建议你把报错的完整堆栈信息贴出来，尤其是Invocation of后面的具体异常（比如BindException、IOException），这样能更精准定位问题。

内容的提问来源于stack exchange，提问作者I. Kirilov