Jenkins无法创建EntityManagerFactory，求助排查（附Spring Boot测试代码）

我来帮你捋捋Jenkins里EntityManagerFactory创建失败的常见坑，结合你贴的Spring Boot测试代码，咱们一步步排查：

首先先把你提供的测试代码格式化一下，方便后续分析：

@RunWith(SpringRunner.class) 
@SpringBootTest(classes = Application.class, webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT) 
public class exampleTests { 
    @Autowired 
    private WebApplicationContext context; 
    private MockMvc mvc; 
    private WebClient webClient; 
    @LocalServerPort 
    int port; 
    @Before 
    public void setup() { 
        this.mvc = MockMvcBuilders.webAppContextSetup(this.context).build(); 
        this.webClient = MockMvcWebClientBuilder.webAppContextSetup(con... 
    }
}

接下来是几个大概率的排查方向：

• 数据库连接配置不匹配
  本地测试正常但Jenkins里失败，首当其冲要检查Jenkins运行环境的数据库配置文件（application.properties/application.yml）。是不是数据库地址、用户名、密码和本地不一样？或者Jenkins所在服务器根本连不上数据库（比如防火墙拦截、数据库服务未启动）？你的测试用了@SpringBootTest会加载完整上下文，数据库连接失败直接会导致EntityManagerFactory初始化卡壳。

• 依赖缺失或版本冲突
  确认你的构建文件（pom.xml/gradle.build）里有没有正确引入spring-boot-starter-data-jpa这类JPA核心依赖？会不会Jenkins打包时因为仓库镜像问题拉错了依赖版本？比如Hibernate和Spring Boot版本不兼容，就会在初始化EntityManagerFactory时抛出异常。

• Jenkins环境资源不足
  EntityManagerFactory初始化需要加载大量实体类、映射配置，对JVM内存有一定要求。如果Jenkins的构建任务JVM内存分配太小（比如默认的Xmx值不够），可能会触发OOM或者初始化超时。可以试试给构建任务添加JVM参数，比如-Xmx2g来扩容。

• 测试代码的小疏漏
  看你贴的setup()方法里，MockMvcWebClientBuilder.webAppContextSetup(con...这里代码没写完，是不是变量名写错了（应该是context而不是con）？如果测试代码本身有语法错误，会导致Spring上下文加载失败，连带影响EntityManagerFactory的创建。另外你用了WebEnvironment.RANDOM_PORT，测试会启动真实的Web服务器，这时候数据库连接是真实的，一旦有问题就会直接暴露。

• 数据库权限限制
  检查一下Jenkins所在服务器的IP有没有被数据库授权访问？比如MySQL的user表有没有给对应IP的用户分配权限？或者数据库用户有没有创建表、查询数据的权限？本地用户权限够，但Jenkins用的用户权限不足，也会导致EntityManagerFactory创建失败。

建议你先去看Jenkins构建日志里的具体错误栈，比如Hibernate初始化时的报错、数据库连接异常信息，这些细节能帮你快速缩小排查范围。

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