Selenium文件上传本地运行正常但Azure Pipeline/虚拟机中失效如何解决

可能原因及解决方法 #

• 文件路径与存在性问题
  Azure Pipeline代理的操作系统大概率和本地不一致，Windows本地的反斜杠路径\在Linux/macOS代理下无法识别，同时要确认你要上传的文件已经随测试代码一起同步到了Pipeline执行环境的对应路径下。
  排查方法：执行上传前加日志打印newname.getAbsolutePath()的输出，同时添加代码验证文件是否存在：

  if(newname.exists() && newname.isFile()) {
      System.out.println("文件存在，路径：" + newname.getAbsolutePath());
  } else {
      System.out.println("文件不存在，路径：" + newname.getAbsolutePath());
  }
  

  路径兼容可以直接用Java提供的File.separator拼接路径，避免硬编码分隔符。

• 元素定位与等待逻辑问题
  你当前用的visibilityOfElementLocated要求元素可见才能继续，而Pipeline环境的浏览器渲染速度普遍比本地慢，可能出现等待超时导致元素未被正确获取；另外id="undefined"大概率是前端动态生成的属性，不排除Pipeline环境下前端渲染异常导致该id值发生变化，或者页面同时存在多个type="file"的元素匹配到了错误的目标。
  优化方案：

  1. 替换等待逻辑为presenceOfElementLocated，文件输入框本身不需要可见即可执行sendKeys操作，无需强制修改display:block属性
  2. 优化定位规则，增加accept属性作为过滤条件，避免匹配到其他文件输入框：

  WebElement UploadElement=(new WebDriverWait(driver, BaseInitializer.defaultwaitTime)).until(ExpectedConditions.presenceOfElementLocated(By.xpath("//input[@type='file' and contains(@accept,'.xlsm') and contains(@accept,'.zip')]")));
  UploadElement.sendKeys(newname.getAbsolutePath());
  

• 浏览器环境配置问题
  Pipeline中的Chrome一般以无头模式运行，部分旧版本Chrome无头模式对文件上传的支持存在缺陷，同时要确认Pipeline中Chrome浏览器的版本和ChromeDriver版本完全匹配，和本地使用的大版本保持一致。
  可以在Chrome启动参数中增加如下配置：

  ChromeOptions options = new ChromeOptions();
  options.addArguments("--headless=new"); // 使用新版无头模式，兼容性更好
  options.addArguments("--no-sandbox");
  options.addArguments("--disable-dev-shm-usage");
  options.setExperimentalOption("excludeSwitches", new String[]{"enable-automation"});
  

• 权限与事件触发问题

  1. 确认Pipeline执行用户对上传文件有可读权限，Linux环境下可以执行chmod 644 目标文件路径赋权
  2. 如果前端做了文件上传的change事件监听，sendKeys后可以主动触发一次change事件，避免事件未触发导致前端无响应：

  ((JavascriptExecutor)driver).executeScript("arguments[0].dispatchEvent(new Event('change'));", UploadElement);
  

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