Awaitility项目中的Java版本检测机制问题分析与解决方案

问题背景

在Java测试工具Awaitility中，存在一个Java版本检测机制的问题。当运行在Temurin JDK 23早期访问版(EA)或其他带有版本后缀(如"-beta"或"-ea")的JDK上时，JavaVersionDetector类会抛出NumberFormatException异常。这个问题源于版本字符串解析逻辑的不足，无法正确处理带有特殊后缀的Java版本字符串。

技术细节分析

当前Awaitility的Java版本检测实现主要依赖解析"java.version"系统属性。核心代码如下：

public static int getJavaMajorVersion() {
    String version = System.getProperty("java.version");
    if(version.startsWith("1.")) {
        return Integer.parseInt(version.substring(2, 3));
    } else {
        return Integer.parseInt(version.substring(0, version.indexOf('.')));
    }
}

这种实现方式存在两个主要问题：

1. 假设版本字符串要么以"1."开头(Java 8及以下)，要么是简单的数字加点号(如"9.0"、"11.0"等)
2. 无法处理现代JDK版本中可能出现的各种后缀格式，如"23-beta"、"17-ea"等

影响范围

这个问题会影响所有使用Awaitility并运行在以下环境的项目：

• JDK 23早期访问版(如23-beta)
• 其他带有特殊版本后缀的JDK(如17-ea)
• 未来可能出现的任何非标准版本格式的JDK

解决方案建议

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

方案一：使用Runtime.Version API(推荐)

对于Java 9及以上版本，可以使用标准的Runtime.Version API来获取准确的版本信息：

public static int getJavaMajorVersion() {
    Runtime.Version version = Runtime.version();
    return version.feature();
}

这种方法：

• 是官方推荐的版本检测方式
• 无需手动解析字符串
• 能够正确处理所有标准和非标准版本格式

方案二：增强字符串解析逻辑

如果必须保持对Java 8的支持，可以增强现有的字符串解析逻辑：

public static int getJavaMajorVersion() {
    String version = System.getProperty("java.version");
    if(version.startsWith("1.")) {
        return Integer.parseInt(version.substring(2, 3));
    } else {
        // 处理带有非数字后缀的情况
        String numPart = version.split("[^0-9]")[0];
        return Integer.parseInt(numPart);
    }
}

方案三：版本兼容性处理

可以结合两种方法，根据运行环境选择最佳方案：

public static int getJavaMajorVersion() {
    try {
        // 尝试使用现代API
        Runtime.Version version = Runtime.version();
        return version.feature();
    } catch (NoSuchMethodError e) {
        // 回退到传统方法
        String version = System.getProperty("java.version");
        // ...传统解析逻辑
    }
}

实施建议

1. 如果项目已经要求Java 11+，强烈建议采用方案一
2. 如果需要保持对Java 8的支持，可以采用方案三
3. 在任何情况下都应避免使用简单的字符串解析(当前实现)

总结

Java版本检测是一个看似简单但实际上容易出错的功能。随着JDK发布节奏的变化和版本号格式的演进，传统的字符串解析方法变得越来越不可靠。Awaitility项目中的这个问题提醒我们，在处理Java版本检测时，应该优先使用标准API，其次是健壮的解析逻辑，而不是简单的字符串处理。

对于测试工具这类基础设施项目，保持对各种JDK版本的兼容性尤为重要。采用本文推荐的解决方案可以确保Awaitility在各种Java环境下都能正确工作，包括当前和未来的JDK版本。