部署JNLP应用时遭遇ClassNotFoundException问题求助

Hey there, let's work through this ClassNotFoundException issue with your JNLP-deployed Maven app. I’ve gone through your project structure and here are the most likely fixes to check step by step:

1. 确认JNLP文件的Jar引用与实际构建产物匹配 #

首先打开你的myjnlp.jnlp，找到类似这样的Jar引用标签：

<jar href="myjar.jar" main="true" />

要注意两个关键点：

• 确保href指向的Jar文件名和Maven构建后生成的Jar完全一致。Maven默认生成的Jar格式是${project.artifactId}-${project.version}.jar，除非你在pom.xml里自定义了打包名称。
• 验证myjar.jar里确实包含目标类。可以用命令jar tf myjar.jar查看Jar内的目录结构，确认folder/to/my/project/ClassWithMain.class存在。

2. 检查Maven构建是否正确打包所有类 #

你的src/main/java下的类会被Maven编译到target/classes，但如果打包插件配置有问题，可能会漏打包：

• 确保pom.xml里的maven-jar-plugin配置正确，尤其是主类和Manifest文件的引用：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <version>3.3.0</version>
    <configuration>
        <archive>
            <manifestFile>src/main/jnlp/mymanifest.txt</manifestFile>
            <manifest>
                <mainClass>folder.to.my.project.ClassWithMain</mainClass>
            </manifest>
        </archive>
    </configuration>
</plugin>

• 不要用src/main/jnlp里手动放置的myjar.jar！运行mvn clean package后，应该把target目录下生成的完整Jar复制到JNLP部署目录，手动放置的Jar很可能缺少编译后的类。

3. 验证JNLP的codebase配置 #

JNLP文件的<jnlp>标签中codebase属性必须精准指向Jar和JNLP文件所在的服务器路径：

<jnlp spec="1.0+" codebase="http://your-server-domain/jnlp-deploy-folder" href="myjnlp.jnlp">

如果codebase配置错误，客户端会找不到Jar文件，间接抛出ClassNotFoundException。

4. 检查Jar签名的有效性（如果启用了签名） #

你项目里有keystore文件，说明你可能对Jar做了签名：

• 用命令jarsigner -verify myjar.jar验证签名是否有效
• 如果Jar签名后被修改过（比如重新打包但没重新签名），客户端会拒绝加载Jar，也会触发类找不到的错误

5. 确认HTML页面的JNLP链接路径 #

打开pageToLaunchJnlp.html，确保链接正确指向JNLP文件：

<a href="myjnlp.jnlp">Launch Application</a>

如果链接路径错误，客户端下载的JNLP文件会引用错误的Jar路径，导致类加载失败。

最后建议先做本地测试：把构建好的Jar、JNLP和HTML放在同一个本地目录，用浏览器打开HTML点击启动链接，排除服务器路径配置的干扰。

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