Playwright无头模式失败主因是网站反爬检测,需禁用AutomationControlled、覆盖navigator.webdriver、保存复用storage_state、设置合理超时与重试、规避验证码并优先选用API签到。

Playwright 启动无头模式失败,页面加载空白
Playwright 默认启用无头模式(headless=True),但部分网站会检测 headless 特征并拒绝渲染或跳转到验证页。这不是 Playwright 本身的问题,而是反爬策略生效。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 先用
headless=False调试,确认登录/签到流程能手动走通 - 调试通过后,改回
headless=True,同时加启动参数绕过检测:chromium.launch(headless=True, args=["--disable-blink-features=AutomationControlled"]) - 务必在页面加载后执行
page.add_init_script("Object.defineProperty(navigator, 'webdriver', {get: () => undefined})"),覆盖 navigator.webdriver 属性 - 避免使用过于激进的等待方式(如
page.wait_for_timeout(5000)),优先用page.wait_for_selector()等条件等待
登录后无法保持会话,签到按钮不可见或点击无效
Playwright 的每个 browser.new_context() 是全新会话,不继承浏览器缓存、Cookie 或 localStorage。如果目标网站依赖前端 token(比如 JWT 存在 localStorage 中),直接复用登录页跳转后可能丢失状态。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 登录成功后,立即调用
context.storage_state(path="auth.json")保存认证状态 - 下次运行时,用
browser.new_context(storage_state="auth.json")复用已登录上下文 - 不要依赖“打开首页 → 点登录 → 填表单 → 提交”这一整套流程反复执行;稳定做法是:首次完整登录并保存
storage_state,后续全部基于该状态启动 - 检查签到按钮是否被动态渲染(例如 JS 加载后才插入 DOM),需等待其出现再操作:
page.wait_for_selector("button:has-text('签到')", state="visible")
定时自动签到任务中,页面超时或网络中断导致脚本静默失败
无人值守运行时,page.goto() 或 page.click() 抛异常不会自动重试,且默认超时仅 30 秒,对弱网或慢响应站点不够用。
将测试、lint、构建和文档流程编码为命名的Python会话,以便人类和代理每次运行相同的workflow。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 为关键操作设置合理超时和重试逻辑,例如:
page.goto(url, timeout=60000, wait_until="networkidle") - 用
try/except包裹签到主流程,捕获TimeoutError、Error(Playwright 的基类异常)等,并记录日志或发通知 - 避免在
page.on("response", ...)中做耗时操作,否则可能阻塞页面加载 - Linux 守护进程(如 systemd)运行时,确保环境变量
DISPLAY不为空(Headless 模式下可设为export DISPLAY=:99并配 xvfb)
验证码或滑块拦截导致自动化中断
一旦遇到图形验证码、行为验证(如腾讯防水墙、极验)、或人机挑战,Playwright 无法自动识别或模拟——这不是配置问题,而是技术边界。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 先确认目标网站是否真有这类验证:用无头模式访问登录页,截图看是否弹出验证层(
page.screenshot(path="debug.png")) - 若存在,放弃全自动方案;改为半自动:登录阶段人工输入验证码,之后保存
storage_state,后续签到完全自动 - 不要尝试接入 OCR 或模拟滑块轨迹,成功率低、维护成本高,且多数平台已有行为风控升级(如鼠标移动曲线、canvas 指纹)
- 部分站点提供 API 签到入口(如带 token 的 POST 接口),比浏览器自动化更可靠;优先查文档或抓包分析
真正难的不是写几行 page.click(),而是判断哪些环节必须人工介入、哪些状态必须持久化、哪些超时要容忍、哪些错误该告警。自动化签到跑得稳,靠的是对失败场景的预设,而不是对成功路径的幻想。

















