自动化测试 / 系统课时
处理文件上传
处理文件上传
Selenium 处理文件上传时不需要操作系统文件选择器,而是把本地文件的绝对路径直接传给 input[type="file"]。本课完成一次可运行的上传,并验证服务器返回的文件名,同时说明远程执行和自定义上传控件最容易踩到的边界。
学习目标
- 使用
send_keys()向文件输入框设置本地绝对路径。 - 验证上传后的页面结果,而不是只确认文件框已有值。
- 处理隐藏文件控件、远程 WebDriver 与系统文件对话框的差异。
直接给文件输入框传绝对路径
以下示例按 Selenium 4.x Python API 编写。脚本先在当前脚本目录创建 selenium-upload.txt,再把解析后的绝对路径传给文件输入框。Selenium 官方文档明确支持对 input[type="file"] 使用 send_keys(),因此不需要点击“选择文件”按钮。
from pathlib import Path
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.ui import WebDriverWait
upload_file = Path(__file__).with_name("selenium-upload.txt").resolve()
upload_file.write_text("selenium upload check\n", encoding="utf-8")
driver = webdriver.Chrome()
try:
driver.get("https://the-internet.herokuapp.com/upload")
file_input = driver.find_element(
By.CSS_SELECTOR, "input[type='file']"
)
file_input.send_keys(str(upload_file))
driver.find_element(By.ID, "file-submit").click()
uploaded_name = WebDriverWait(driver, 10).until(
EC.visibility_of_element_located((By.ID, "uploaded-files"))
)
assert uploaded_name.text == upload_file.name
print(uploaded_name.text)
finally:
driver.quit()
upload_file.unlink(missing_ok=True)预期输出:
selenium-upload.txt如果测试使用固定资源文件,推荐通过 Path(...).resolve() 生成绝对路径,不要依赖当前工作目录。CI、IDE 和命令行的工作目录可能不同,相对路径在本机通过后,换到流水线最容易直接报“文件不存在”。
理解上传时真正发生了什么
文件上传的关键对象有三个:测试进程能访问的本地文件、页面中的文件输入框、浏览器随后发出的表单上传请求。Selenium 把路径设置到文件输入框,浏览器在表单提交时读取文件内容;原生系统文件选择器并不在这条自动化链路里。

因此测试代码不应先 click() 文件输入框再尝试控制 Windows、macOS 或 Linux 的系统窗口。那类窗口不属于网页 DOM,WebDriver 无法像定位网页元素一样定位它;正确路径是直接找到真实的文件输入控件并设置路径。
验证的不只是文件框名称
给文件输入框设置路径后,value 属性通常只说明浏览器已经接受了选择,并不能证明文件已传到服务器。更可靠的验收至少检查“提交后的服务端结果”或“页面从服务端得到的上传状态”,例如文件名、资源 ID、缩略图或成功状态。
| 检查点 | 可验证内容 | 不足 |
|---|---|---|
| 选择后 | 文件输入框已有文件 | 只能证明本地选择完成 |
| 提交后 | 页面显示 selenium-upload.txt |
能证明示例站点已接收并返回名称 |
| 业务系统 | 新资源 ID、下载链接或列表新增记录 | 最接近真实业务成功 |
对于限制类型或大小的系统,还应准备边界用例。例如允许最大 5 MB 时,至少覆盖一个小于 5 MB 的合法文件和一个超过 5 MB 的拒绝用例;不要只测扩展名,因为很多系统还会校验 MIME 类型或服务端内容。
处理隐藏控件与远程执行
很多页面把真正的 input[type="file"] 隐藏起来,再用自定义按钮触发选择器。测试时应定位底层文件输入框,而不是操作系统弹窗。Selenium 还提供 strictFileInteractability 能力;默认关闭时,对隐藏文件输入控件的交互检查较宽松,但项目不应依赖复杂的样式绕过,最好让页面保留可测试的原生文件控件。
在 Selenium Grid 或其他 RemoteWebDriver 场景中,文件路径来自执行测试代码的机器,而浏览器可能运行在另一台节点上。Python 的远程 WebDriver 默认带本地文件检测器,会把本地文件传给远端;如需显式设置,可使用 selenium.webdriver.remote.file_detector.LocalFileDetector。若远端报找不到文件,先检查测试进程本地是否存在该路径,再检查远程会话是否启用了文件检测,而不是把节点机器上的路径硬编码进测试。