Selenium独立Chrome容器中下载弹窗无法关闭问题排查

• Chrome用户偏好配置不完整或参数错误
  要彻底关闭下载弹窗，需确保配置完整的下载相关偏好且参数值正确：

  • 必须指定容器内Chrome可写入的下载目录（如/tmp/downloads），否则Chrome可能因无法写入默认目录触发弹窗；
  • 需开启download.directory_upgrade确保目录变更生效；
  • 针对PDF等特殊文件，需额外配置强制外部打开的参数。
    示例配置代码：

  const { Builder } = require('selenium-webdriver');
  const chrome = require('selenium-webdriver/chrome');
  
  const chromeOptions = new chrome.Options();
  chromeOptions.setUserPreferences({
    'download.default_directory': '/tmp/downloads',
    'download.prompt_for_download': false,
    'download.directory_upgrade': true,
    'plugins.always_open_pdf_externally': true
  });
  
  // 务必在初始化Driver前传入配置好的Options
  const driver = await new Builder()
    .forBrowser('chrome')
    .setChromeOptions(chromeOptions)
    .build();
  

  同时要确保容器内的下载目录存在且有写入权限，可在docker-compose中为node服务添加命令提前创建目录：

  services:
    node-test:
      command: sh -c "mkdir -p /tmp/downloads && npm test"
  

• Chrome版本与Driver版本不匹配
  容器内selenium/standalone-chrome的Chrome版本，与本地开发环境使用的ChromeDriver版本差异过大时，部分偏好参数可能失效：

  • 执行docker exec <chrome-container-id> google-chrome --version查看容器内Chrome版本；
  • 选择对应版本的ChromeDriver依赖（或直接指定带版本号的selenium/standalone-chrome镜像，如selenium/standalone-chrome:118.0），确保版本兼容。

• 容器内Chrome运行环境限制
  selenium/standalone-chrome默认以selenium用户运行Chrome，若下载目录对该用户无写入权限，会触发下载弹窗；同时未启用headless模式或缺少必要启动参数也可能导致问题：
  需补充添加headless及权限相关启动参数：

  chromeOptions.addArguments('--headless=new');
  chromeOptions.addArguments('--no-sandbox');
  chromeOptions.addArguments('--disable-dev-shm-usage');
  

• Before钩子配置时机错误
  若在Driver实例初始化完成后才配置Chrome偏好，配置不会生效。需确保在调用Builder.build()之前，完成所有ChromeOptions的配置并传入Builder。

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