Selenide项目中解决Chrome 122版本文件下载问题的方法

在自动化测试过程中，文件下载功能是常见的测试场景之一。近期在使用Selenide 7.2.0配合Chrome 122版本进行测试时，开发团队遇到了文件无法正常下载的问题。本文将详细分析问题原因并提供解决方案。

问题现象

当使用Selenide的download()方法尝试下载文件时，虽然浏览器默认下载目录中能够获取到文件，但测试代码却报错"文件未找到"。检查日志发现，Selenide创建的临时下载文件夹为空，导致15秒超时后抛出异常。

根本原因分析

经过排查，问题源于测试代码中通过Configuration.browserCapabilities直接设置Chrome选项的方式。这种方式会完全覆盖Selenide的默认配置，包括关键的下载目录设置。具体来说：

1. Selenide内部会为每次下载创建临时文件夹
2. 直接设置browserCapabilities会破坏这一机制
3. Chrome 122版本对不安全下载的限制更加严格

解决方案

正确的做法是使用Selenide提供的专用方式来设置Chrome选项，而不是直接覆盖browserCapabilities。以下是推荐的配置方式：

// 正确设置Chrome选项的方法
System.setProperty("chromeoptions.prefs","credentials_enable_service=false,password_manager_enabled=false");

// 其他配置保持不变
Configuration.fileDownload = FileDownloadMode.FOLDER;

配置建议

对于Chrome浏览器的自动化测试，建议采用以下最佳实践：

1. 优先使用Selenide提供的专用属性设置方式
2. 对于Chrome特定选项，使用chromeoptions.*前缀的系统属性
3. 保持下载模式为FOLDER以利用Selenide的临时文件夹管理
4. 对于新版Chrome，可能需要添加--disable-features=InsecureDownloadWarnings参数

总结

在Selenide测试框架中，正确配置浏览器选项对于文件下载功能至关重要。通过使用框架推荐的方式设置浏览器参数，可以避免因配置覆盖导致的功能异常。特别是在Chrome浏览器版本升级后，更应注意兼容性设置，确保自动化测试的稳定性。

对于遇到类似问题的开发者，建议首先检查是否遵循了框架的配置规范，再考虑浏览器版本特定的兼容性问题。通过系统属性的方式设置浏览器参数，既能满足定制化需求，又能保留框架的核心功能。