Maven 阴影 IllegalStateException - 缺少必需的类信息答案

【问题标题】：Maven shade IllegalStateException - Required class information is missingMaven 阴影 IllegalStateException - 缺少必需的类信息
【发布时间】：2020-12-11 20:11:25
【问题描述】：

我刚刚使用 JavaFX 和 Hibernate 构建了一个应用程序，它可以在 IntelliJ 上完美构建和运行，所以我选择使用 maven shade 插件生成一个“fat-jar”，因为我使用了一些具有自动模块名称的库，所以我不能使用 jlink。

Jar 创建得很好，它正确加载了初始屏幕，但是当它尝试连接到我的数据库时，特别是这一行是有问题的 (JPAUtil.java:19);

factory = Persistence.createEntityManagerFactory(persistenceUnit, properties);

我得到以下异常；

java.lang.IllegalStateException: Required class information is missing
    at org.jboss.jandex.Indexer.rebuildNestedType(Indexer.java:926)
    at org.jboss.jandex.Indexer.resolveTypePath(Indexer.java:786)
    at org.jboss.jandex.Indexer.resolveTypeAnnotation(Indexer.java:705)
    at org.jboss.jandex.Indexer.resolveTypeAnnotations(Indexer.java:613)
    at org.jboss.jandex.Indexer.index(Indexer.java:1602)
    at org.hibernate.boot.archive.scan.spi.ClassFileArchiveEntryHandler.toClassDescriptor(ClassFileArchiveEntryHandler.java:64)
    at org.hibernate.boot.archive.scan.spi.ClassFileArchiveEntryHandler.handleEntry(ClassFileArchiveEntryHandler.java:52)
    at org.hibernate.boot.archive.internal.JarFileBasedArchiveDescriptor.visitArchive(JarFileBasedArchiveDescriptor.java:147)
    at org.hibernate.boot.archive.scan.spi.AbstractScannerImpl.scan(AbstractScannerImpl.java:48)
    at org.hibernate.boot.model.process.internal.ScanningCoordinator.coordinateScan(ScanningCoordinator.java:76)
    at org.hibernate.boot.model.process.spi.MetadataBuildingProcess.prepare(MetadataBuildingProcess.java:98)
    at org.hibernate.jpa.boot.internal.EntityManagerFactoryBuilderImpl.<init>(EntityManagerFactoryBuilderImpl.java:254)
    at org.hibernate.jpa.boot.internal.EntityManagerFactoryBuilderImpl.<init>(EntityManagerFactoryBuilderImpl.java:175)
    at org.hibernate.jpa.boot.spi.Bootstrap.getEntityManagerFactoryBuilder(Bootstrap.java:76)
    at org.hibernate.jpa.HibernatePersistenceProvider.getEntityManagerFactoryBuilder(HibernatePersistenceProvider.java:171)
    at org.hibernate.jpa.HibernatePersistenceProvider.getEntityManagerFactoryBuilderOrNull(HibernatePersistenceProvider.java:119)
    at org.hibernate.jpa.HibernatePersistenceProvider.getEntityManagerFactoryBuilderOrNull(HibernatePersistenceProvider.java:61)
    at org.hibernate.jpa.HibernatePersistenceProvider.createEntityManagerFactory(HibernatePersistenceProvider.java:50)
    at javax.persistence.Persistence.createEntityManagerFactory(Persistence.java:79)
    at com.it.util.JPAUtil.getEntityManagerFactory(JPAUtil.java:19)
    at com.it.controller.HomeController.initializeSettings(HomeController.java:1571)
    at com.it.controller.HomeController.initialize(HomeController.java:1407)
    at javafx.fxml.FXMLLoader.loadImpl(FXMLLoader.java:2573)
    at javafx.fxml.FXMLLoader.loadImpl(FXMLLoader.java:2466)
    at javafx.fxml.FXMLLoader.loadImpl(FXMLLoader.java:3237)
    at javafx.fxml.FXMLLoader.loadImpl(FXMLLoader.java:3194)
    at javafx.fxml.FXMLLoader.loadImpl(FXMLLoader.java:3163)
    at javafx.fxml.FXMLLoader.loadImpl(FXMLLoader.java:3136)
    at javafx.fxml.FXMLLoader.loadImpl(FXMLLoader.java:3113)
    at javafx.fxml.FXMLLoader.load(FXMLLoader.java:3106)
    at com.it.Home.start(Home.java:23)
    at com.sun.javafx.application.LauncherImpl.lambda$launchApplication1$9(LauncherImpl.java:846)
    at com.sun.javafx.application.PlatformImpl.lambda$runAndWait$12(PlatformImpl.java:455)
    at com.sun.javafx.application.PlatformImpl.lambda$runLater$10(PlatformImpl.java:428)
    at java.base/java.security.AccessController.doPrivileged(Native Method)
    at com.sun.javafx.application.PlatformImpl.lambda$runLater$11(PlatformImpl.java:427)
    at com.sun.glass.ui.InvokeLaterDispatcher$Future.run(InvokeLaterDispatcher.java:96)
    at com.sun.glass.ui.win.WinApplication._runLoop(Native Method)
    at com.sun.glass.ui.win.WinApplication.lambda$runLoop$3(WinApplication.java:174)
    at java.base/java.lang.Thread.run(Thread.java:834)

我知道语法是正确的，正如我在 IDE 上正确运行之前提到的那样，所以我怀疑它在 shade 生成的 jar 文件中丢失了一些东西，但是我已经花了将近 3 天的时间，我根本找不到一个原因。 stacktrace 上显示的信息没有多大帮助，至少我什么也没看到——我什至查看了 stacktrace 上提到的所有类，它们似乎都在生成的 Jar 上。希望这里的任何人都有类似的东西，或者可能比我更熟悉 Maven 阴影过程。任何帮助或观点将不胜感激。

有助于识别问题的其他文件如下；

persistence.xml - 其他属性从代码上的 XML 文件加载。

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.2" xmlns="http://xmlns.jcp.org/xml/ns/persistence" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_2.xsd">
    
    <persistence-unit name="Project-Postgre">
        <description>Hibernate JPA Configuration</description>
        <provider>org.hibernate.jpa.HibernatePersistenceProvider</provider>
    
        <properties>
            <property name="javax.persistence.jdbc.driver" value="org.postgresql.Driver" />
            <property name="hibernate.dialect" value="org.hibernate.dialect.PostgreSQLDialect"/>
            
            <property name="hibernate.show_sql" value="false" />
            <property name="hibernate.format_sql" value = "false" />
        </properties>
    </persistence-unit>
</persistence>

pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.it</groupId>
    <artifactId>Project</artifactId>
    <version>1.0</version>
    <packaging>jar</packaging>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <maven.compiler.release>11</maven.compiler.release>
        <javafx.version>14</javafx.version>
    </properties>

    <name>Project</name>

    <dependencies>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-controls</artifactId>
            <version>${javafx.version}</version>
        </dependency>
        <dependency>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-fxml</artifactId>
            <version>${javafx.version}</version>
        </dependency>
        <dependency>
            <groupId>javax.persistence</groupId>
            <artifactId>javax.persistence-api</artifactId>
            <version>2.2</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.apache.poi/poi -->
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi</artifactId>
            <version>4.1.2</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.apache.poi/poi-ooxml -->
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-ooxml</artifactId>
            <version>4.1.2</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/de.jensd/fontawesomefx -->
        <dependency>
            <groupId>de.jensd</groupId>
            <artifactId>fontawesomefx</artifactId>
            <version>8.2</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.hibernate/hibernate-core -->
        <dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-core</artifactId>
            <version>5.4.20.Final</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.postgresql/postgresql -->
        <dependency>
            <groupId>org.postgresql</groupId>
            <artifactId>postgresql</artifactId>
            <version>42.2.15</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/com.oracle.database.jdbc/ojdbc10 -->
        <dependency>
            <groupId>com.oracle.database.jdbc</groupId>
            <artifactId>ojdbc10</artifactId>
            <version>19.7.0.0</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <release>${maven.compiler.release}</release>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.openjfx</groupId>
                <artifactId>javafx-maven-plugin</artifactId>
                <version>0.0.3</version>
                <configuration>
                    <mainClass>com.it.HomeFX</mainClass>
                </configuration>
            </plugin>


            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <shadedArtifactAttached>true</shadedArtifactAttached>
                            <shadedClassifierName>project-classifier</shadedClassifierName>
                            <outputFile>target\shade\${project.artifactId}.jar</outputFile>
                            <transformers>
                                <transformer implementation=
                                                     "org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                    <mainClass>com.it.HomeFX</mainClass>
                                </transformer>
                            </transformers>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

JPAUtil

public static EntityManagerFactory getEntityManagerFactory(String persistenceUnit, String connectionURL, String user, String password) {
        if (factory == null) {
            Map<String, String> properties = new HashMap<>();
            properties.put("javax.persistence.jdbc.url", connectionURL);
            properties.put("javax.persistence.jdbc.user", user);
            properties.put("javax.persistence.jdbc.password", password);
            factory = Persistence.createEntityManagerFactory(persistenceUnit, properties);
        }
        return factory;
}

【问题讨论】：

persistence.xml 文件呢？你确定你有所有的信息吗？注意，根据你的日志，你的@Controller 不能工作，那是因为EntityManagerFactory 不能工作。
我确定一切都在那里，正如我之前提到的，该程序在 IntelliJ 上正常工作。无论如何，我也将我的 JPAUtil 类添加到原始帖子中，因此您可以从为 emf 加载的 persistence.xml 中看到所有其他内容。

标签： java maven javafx maven-shade-plugin

【解决方案1】：

我有同样的错误使用： spring.version:5.2.7.RELEASE spring.boot.version:2.3.1.RELEASE postgresql-version:42.2.16

从 42.2.15 开始的所有版本的 postgres 都会发生这种情况。 42.2.14（或更早）版本对我来说很好。

【讨论】：

【解决方案2】：

我遇到了同样的问题。我尝试将 PostgreSQL JDBC 驱动程序版本降级到 42.0.0。异常消失了，一切正常。

【讨论】：

【解决方案3】：

该问题是由javac 1.8 生成的无效字节码引起的（例如，已知 AdoptOpenJDK 1.8u222 会受到影响）。

这是问题（使用复制器）：https://github.com/wildfly/jandex/issues/92

修复方法是更新到 org.jboss:jandex:2.2.3.Final，其中包括解决方法（以及其他一些针对类型注释的修复），或者使用 Java 11 编译器 (== javac 11)。

以防万一，org.postgresql:postgresql:42.2.15 会触发问题，因为它使用the Checker Framework 表示nullness verification，并且它包含多个@Nullable 和@NonNull 注释以使验证通过。

即将推出的org.postgresql:42.2.18 和org.postgresql:42.3.0 将拥有the relevant workarounds，因此它也适用于旧的jandex 版本。

如果您正在阅读此处，我建议您将forbidden-apis 和jandex 字节码解析器（例如de.thetaphi.forbiddenapis 和com.github.vlsi.jandex Gradle 插件）添加到您的构建管道中，以便尽早捕获无效字节码（否则可能会被忽视），尤其是如果您仍然使用javac 1.8。

【讨论】：

【解决方案4】：

我已经通过从 Hibernate 切换到 OpenJPA 来克服这个问题。 Hibernate 没有提供足够的信息来调试问题，当切换到 OpenJPA 时，我只需将其添加到我的 pom.xml；

<dependency>
     <groupId>org.apache.openjpa</groupId>
     <artifactId>openjpa-all</artifactId>
     <version>3.1.2</version>
</dependency>

Shade 创建了包含所有必需库的 JAR，并且成功连接到数据库。

【讨论】：

【解决方案5】：

最终，在 PostgreSQL JDBC 驱动程序版本 42.2.19 中得到修复，请参阅 https://jdbc.postgresql.org/documentation/changelog.html#version_42.2.19。

将您的版本更新到 42.2.19 应该可以解决问题。

【讨论】：