OpenJDK 21运行Chronicle-Queue遇类找不到错误求助

核心原因 #

sun.nio.ch.UnixFileDispatcherImpl是JDK内部的Unix平台专属类，Java 16+对内部API的访问限制大幅收紧，且旧版本Chronicle Queue未适配Java 21的内部API变更；若在Windows环境运行，该类本身就不存在。

解决方案 #

1. 升级到适配Java 21的Chronicle Queue版本 #

必须使用支持Java 21的最新正式版/EA分支版本，例如在Maven中配置依赖：

<dependency>
    <groupId>net.openhft</groupId>
    <artifactId>chronicle-queue</artifactId>
    <version>5.25.22</version> <!-- 或更高的适配版本 -->
</dependency>

Gradle配置示例：

implementation 'net.openhft:chronicle-queue:5.25.22'

2. 补充调整JVM参数 #

在现有参数基础上，添加针对内部类访问的开放参数（仅适用于Unix/Linux/macOS环境）：

--add-opens=java.base/sun.nio.ch=ALL-UNNAMED
--add-opens=java.base/jdk.internal.misc=ALL-UNNAMED

完整JVM参数示例：

--add-exports=java.base/jdk.internal.ref=ALL-UNNAMED
--add-exports=java.base/sun.nio.ch=ALL-UNNAMED
--add-exports=jdk.unsupported/sun.misc=ALL-UNNAMED
--add-exports=jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED
--add-opens=jdk.compiler/com.sun.tools.javac=ALL-UNNAMED
--add-opens=java.base/java.lang=ALL-UNNAMED
--add-opens=java.base/java.lang.reflect=ALL-UNNAMED
--add-opens=java.base/java.io=ALL-UNNAMED
--add-opens=java.base/java.util=ALL-UNNAMED
--add-opens=java.base/sun.nio.ch=ALL-UNNAMED
--add-opens=java.base/jdk.internal.misc=ALL-UNNAMED

3. 确认运行平台 #

若在Windows系统运行，该错误必然出现——sun.nio.ch.UnixFileDispatcherImpl仅存在于Unix-like系统（Linux、macOS）中。需切换到Unix环境，或使用Chronicle Queue针对Windows的适配版本。

4. 修正测试代码路径 #

测试代码中的opt/queue是相对路径，可能引发权限或路径解析问题，建议改为绝对路径：

String basePath = "/tmp/chronicle-queue-test";

验证步骤 #

1. 确认依赖版本正确，JVM参数配置完整
2. 在Unix-like环境运行测试代码
3. 检查队列目录是否正常创建，读写操作是否成功

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