如何在无头模式(headless)下实现点击触发式文件上传？

问题背景 #

我有一个用于触发文件上传的页面元素：

<a class="gray_box" href="#">Choose world folder<span>Select the world folder, we'll do the rest</span></a>

点击该元素会唤起系统文件管理器。

最初的实现代码如下：

import pyautogui

button = wait(driver, 10).until(EC.element_to_be_clickable((By.CSS_SELECTOR, "[href='#']"))).click()

pyautogui.write(<path>)
pyautogui.press('enter')

但这种方式在无头模式下完全不可用——路径会直接输入到控制台，还会弹出需要手动确认的窗口，无法自动完成上传。

可行方案 #

无头模式下无法通过模拟系统GUI操作完成上传，必须绕过系统文件选择窗口，直接操作页面的文件上传控件：

核心思路 #

这类美化后的上传按钮（比如上述的<a>标签），背后通常对应一个隐藏的<input type="file">元素，我们可以直接定位这个input元素，用send_keys方法传入目标路径，无需触发系统文件管理器。

示例代码 #

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

# 定位页面中的文件上传input元素（请根据实际页面结构调整CSS选择器）
upload_input = WebDriverWait(driver, 10).until(
    EC.presence_of_element_located((By.CSS_SELECTOR, "input[type='file']"))
)

# 直接传入目标文件夹/文件的绝对路径
upload_input.send_keys("/绝对路径/到你的world文件夹")

特殊情况处理 #

如果input元素被设置为隐藏（比如display: none），可以先通过JavaScript修改其可见性再操作：

# 先让input元素可见
driver.execute_script("arguments[0].style.display = 'block';", upload_input)
# 再传入路径
upload_input.send_keys("/绝对路径/到你的world文件夹")

额外注意 #

• 部分浏览器（如Chrome）在无头模式下上传文件夹，需要添加启动参数：--allow-file-access-from-files和--disable-web-security（根据实际需求调整）
• 必须使用绝对路径，避免相对路径导致的识别问题

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