Signal-Android项目中Mockito在Java 21下的兼容性问题分析

在Signal-Android项目的开发过程中，开发者遇到了两个单元测试失败的问题，具体表现为LatestPrioritizedSerialExecutorTest类中的execute_replacesDupes和execute_sortsInPriorityOrder测试用例执行失败。经过深入分析，发现这是由Java版本兼容性问题引起的。

问题现象

当开发者在macOS环境下使用Java 21运行Signal-Android项目的单元测试时，会遇到以下错误：

1. org.signal.core.util.concurrent.LatestPrioritizedSerialExecutorTest.execute_replacesDupes测试失败
2. org.signal.core.util.concurrent.LatestPrioritizedSerialExecutorTest.execute_sortsInPriorityOrder测试失败

错误日志显示Mockito无法正确mock测试类TestRunnable，并提示了Java版本相关的警告信息。

根本原因

这个问题源于Mockito框架在Java 21环境下的行为变化。Mockito使用字节码操作技术来实现mock功能，而Java 21引入了一些安全限制，特别是对动态加载Java代理的限制。具体表现为：

1. Java 21默认情况下会显示关于动态加载代理的警告
2. Mockito的内联mock功能在Java 21上可能无法正常工作
3. Java 21对instrumentation API的使用有更严格的限制

解决方案

针对这个问题，有以下几种解决方案：

1. 使用Java 17：这是Signal-Android项目推荐和测试过的Java版本。项目已经在Dockerfile和.tool-versions文件中明确指定了Java 17作为开发环境要求。

2. 调整Mockito配置：如果必须使用Java 21，可以尝试：

   • 添加-XX:+EnableDynamicAgentLoadingJVM参数来允许动态加载代理
   • 使用-Djdk.instrument.traceUsage参数获取更多调试信息
   • 考虑升级Mockito到最新版本，可能已经包含对Java 21的更好支持

3. 修改测试代码：重构测试用例，减少对mock功能的依赖，或者使用其他测试策略。

最佳实践建议

1. 遵循项目指定的Java版本：Signal-Android明确指定使用Java 17，这是经过充分测试的版本，可以避免类似兼容性问题。

2. 理解Mockito的限制：Mockito的某些高级功能（如内联mock）在不同Java版本上可能有不同的行为，特别是在新发布的Java版本上。

3. 关注测试环境一致性：确保开发、CI和团队成员的测试环境使用相同的Java版本，可以避免"在我机器上能运行"的问题。

4. 定期更新测试依赖：随着Java新版本的发布，及时更新Mockito等测试框架，以获得更好的兼容性支持。

总结

这个案例展示了Java版本升级可能带来的测试框架兼容性问题。对于Signal-Android项目而言，最简单的解决方案是使用项目推荐的Java 17版本。这也提醒我们，在软件开发过程中，保持开发环境与项目要求的一致性非常重要，特别是在涉及字节码操作等底层技术的场景下。