如何解决IcedTea-Web中JNLPClassLoader引发的重复类定义LinkageError？

你遇到的问题是：原本在Java 8 + Java Web Start环境下运行正常的应用，迁移至Java 17 + IcedTea-Web后触发以下错误：

java.lang.LinkageError: loader net.sourceforge.jnlp.runtime.JNLPClassLoader @55e1be49 attempted duplicate class definition for com.mypackage.MyClass. (com.mypackage.MyClass is in unnamed module of loader net.sourceforge.jnlp.runtime.JNLPClassLoader @55e1be49, parent loader 'bootstrap')

针对你的问题，结论如下：

IcedTea-Web的JNLPClassLoader确实存在过因竞态条件导致重复类加载的已知Bug，主要出现在多线程并发加载类的场景中。

问题根源与背景 #

• 这类Bug的核心原因是JNLPClassLoader早期版本的类加载锁机制存在缺陷：当多个线程同时请求加载同一个类时，没有正确实现同步控制，导致多个线程都进入了类的定义流程，最终触发重复类定义的LinkageError。
• Java 17的模块系统（JPMS）对类加载的校验比Java 8严格得多，原本在Java 8下可能被掩盖的竞态问题，在Java 17下会直接暴露并抛出错误。

修复与解决方案 #

• 升级IcedTea-Web版本：这类竞态条件问题在IcedTea-Web的3.x系列及以后的稳定版本中已经被修复，优先升级到最新版可以直接解决该问题。
• 优化应用类加载逻辑：如果应用中存在手动调用JNLPClassLoader加载类的代码，尽量避免在多线程环境下重复触发加载操作，或者在应用层面增加同步逻辑，确保同一类的加载请求串行执行。
• 检查JNLP配置：确认JNLP文件中没有重复声明同一个JAR包或类资源，重复的资源声明也可能导致类被多次加载。

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