单元测试出现PersistenceUtil签名不匹配问题，求解决方案

这个错误的核心原因很明确：同一个javax.persistence包下的类来自两个不同签名的JAR文件——你的eclipselink-2.7.1.jar和javax.persistence-2.2.0.jar都包含了javax.persistence.PersistenceUtil类，而这两个JAR的签名信息不一致。

为什么Tomcat运行正常但单元测试报错？这是因为两者的类加载机制差异：

• Tomcat的WebappClassLoader会优先加载WEB-INF/lib下的类，并且有类隔离策略，通常不会同时加载两个重复的API类；
• 而单元测试使用的类加载器（比如JUnit/Surefire的类加载器）会把所有依赖JAR都加入同一个类路径，当加载到签名不一致的重复类时，就会抛出这个安全异常。Snap环境的Tomcat可能因为依赖环境更干净，没有触发重复类加载的情况。

下面是具体的解决步骤：

1. 排查并清理重复依赖 #

首先运行Maven命令查看完整的依赖树，确认是否有其他间接依赖引入了重复的javax.persistence包：

mvn dependency:tree

重点看输出中javax.persistence:javax.persistence-api的来源，确认是否除了你直接引入的版本外，还有其他依赖（比如EclipseLink自身）也引入了该包。

2. 统一JPA API依赖，排除重复类 #

EclipseLink作为JPA实现，本身会依赖JPA API，但如果它的JAR中包含了API类（这就是问题根源），我们需要排除它自带的API依赖，只保留单独的统一版本API：

修改你的POM文件，调整依赖配置如下：

<!-- JPA API - 供编译使用 -->
<dependency>
    <groupId>javax.persistence</groupId>
    <artifactId>javax.persistence-api</artifactId>
    <version>2.2.0</version>
</dependency>

<!-- EclipseLink JPA实现 - 排除自带的API依赖，避免重复 -->
<dependency>
    <groupId>org.eclipse.persistence</groupId>
    <artifactId>eclipselink</artifactId>
    <version>2.7.1</version>
    <exclusions>
        <exclusion>
            <groupId>javax.persistence</groupId>
            <artifactId>javax.persistence-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

这样配置后，只有javax.persistence-api-2.2.0.jar会提供JPA API类，EclipseLink的JAR中不会再有重复的javax.persistence包类，从根本上解决签名冲突问题。

3. 验证单元测试类加载（可选） #

如果调整依赖后仍然有问题，可以配置Maven Surefire插件，强制指定类加载顺序，让JPA API包优先加载：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.0.0-M7</version>
            <configuration>
                <classpathDependencyExcludes>
                    <!-- 确保EclipseLink不会先加载重复类 -->
                    <classpathDependencyExclude>org.eclipse.persistence:eclipselink</classpathDependencyExclude>
                </classpathDependencyExcludes>
                <additionalClasspathElements>
                    <!-- 先加载JPA API -->
                    <additionalClasspathElement>${project.basedir}/target/dependency/javax.persistence-api-2.2.0.jar</additionalClasspathElement>
                </additionalClasspathElements>
            </configuration>
        </plugin>
    </plugins>
</build>

不过通常第一步的依赖调整就可以解决问题，这一步作为兜底方案。

最后，重新运行单元测试，应该就不会再出现签名不匹配的安全异常了。

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