你帮我看看这个文件哪里出了问题，在IJ里能运行，但打包成jar之后打开，总是报错： A JNI er...

Question

你帮我看看这个文件哪里出了问题，在IJ里能运行，但打包成jar之后打开，总是报错： A JNI error has occurred, please check your installation and try again和A Java Exception has occurred.这是pom.xml文件：

<?xml version="1.0" encoding="UTF-8"?>

text
<groupId>com.example</groupId>
<artifactId>OFDtoPDF</artifactId>
<version>1.0-SNAPSHOT</version>
<name>OFDtoPDF</name>

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <junit.version>5.10.2</junit.version>
</properties>

<dependencies>
    <!-- 保留 OFD 转 PDF 相关依赖 -->
    <dependency>
        <groupId>org.ofdrw</groupId>
        <artifactId>ofdrw-full</artifactId>
        <version>2.1.0</version>
        <exclusions>
            <exclusion>
                <groupId>org.apache.pdfbox</groupId>
                <artifactId>fontbox</artifactId>
            </exclusion>
        </exclusions>
    </dependency>

    <!-- FontBox -->
    <dependency>
        <groupId>org.apache.pdfbox</groupId>
        <artifactId>fontbox</artifactId>
        <version>2.0.24</version>
    </dependency>

    <!-- Logback -->
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-classic</artifactId>
        <version>1.4.14</version>
    </dependency>

    <!-- Apache PDFBox -->
    <dependency>
        <groupId>org.apache.pdfbox</groupId>
        <artifactId>pdfbox</artifactId>
        <version>2.0.24</version>
    </dependency>

    <!-- JUnit 依赖 -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>${junit.version}</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>${junit.version}</version>
        <scope>test</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <!-- Maven 编译插件 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.13.0</version>
            <configuration>
                <source>21</source>
                <target>21</target>
            </configuration>
        </plugin>
    </plugins>
</build>

</project>

Answer 1

这类“打包后运行报 JNI error 或 Java Exception error，但在 IDE 里能正常跑”的情况，常见原因通常有以下几种，你可以逐一排查：

1. Java 版本不匹配

你的 maven-compiler-plugin 里指定了

xml
<source>21</source>
<target>21</target>

这意味着编译出的 class 文件是 Java 21 的字节码。如果你在一台 JDK/运行环境低于 21 的机器上用 java -jar xxx.jar 启动，就会出现类似 “A JNI error has occurred” 或 “unsupported major.minor version 65” 之类的报错（有时会简化成 “A Java Exception has occurred”）。

解决办法：

要么在目标运行环境上安装 Java 21（或至少与编译版本匹配的 JRE），并通过 java -version 确认运行环境是 21 或更高。
要么把 maven-compiler-plugin 的 source/target 改成你实际运行环境的版本，比如 17、11 或 8 等（前提是代码里没有用到 21 专属的新特性）。

2. 可执行 Jar 的依赖没有打进去

如果你想要一个可执行（Executable）Jar，双击或 java -jar 即可运行，单纯用 maven-compiler-plugin 编译可能不够。因为：

这样打出来的 jar 不包含第三方库依赖，只包含自己项目的 class；
MANIFEST.MF 里通常没有配置 Main-Class 或者没有把依赖都合并打包。

因此，运行时会在找不到依赖的情况下报各种错误（有时也会显示类似 “NoClassDefFoundError”，但也可能就是 “Java Exception”）。在 IDE 里运行是因为 IDE 自动把所有依赖都加进了 classpath 里。

解决办法：

使用 maven-shade-plugin，把依赖都打到一个 “fat jar” 或 “uber jar” 里，同时指定好入口 Main-Class。

xml
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.3.0</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <!-- 请把你的主类全名写这里，比如 com.example.Main -->
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>com.example.your.MainClass</mainClass>
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

然后 mvn clean package，就会在 target 目录下生成一个带 “-shaded.jar” 后缀的可执行包。你可以直接 java -jar xxx-shaded.jar 运行。

使用 maven-assembly-plugin 或类似插件也可以实现同样的效果。关键点在于：
- 让所有依赖打到同一个 jar。
- 在 MANIFEST.MF 里声明正确的 Main-Class。

3. 没有指定 main class

即使依赖打进了 jar，如果你想 java -jar xxx.jar 直接启动，还要在打包时确保 META-INF/MANIFEST.MF 里写了 Main-Class。否则就会提示 “no main manifest attribute in xxx.jar” 或 “A Java Exception has occurred” 等。要检查你的最终 jar 包的 META-INF/MANIFEST.MF，看看是否正确：

txt
Manifest-Version: 1.0
Main-Class: com.example.your.MainClass

如果没有，就需要通过插件配置来加上（参考上面 shade 或 assembly 里对 ManifestResourceTransformer 的配置）。

4. 其他可能性（原生库或类似问题）

极少数情况下，“A JNI error has occurred” 是因为你使用的某些库需要配合原生库（如 JNI、OpenCV、ffmpeg 等），而原生库版本或路径不对。一般 PDFBox 或 OFD 相关库应该不怎么用 JNI，出问题更多是 Java 版本、依赖丢失或清单文件不对。

如果你确实有原生库依赖，就要检查是否需要放到某个指定目录，或者和你的 jar 放一起并在启动时加 -Djava.library.path=... 等，但这通常不是最常见的原因。

小结

首先检查你本地/目标机器上运行 jar 时，是否和你编译用的 Java 版本一致。
然后确认你想生成可执行 jar 的话，要用 shade 或 assembly 插件打出所有依赖，并在 MANIFEST.MF 里写明 Main-Class。
如果确保依赖都打进去了、Java 版本也一致，依旧 “JNI error”，再考虑是否有 JNI 原生库冲突之类的特殊问题。

大概率就是Java 版本不一致或没把依赖和 Main-Class 打包进去造成的。你可以先从这里排查起。

Answer 2

从你贴出来的日志和现象来看，核心问题有两点：

没有在最终的可执行 Jar 里找到 com.example.Main 这个主类（也就是 Manifest 里没有写上它，或者确实不存在该类）；
Shade 插件配置里出现了“重复定义”，导致打包过程有些混乱。

结合日志分析，你最终得到的 test-1.0-SNAPSHOT.jar 是 Shade 插件“替换”后的产物（它把 -shaded.jar 覆盖成原 jar 名），但 Manifest 里还没正确写上你要的 Main-Class。

1. 检查你的主类名称及包路径是否正确

你在报错时看到：

text
找不到或无法加载主类 com.example.Main
原因: java.lang.ClassNotFoundException: com.example.Main

这表示 Java 在打包后的 Jar 里找不到 com.example.Main。可能原因：

你的实际主类在 org.example 包下，而不是 com.example；或者包名写错、大小写不一致；
你的 com.example.Main 文件确实存在，但写成 package org.example; 或其它包名；
根本没有带有 public static void main(String[] args) 方法的类，或者类名拼写有误。

先去你项目里确认主类的全路径（注意 package），比如看你的 Main.java 文件最上面声明的 package，是否真的叫 com.example; 然后再看类名、main() 方法都是否符合规范。

2. 让 Shade 插件在 Jar 的 `META-INF/MANIFEST.MF` 中写入 Main-Class

要想 java -jar xxx.jar 能直接执行，必须在打包时加上 Main-Class 属性。最常见做法就是在 maven-shade-plugin 的 <configuration> 下添加：

xml
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.5.3</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <!-- 这里写你真正的主类全路径 -->
                        <mainClass>com.example.Main</mainClass>
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

请注意把上面的 com.example.Main 改成你实际的完整包名 + 类名。

注意“重复定义”警告

日志里提到：

[WARNING] 'build.plugins.plugin.(groupId:artifactId)' must be unique but found duplicate ...

说明你可能在 pom.xml 不同位置重复写了 <plugin> 配置。要么把多余的 maven-shade-plugin 插件声明删除，要么合并到同一个 <plugin> 里，保证只有一处定义，否则打包过程可能混乱。

3. 确认最终打包好的 Jar 里有没有 `Main-Class` 属性

把上面 shade 插件配置好后，再执行：

bash
mvn clean package

成功后，在 target 里一般会看到：

original-test-1.0-SNAPSHOT.jar（没打依赖、没改 manifest 的原始 jar）
test-1.0-SNAPSHOT.jar（shade 之后被“覆盖”成最终 jar）

你可以用以下命令检查是否有 Main-Class：

bash
jar -xf test-1.0-SNAPSHOT.jar META-INF/MANIFEST.MF
type META-INF\MANIFEST.MF

（或在任意压缩软件里打开 jar，查看 META-INF/MANIFEST.MF）

如果里面有类似：

text
Manifest-Version: 1.0
Main-Class: com.example.Main

那就说明配置成功了。

4. 如果还不行，可能是 JavaFX 的特性

你这里依赖了 javafx-controls 等 JavaFX 包，如果你写的是 JavaFX 应用，有时候直接双击 jar在某些 Windows 环境下偶尔会出现不响应（尤其是 JDK path、JavaFX 模块未在 classpath 中或需要模块化配置时）。但是你已经把 JavaFX 打到 uber jar 里了，理论上 java -jar xxx.jar 可以跑起来。如果纯双击没反应，可以先看一下系统关联或者尝试安装某个 Java 版本（如 Azul ZuluFX）来支持 JavaFX GUI 双击启动。

不过最常见的情况，还是你先确认模块路径、Java 版本一致，然后在命令行跑：

java -jar test-1.0-SNAPSHOT.jar

如果能跑起一个 JavaFX 窗口就说明 OK 了。
如果是报类似“无法识别 JavaFX”之类的错误，就要再考虑 <module> 模块化配置等问题。

总结一下你的现状

Shade 生成的 jar 名就是 test-1.0-SNAPSHOT.jar（会覆盖原 jar），所以没有 “shaded.jar” 也没问题，日志里已经写了 “Replacing ... with test-1.0-SNAPSHOT-shaded.jar”。
之所以报“找不到主类”错误，多半是因为主类名不对或你没在 <mainClass> 里填对。
先确认主类真正的包名，再把 Shade 插件配置写正确，去掉重复的 <plugin> 配置，重新 mvn clean package，看看 MANIFEST.MF 是否包含了 Main-Class 属性。
最后再在命令行里用 java -jar test-1.0-SNAPSHOT.jar 测试，确保没问题之后再试双击。

你帮我看看这个文件哪里出了问题，在IJ里能运行，但打包成jar之后打开，总是报错： A JNI er...

質問

思考

回答

1. Java 版本不匹配

2. 可执行 Jar 的依赖没有打进去

3. 没有指定 main class

4. 其他可能性（原生库或类似问题）

小结

質問

思考

回答

1. 检查你的主类名称及包路径是否正确

2. 让 Shade 插件在 Jar 的 `META-INF/MANIFEST.MF` 中写入 Main-Class

注意“重复定义”警告

3. 确认最终打包好的 Jar 里有没有 `Main-Class` 属性

4. 如果还不行，可能是 JavaFX 的特性

总结一下你的现状

このQ&Aを共有

質問

思考

回答

1. Java 版本不匹配

2. 可执行 Jar 的依赖没有打进去

3. 没有指定 main class

4. 其他可能性（原生库或类似问题）

小结

質問

思考

回答

1. 检查你的主类名称及包路径是否正确

2. 让 Shade 插件在 Jar 的 META-INF/MANIFEST.MF 中写入 Main-Class

注意“重复定义”警告

3. 确认最终打包好的 Jar 里有没有 Main-Class 属性

4. 如果还不行，可能是 JavaFX 的特性

总结一下你的现状

このQ&Aを共有

2. 让 Shade 插件在 Jar 的 `META-INF/MANIFEST.MF` 中写入 Main-Class

3. 确认最终打包好的 Jar 里有没有 `Main-Class` 属性