Jenkins以Windows服务运行时Selenium/Java文件上传失败问题

我之前踩过几乎一模一样的坑，结合你的场景，咱们一步步拆解排查：

1. 优先排查文件路径与权限问题 #

这是最容易踩的坑：

• 务必使用绝对路径：Eclipse里的相对路径（比如./upload/test.pdf）在Jenkins服务的工作目录下完全找不到。直接写完整绝对路径，比如C:\jenkins_workspace\your_app\src\main\resources\test_upload.pdf。
• 检查Jenkins服务账户的权限：Jenkins作为Windows服务默认用Local System账户运行，这个账户大概率没有访问你本地文件目录的权限。右键文件所在文件夹 →「属性」→「安全」，给Local System（或你指定的Jenkins服务账户）添加读取权限。

2. 无头浏览器的特殊配置 #

如果你的测试用了无头模式（比如Chrome无头），文件上传需要额外配置参数：
以Chrome为例，启动时必须加上允许文件访问的参数：

ChromeOptions options = new ChromeOptions();
options.addArguments("--headless=new");
options.addArguments("--allow-file-access-from-files"); // 核心配置：允许文件访问
options.addArguments("--disable-web-security"); // 必要时关闭安全限制
WebDriver driver = new ChromeDriver(options);

另外一定要注意：WebDriver版本必须和浏览器版本完全匹配，版本不兼容经常会抛出这种莫名其妙的invalid argument错误。

3. 绕过系统弹窗的上传方式 #

因为Jenkins服务没有桌面会话，原生系统的文件选择弹窗大概率无法正常触发，直接用SendKeys给文件输入框传路径就行：

// 找到页面上的文件上传输入框（type="file"的元素）
WebElement fileInput = driver.findElement(By.cssSelector("input[type='file']"));
// 直接传入文件绝对路径，不需要点击上传按钮
fileInput.sendKeys("C:\\full\\path\\to\\your\\file.txt");

这种方式完全绕过系统弹窗，不需要桌面环境支持，最适合Jenkins服务场景。

4. 确认Jenkins工作空间的文件存在 #

如果你的上传文件是从代码仓库拉取的，先确认Jenkins构建时已经把文件同步到了工作空间。可以在Jenkins构建步骤里加一个「执行Windows命令」，输出目录内容验证：

echo 当前工作空间：%WORKSPACE%
dir %WORKSPACE%\your_upload_file.txt

用%WORKSPACE%环境变量拼接绝对路径会更可靠，避免路径不一致的问题。

内容的提问来源于stack exchange，提问作者johnsonambrose