set_input_files() 是 Playwright 中唯一可靠上传文件的方式，需用绝对路径、注意超时与内存限制，并通过网络监听或进度条验证真实上传完成。
Playwright 中 set_input_files() 是唯一可靠方式
直接用 page.fill() 或 page.type() 向 <input type="file"> 元素写入本地路径完全无效——浏览器安全策略禁止脚本篡改文件输入框的值。Playwright 提供的 set_input_files() 是专为此场景设计的底层 API，它绕过 DOM 操作，通过 CDP 协议将文件句柄注入到 input 元素中，支持单文件、多文件、相对/绝对路径，且不触发用户交互限制。
常见错误是试图先 page.click() 触发文件选择弹窗再模拟键盘输入路径——这在无头模式下必然失败，且 Playwright 本身不提供弹窗控制能力。
-
set_input_files()必须作用于已存在的<input type="file">元素，不能用于隐藏后又显示的动态元素（需确保元素已 attach 且 visible） - 路径必须是**绝对路径**，相对路径（如
"./data/big.zip"）会报File not found错误；推荐用Path.resolve()处理 - 上传大文件时，Playwright 默认有 30 秒超时，若网络或页面处理慢，需显式传入
timeout=60000
处理大文件上传时的内存与超时问题
Playwright 在调用 set_input_files() 时会把整个文件读入内存再发送，对 >500MB 的文件容易触发 OOM 或长时间卡顿。这不是 bug，而是当前版本的设计限制（截至 v1.42）。真正可行的缓解方案只有两个：分块上传（需服务端配合）或换用更轻量的协议（如直接 POST 到上传接口）。
如果你只是想绕过前端 UI、走后端直传，不要执着于模拟点击上传按钮——直接用 requests 构造 multipart/form-data 请求更稳定、更快、不占 Playwright 内存：
立即学习“Python免费学习笔记（深入）”；
import requests
with open("/path/to/large.zip", "rb") as f:
r = requests.post(
"https://example.com/api/upload",
files={"file": ("large.zip", f, "application/zip")},
headers={"Authorization": "Bearer ..."}
)
- 前端上传按钮背后大概率也是调用同个 API，抓包确认
curl -v或 DevTools Network 即可 - 若必须走 UI 流程（例如测试上传进度条、校验逻辑），则需接受大文件上传耗时，并在
set_input_files()调用前加page.set_default_timeout(120000) - Linux/macOS 下注意文件描述符限制，上传多个大文件可能触发
Too many open files，需调高 ulimit
上传后如何确认成功而非“假完成”
很多网站在调用 set_input_files() 后立即显示“上传成功”，其实只是前端收到了文件句柄，真正的上传可能还在后台进行。直接等 page.wait_for_selector(".success-tip") 极易误判。
可靠做法是监听网络请求或 DOM 状态变化：
- 用
page.expect_request_finished("https://.*upload")等待实际上传请求结束（需提前知道上传接口 pattern） - 监听
<input>元素的change事件只能说明文件已选中，不代表上传完成 - 检查上传进度条是否从
width: 0%变为width: 100%，或轮询后端状态接口（如/api/upload/status?id=xxx） - 上传完成后，服务端通常返回 JSON 包含
file_id或url，可在后续步骤中用page.evaluate()从全局变量或隐藏字段里取值验证
Windows 下中文路径或空格路径导致 File not found
Playwright 对 Windows 路径解析较严格，C:\用户\test\大文件.zip 或 C:\my folder\file.zip 都会失败，错误信息是模糊的 File not found，但实际文件存在。
根本原因是 Playwright 内部使用了 URL 编码逻辑处理路径，而 Windows 本地路径未被正确转义。解决方法只有一条：全部转为正斜杠 + 绝对路径 + 使用 pathlib.Path 规范化：
from pathlib import Path
file_path = Path(r"C:\用户\test\大文件.zip").as_posix() # → "C:/用户/test/大文件.zip"
page.locator("input[type='file']").set_input_files(file_path)
- 不要用字符串拼接路径，
r"C:\a\b"在 Python 字符串里反斜杠仍有转义风险 -
as_posix()强制转为正斜杠，避免 Playwright 解析异常 - 如果路径含环境变量（如
%USERPROFILE%），务必先用os.path.expandvars()展开
上传大文件这件事，表面是调一个函数，实际卡点全在路径合法性、超时设置、成功判定这三个地方。很多人反复试 set_input_files() 不成功，最后发现只是路径少了个 .resolve()。
