Chrome无头模式下Selenium点击按钮无法触发下载的问题求助

Here are targeted fixes to resolve the download failure in --headless=old mode, along with explanations for why each might work:

1. Explicitly Configure Download Directory #

Headless Chrome doesn’t inherit your system’s default download path by default. Set it explicitly to avoid silent failures:

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

chrome_options = Options()
chrome_options.add_argument("--headless=old")

# Define your download folder path
download_dir = "C:/Users/YourName/Downloads/Automated_Data"
chrome_options.add_experimental_option("prefs", {
    "download.default_directory": download_dir,
    "download.prompt_for_download": False,
    "download.directory_upgrade": True,
    "safebrowsing.enabled": True  # Bypass safe download prompts
})

driver = webdriver.Chrome(options=chrome_options)

2. Set a Realistic Window Size #

Old headless mode uses a tiny default viewport, which can render elements unclickable or off-screen. Add this to your options:

chrome_options.add_argument("--window-size=1920,1080")

3. Spoof a Regular User Agent #

Many sites detect headless mode via the default user agent string. Copy your regular Chrome’s user agent (from about:version in Chrome) and add:

chrome_options.add_argument("user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.6668.101 Safari/537.36")

4. Ensure Element is Fully Interactable Before Clicking #

Even if the element exists, it might not be ready to receive clicks. Use explicit waits and scroll into view first:

from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# Wait up to 10 seconds for the button to be clickable
download_btn = WebDriverWait(driver, 10).until(
    EC.element_to_be_clickable((By.XPATH, "//button[contains(text(), 'Download')]"))
)

# Scroll the button into view (critical for headless mode)
driver.execute_script("arguments[0].scrollIntoView({block: 'center'});", download_btn)

# Try clicking with multiple methods
download_btn.click()
# If above fails, try JavaScript click:
# driver.execute_script("arguments[0].click();", download_btn)

5. Bypass Clicking Entirely (Most Reliable) #

Instead of relying on element interaction, capture the direct download URL from Chrome DevTools (Network tab when clicking the button in non-headless mode) and download it with requests:

import requests

# Extract cookies from Selenium session to maintain authentication
cookies = {cookie['name']: cookie['value'] for cookie in driver.get_cookies()}

# Use the download URL you captured
download_url = "https://example.com/api/download/data.csv"
response = requests.get(download_url, cookies=cookies)

# Save the file
with open(f"{download_dir}/data.csv", "wb") as f:
    f.write(response.content)

This method avoids all headless mode interaction quirks and is often the most consistent solution.

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