Python Selenium FirefoxProfile设置下载路径后文件缺失问题

问题分析 #

你代码里有几个关键疏漏，导致文件没被保存到指定路径：

• 只检查了路径是否存在，但没主动创建——如果files_path对应的文件夹不存在，Firefox没法写入文件
• 缺少自动跳过保存对话框的偏好设置——Firefox遇到未知文件类型会弹框，Selenium没处理的话文件就不会自动保存
• 新版本Firefox更推荐用Options而非FirefoxProfile配置偏好，旧方式可能存在兼容性问题

修正步骤 #

1. 确保下载目录存在
   把os.path.exists(fr'{files_path}')替换成创建目录的代码：

   os.makedirs(files_path, exist_ok=True)
   

   这样不管目录是否存在，都会保证它能被正常访问写入。

2. 添加自动保存的文件类型配置
   根据你要下载的文件类型，添加browser.helperApps.neverAsk.saveToDisk偏好。常见文件类型对应的MIME值：

   • 压缩包：application/zip, application/x-zip-compressed
   • Excel：application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel
   • PDF：application/pdf

3. 改用Options配置偏好（推荐）
   新版本Selenium对FirefoxProfile的支持逐渐弱化，直接用Options设置更稳定。

修正后的完整代码 #

files_path = os.path.join(ui_path, "files")
# 确保下载目录存在
os.makedirs(files_path, exist_ok=True)

elif client_type == 'firefox':
    from selenium.webdriver.firefox.options import Options

    options = Options()
    # 设置下载路径为自定义目录
    options.set_preference("browser.download.folderList", 2)
    options.set_preference("browser.download.dir", files_path)
    # 关闭下载管理器弹窗
    options.set_preference("browser.download.manager.showWhenStarting", False)
    # 添加需要自动保存的文件MIME类型，根据你的文件类型调整
    options.set_preference("browser.helperApps.neverAsk.saveToDisk", "application/zip, application/pdf, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
    # 禁用PDF预览（如果下载PDF的话）
    options.set_preference("pdfjs.disabled", True)

    self.driver = webdriver.Firefox(options=options)

额外排查点 #

• 检查Firefox默认下载目录，有时候配置不生效会 fallback 到默认路径
• 确认账号没设置下载后自动打开文件的选项，否则文件可能被打开但没保存到指定路径
• 权限问题：确保测试进程有权限写入files_path目录

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