Playwright 表单定位失败主因是元素不可交互或未正确等待；应优先用 get_by_role/get_by_label、处理 iframe/禁用状态、显式等待导航、避免状态污染，并针对特殊控件采用对应操作。
Playwright 中定位表单元素的常见失败原因
直接用 page.fill() 填写表单却报 TimeoutError: Timeout 30000ms exceeded，大概率是元素没找对。Playwright 不像 Selenium 那样默认等 DOM 加载完就开干——它默认等待元素「可交互」（visible + enabled + attached），但很多表单字段在 SPA 页面里是动态渲染的，或者被 display: none、visibility: hidden 或遮罩层挡住。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 优先用
page.get_by_role("textbox", name="用户名")或page.get_by_label("邮箱")，比靠id或name属性更健壮（尤其 React/Vue 应用会动态生成属性） - 遇到 iframe 内表单，必须先
page.frame_locator("iframe").get_by_role("textbox")，漏掉这步必超时 - 若字段初始被禁用（
disabled），得先触发前置操作（如勾选协议复选框），再等字段启用：page.wait_for_function("() => !document.querySelector('input[name=\"phone\"]').disabled")
批量填表时如何避免重复提交或状态污染
循环调用 page.goto() + fill() + click() 看似简单，但实际常因页面跳转未完成、上一次提交的弹窗/重定向未处理完，导致下一轮操作在错误页面执行。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 每次提交后显式等待导航完成：
with page.expect_navigation(): page.click("button[type='submit']")，别依赖time.sleep() - 批量任务建议用独立上下文（
browser.new_context()）而非复用同一page，避免 cookie/session 污染；若需保持登录态，改用browser.new_context(storage_state="auth.json")并提前存好登录态 - 关键步骤加日志：比如
print(f"✅ 已提交第 {i+1} 条：{data['email']}")，出错时能快速定位卡在哪条数据
处理带验证码、防机器人检测的表单
纯 Playwright 无法绕过图形验证码或 Cloudflare 人机挑战，强行模拟点击只会被拦截或返回 403。这时候得判断：是真要自动化，还是只是想省掉手工填？
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 先确认网站是否允许自动化——查
robots.txt和Terms of Service，有些表单明确禁止 bot 提交 - 若为内部测试系统，关掉验证码开关，或对接打码平台（如
ddddocr解析简单验证码），但需额外部署 OCR 服务，不是page.fill()能解决的 - 防机器人检测（如
headless=False仍被拒）：启动时加参数args=["--disable-blink-features=AutomationControlled"]，并手动覆盖navigator.webdriver，否则page.evaluate("() => navigator.webdriver")返回True就会被识别
填写特殊字段：日期选择器、下拉搜索框、富文本
这些控件往往不是原生 <input type="date"> 或 <select></select>，而是用 div + JS 实现，page.fill() 直接失效。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 日期选择器：多数用
page.get_by_placeholder("开始日期").click()打开面板，再用page.get_by_text("25").click()选日；若支持输入，尝试page.fill("input[placeholder='YYYY-MM-DD']", "2024-06-25")后触发page.keyboard.press("Enter") - 下拉搜索框（如 Ant Design 的
Select）：先page.get_by_role("combobox").fill("北京")，再page.get_by_role("option", name="北京市").click()，注意用name而非text更稳 - 富文本（
contenteditable）：不能用fill()，改用page.locator("div[contenteditable]").focus().press_sequentially("这里是正文内容")，或直接page.evaluate("(el, text) => el.innerHTML = text", element, "内容")
真正麻烦的从来不是“怎么填”，而是填完之后页面没按预期响应——比如没跳转、没弹提示、甚至静默失败。留心 network 面板里提交的请求是否 200，以及响应体是否含 "success": true，比盯着 UI 等动画更可靠。
