Linux服务器上Java Selenium应用下载功能异常问题求助

可能原因 #

• 无头模式下载配置不全：Linux下Chrome无头模式的行为和普通模式有差异，仅设置download.default_directory不足以覆盖默认的下载规则，可能导致路径配置不生效。
• 目录权限不足：指定的directoryPath目录没有写入权限，Java进程运行的用户（如普通用户、服务进程用户）无法向该目录写入文件，下载操作静默失败。
• Chrome与ChromeDriver版本不匹配：服务器上的Chrome浏览器和chromedriver版本主版本号不一致，会导致配置参数无法被正确识别。
• 路径格式错误：directoryPath如果是相对路径，服务器上Java进程的工作目录和本地不同，会导致实际存储路径偏离预期；或是误用了Windows风格的路径分隔符\。
• 安全拦截/临时目录存储：无头模式下Chrome可能触发安全策略，将下载文件自动拦截或存放到/tmp下的临时沙箱目录中。

解决办法 #

1. 补全Chrome无头模式下载配置
   在现有代码基础上添加关键配置，确保无头模式下下载行为符合预期：

   HashMap<String, Object> chromePrefs = new HashMap<String, Object>();
   chromePrefs.put("download.default_directory", directoryPath);
   chromePrefs.put("download.prompt_for_download", false); // 禁用下载弹窗
   chromePrefs.put("download.directory_upgrade", true); // 允许目录升级
   chromePrefs.put("safebrowsing.enabled", true); // 规避安全拦截
   
   ChromeOptions options = new ChromeOptions();
   options.setExperimentalOption("prefs", chromePrefs);
   // 替换为新版无头模式，行为更接近正常Chrome
   options.addArguments("--headless=new");
   options.addArguments("--no-sandbox"); // 禁用沙箱，避免权限限制
   options.addArguments("--disable-dev-shm-usage"); // 解决Linux临时空间不足问题
   options.addArguments("window-size=1920,1080");
   
   String chromeDriverPath = "/usr/bin/chromedriver";
   System.setProperty("webdriver.chrome.driver", chromeDriverPath);
   

2. 检查并修复目录权限

   • 查看目录权限：ls -ld <directoryPath>
   • 赋予写入权限（根据实际用户组调整）：chmod 775 <directoryPath>
   • 确认Java进程运行用户（用ps aux | grep java查看）对该目录有写入权限。

3. 验证版本匹配性

   • 查看Chrome版本：google-chrome --version
   • 查看ChromeDriver版本：chromedriver --version
   • 确保两者主版本号一致（如Chrome为119.x，ChromeDriver也需为119.x），不一致则替换为对应版本。

4. 排查实际存储路径

   • 搜索Chrome临时目录：find /tmp -name "*.org.chromium.Chromium*"
   • 进入找到的目录，检查是否存在下载的文件，确认是配置问题还是权限问题。

5. 确认路径有效性

   • 确保directoryPath为Linux绝对路径（如/opt/selenium_downloads），避免使用相对路径。
   • 在代码中打印路径实际值：System.out.println("实际下载目录：" + directoryPath);，确认路径无误。

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