自动化测试 / 系统课时

处理文件上传

处理文件上传

Selenium 处理文件上传时不需要操作系统文件选择器,而是把本地文件的绝对路径直接传给 input[type="file"]。本课完成一次可运行的上传,并验证服务器返回的文件名,同时说明远程执行和自定义上传控件最容易踩到的边界。

学习目标

  • 使用 send_keys() 向文件输入框设置本地绝对路径。
  • 验证上传后的页面结果,而不是只确认文件框已有值。
  • 处理隐藏文件控件、远程 WebDriver 与系统文件对话框的差异。

直接给文件输入框传绝对路径

以下示例按 Selenium 4.x Python API 编写。脚本先在当前脚本目录创建 selenium-upload.txt,再把解析后的绝对路径传给文件输入框。Selenium 官方文档明确支持对 input[type="file"] 使用 send_keys(),因此不需要点击“选择文件”按钮。

python
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)

预期输出:

text
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。若远端报找不到文件,先检查测试进程本地是否存在该路径,再检查远程会话是否启用了文件检测,而不是把节点机器上的路径硬编码进测试。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理文件上传

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通