Eclipse OpenJ9 在 Windows 2025 上的共享类库加载问题分析

问题背景

在 Eclipse OpenJ9 项目的最新测试中，发现了一个与共享类库（Shared Classes）相关的问题。具体表现为在 Windows Server 2025 操作系统上运行时，JVM 无法加载共享类库的动态链接库文件 sharedClasses.dll，错误提示为"指定的模块找不到"。

问题现象

测试用例 SharedClassesAPI_0 在执行过程中尝试通过 JVMTI 接口验证共享类缓存时失败。关键错误信息显示：

JVMJ9TI001E Agent library sharedClasses.dll could not be opened (The specified module could not be found.)
JVMJ9VM015W Initialization error for library j9jvmti29(-3): JVMJ9VM009E J9VMDllMain failed

测试环境使用的是 OpenJDK 8 与 Eclipse OpenJ9 VM 的组合，运行在 Windows Server 2025 amd64 系统上。

根本原因分析

经过调查，发现这个问题与测试环境配置有关：

1. 测试运行在一台新安装的 Windows Server 2025 机器上
2. 该机器上 Visual Studio 开发工具未正确安装或配置
3. STF（System Test Framework）框架默认指向旧版本的 Visual Studio，而新系统需要 Visual Studio 2022

解决方案

开发团队采取了以下措施解决此问题：

1. 更新 STF 框架，使其正确指向 Visual Studio 2022 的开发工具
2. 在问题机器上安装必要的 C++ 开发工具组件
3. 暂时从常规测试池中移除了 Windows 2025 机器，直到环境完全配置正确

技术细节

sharedClasses.dll 是一个通过 JVMTI 接口与 JVM 交互的本地库。它的正确加载依赖于：

1. 正确的 Visual Studio 运行时库
2. 适当的系统路径配置
3. 兼容的编译器工具链

在 Windows 系统上，这类问题通常与以下因素有关：

• 缺少必要的 Visual C++ 可再发行组件
• 编译器工具链路径未正确设置
• 32位/64位库不匹配
• 依赖的 DLL 文件缺失

经验总结

这个案例提醒我们：

1. 在新操作系统版本上运行测试前，需要确保所有开发工具链已正确安装
2. 测试框架需要及时更新以支持新的开发环境
3. 共享库加载问题通常与环境配置相关，需要系统性地检查依赖关系
4. 对于 JVMTI 代理，除了代码本身，还需要关注部署环境的兼容性

后续工作

开发团队将继续：

1. 完善 Windows 2025 测试环境的配置
2. 监控类似的环境相关问题
3. 更新文档以明确系统要求
4. 增强测试框架对环境配置的自动检测能力

这个问题虽然表现为一个简单的 DLL 加载失败，但背后反映了测试环境管理的重要性，特别是在新操作系统版本上的兼容性挑战。