selenium chromedriver本地可下载CSV，AWS Linux服务器无报错下载失败如何排查

安全阿岳

2026-10-5

问题排查步骤

1. 修复Headless模式不支持下载的问题

旧版Chrome的默认--headless模式不支持prefs中配置的下载规则，这是本地有界面环境正常、服务器无头环境失败的最常见诱因：

替换启动参数中的--headless为--headless=new（Chrome 112及以上版本支持）
额外添加Chrome DevTools协议配置强制指定下载路径，优先级高于prefs配置，示例代码如下：

# 初始化driver后添加以下代码
driver.execute_cdp_cmd("Page.setDownloadBehavior", {
    "behavior": "allow",
    "downloadPath": "/absolute/path/to/your/download/folder" # 必须用绝对路径
})

2. 校验下载目录的配置与权限

必须使用绝对路径作为下载目录，禁止使用相对路径，避免服务器运行时工作目录不符导致文件写入到其他位置
执行命令确认运行脚本的用户对目标目录有读写权限，目录权限至少为755，属主和运行脚本的用户保持一致

3. 确认导出点击操作正确触发

该站点的导出是通过JS方法触发，模拟元素点击容易因无头环境下元素渲染异常失效，直接调用对应的JS方法更稳定：

# 替代原有点击a标签的逻辑，直接执行导出JS
driver.execute_script("$find('ctl_ReportViewer').exportReport('CSV');")

4. 增加下载等待逻辑

服务器网络延迟通常高于本地环境，点击导出后需要等待文件生成下载完成再检查目录，不要点击后立刻校验：

import time
from os import listdir

before_download = set(listdir(download_path))
# 执行导出操作
driver.execute_script("$find('ctl_ReportViewer').exportReport('CSV');")
# 最多等待30秒
for _ in range(30):
    new_files = set(listdir(download_path)) - before_download
    if new_files:
        print(f"下载完成：{new_files.pop()}")
        break
    time.sleep(1)
else:
    print("下载超时，文件未生成")