章
目
录
在使用Selenide进行开发的过程中，有时会遇到“java.lang.IllegalArgumentException: Failed to create folder”这个错误。这个错误通常出现在Selenide尝试保存截图、页面源代码或日志时，由于权限问题或路径错误，导致它无法创建所需的目录。
Selenium和Selenide主要用于浏览器UI测试，以及自动化浏览器中的工作流程。在一些业务场景下，当企业应用没有提供API来获取或更新数据时，我们可能需要开发一个桌面应用，通过在浏览器中访问网页来实现特定的业务功能。在这种情况下，Selenide是自动化浏览器工作流程的绝佳选择。不过，在运行时，Selenide需要特定的目录来存储执行过程中捕获的输出结果和截图等内容。下面我们来深入分析这个问题产生的原因和对应的解决办法。
一、问题描述
“java.lang.IllegalArgumentException: Failed to create folder”错误产生的场景，主要是Selenide在保存截图、页面源代码或日志时，无法创建必要的目录。
在开发环境（比如集成开发环境IDE）中，Selenide默认以项目根目录作为基础文件夹，并在其中创建所需的子目录。所以在开发阶段，我们通常不会遇到这个问题。
但是，当我们把应用程序打包成可安装的应用程序或exe文件进行分发时，情况就不同了。一般来说，安装后的应用程序会被放置在“c:/program files”目录下。出于安全考虑，操作系统不允许在这个目录下创建子目录。因此，当我们启动应用程序时，就会遇到“IllegalArgumentException: Failed to create folder”这个错误。例如：
2025-02-17 15:26:30 com.example.app.processor.BrowserManager ERROR [153] : An error occurred during the workflow execution: java.lang.IllegalArgumentException: Failed to create folder 'C:\Program Files\myapp\build\downloads39786190288_10940_51'
at com.codeborne.selenide.impl.FileHelper.ensureFolderExists(FileHelper.java:48) ~[myapp-1.0.0-jar-with-dependencies.jar:?]
...
...
at java.util.concurrent.Executors$RunnableAdapter.call(Unknown Source) ~[?:?]
at java.util.concurrent.FutureTask.run(Unknown Source) ~[?:?]
at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source) ~[?:?]
at java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source) ~[?:?]
at java.lang.Thread.run(Unknown Source) [?:?]
Caused by: java.nio.file.AccessDeniedException: C:\Program Files\GST IMS Tool\build
at sun.nio.fs.WindowsException.translateToIOException(Unknown Source) ~[?:?]
二、问题原因
正如前面提到的，这个错误的根源在于操作系统的安全限制，不允许Selenide在特定目录下创建文件夹。
在开发环境中，我们一般不会在受系统保护的文件夹中进行操作，所以不会出现问题。但在安装后的应用程序中，Selenide试图在系统目录下创建文件夹，这是不被允许的，从而引发了该错误。
三、解决方案
（一）停止生成执行结果
第一个解决方法比较简单直接，就是不生成所有的执行结果，包括报告、日志和截图。如果不生成这些输出内容，也就不需要创建相应的子目录了。
import com.codeborne.selenide.Configuration;
public class TestConfig {
static {
// 禁用截图捕获功能
Configuration.screenshots = false;
// 禁用保存页面源代码功能
Configuration.savePageSource = false;
// 防止存储报告（在Windows系统中，NUL相当于/dev/null，用于丢弃输出）
Configuration.reportsFolder = "NUL";
}
}
（二）配置具有写入权限的目录路径
另一种解决办法是将生成的报告和截图等内容写入到应用程序具有写入权限的目录中。
我们可以配置已存在的子目录路径，甚至在应用程序代码中直接创建这些子目录。
// 在AppConstants.Java文件中
public static final String BASE_DATA_DIR = System.getProperty("user.home") +
File.separator + "AppData" +
File.separator + "Local" +
File.separator + APP_NAME;
// 在BrowserManager.java文件中
static {
// 这里设置Web驱动，以Chrome为例
createDirectories();
}
private static void createDirectories() {
// 需要创建的目录列表
List<String> requiredDirs = Arrays.asList(
"downloads",
"reports/tests",
"reports/screenshots",
"reports/page-sources",
"chrome_data"
);
// 遍历目录列表，尝试创建每个目录
requiredDirs.forEach(dir -> {
try {
Files.createDirectories(Paths.get(BASE_DATA_DIR, dir));
} catch (IOException e) {
// 如果创建失败，记录错误日志
log.error("Failed to create directory: {}", dir, e);
}
});
}
你可以根据实际需求对上述代码进行重构或调整，但整体的逻辑思路是一致的。这段代码在应用程序启动时，会在“C:\Users\myUser\AppData\Local\myApp”文件夹中创建必要的依赖目录，这个文件夹通常对应用程序的缓存和数据文件具有写入权限。
四、总结
在这篇简短的Java教程中，我们探讨了一个在使用Selenide运行基于浏览器工作流程的已安装Java应用程序中常见的问题。通过上述解决方案，可以帮助我们创建用于存储执行结果的必要目录，确保应用程序正常运行。
