JDK11/17下sun.misc缺失时Chronicle Jars使用及WildFly部署问题

问题根源 #

你遇到的java.lang.NoClassDefFoundError: sun.misc.SignalHandler，是因为旧版本Chronicle库依赖了JDK内部API sun.misc.SignalHandler——这个API在JDK 9引入模块化后被标记为非公开，JDK 11及以上版本中被彻底移除或限制访问，因此在JDK 17环境下无法加载该类。

适配JDK 11/17的解决方案 #

1. 升级Chronicle库到兼容版本（推荐） #

Chronicle官方早已推出适配JDK 9+的版本，这些版本已替换掉对sun.misc内部API的依赖，改用JDK官方标准API（比如Runtime.addShutdownHook或JDK 14+的java.lang.ProcessHandle相关API）。

• 针对Chronicle Queue、Chronicle Bytes等核心子项目，直接升级到5.x及以上版本（以Maven依赖为例）：

  <dependency>
      <groupId>net.openhft</groupId>
      <artifactId>chronicle-queue</artifactId>
      <version>5.25.22</version> <!-- 建议使用Maven中央仓库的最新稳定版 -->
  </dependency>
  

• 注意：如果使用了Chronicle的其他子模块（如Chronicle Threads、Chronicle Wire），需同步升级到对应兼容版本，避免版本冲突。

2. 临时应急：通过JVM参数开放内部API（不推荐） #

如果暂时无法升级库版本，可尝试通过JVM参数强制开放sun.misc包的访问权限，但该方式仅在JDK 9-11中有效，JDK 17中可能失效或被严格限制：

• 在WildFly的启动配置文件中添加参数：
  • Linux环境：修改standalone.conf，在JAVA_OPTS中追加：

    JAVA_OPTS="$JAVA_OPTS --add-exports java.base/sun.misc=ALL-UNNAMED"
    

  • Windows环境：修改standalone.conf.bat，在set JAVA_OPTS=后追加：

    set JAVA_OPTS=%JAVA_OPTS% --add-exports java.base/sun.misc=ALL-UNNAMED
    

• 警告：这种方式属于绕过JDK封装机制的临时方案，后续JDK版本可能彻底禁用该参数，存在兼容性风险，仅作为过渡手段使用。

3. 检查WildFly类加载配置 #

确保Chronicle的JAR包被正确部署：

• 若为WAR包内置依赖，确认JAR文件存在于WEB-INF/lib目录下，避免打包时遗漏；
• 若为WildFly全局模块，需在模块的module.xml中正确声明依赖，并确保JVM参数的导出配置能作用到该模块的类加载器。

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