WebDriverManager项目中的NumberFormatException异常分析与解决方案

在使用WebDriverManager进行浏览器自动化测试时，开发者可能会遇到一个特定的异常情况：io.github.bonigarcia.wdm.config.WebDriverManagerException: java.lang.NumberFormatException: For input string: "public"。这个错误通常出现在远程Jenkins环境中，而本地环境却能正常运行。

异常现象分析

该异常表现为WebDriverManager在尝试解析某个字符串为数字时失败，具体是遇到了"public"这个无法转换为数字的字符串。这种情况多发生在以下环境配置下：

• Chrome浏览器版本：122.0.6261.70（64位官方版本）
• WebDriverManager版本：5.7.0
• Selenium Java版本：3.141.59

根本原因

这种异常通常与WebDriverManager的缓存机制有关。当WebDriverManager尝试从远程仓库下载或验证浏览器驱动时，可能会因为缓存中的某些元数据损坏或不完整而导致解析错误。特别是当环境从本地迁移到远程Jenkins环境时，由于环境差异，缓存问题更容易显现。

解决方案

针对这个问题，WebDriverManager的维护者提供了明确的解决方案：

1. 确保使用最新版本：确认使用的是WebDriverManager 5.7.0或更高版本。

2. 清理驱动缓存：在执行WebDriverManager设置前，显式调用清除缓存的方法。这可以通过以下代码实现：

WebDriverManager.chromedriver().clearDriverCache().setup();

这个方法链式调用首先清除可能损坏的缓存，然后再进行正常的驱动设置。

最佳实践建议

1. 环境一致性：尽量保持开发环境和CI/CD环境的一致性，包括浏览器版本和WebDriverManager配置。

2. 异常诊断：当遇到类似问题时，应该收集完整的WebDriverManager日志，这有助于更准确地定位问题根源。

3. 版本兼容性：虽然Selenium 3.141.59与WebDriverManager 5.7.0可以配合使用，但考虑升级到Selenium 4.x系列可能获得更好的兼容性和新特性。

4. 缓存管理：在CI/CD流水线中，特别是使用容器或临时环境时，考虑在每次执行前清理缓存，以避免跨构建的缓存污染。

通过以上措施，开发者可以有效解决这个特定的NumberFormatException异常，确保自动化测试在本地和远程环境中都能稳定运行。