基于 Playwright 与 CDP 的多账号巡检系统实践

业务背景：运营侧维护着二十余个电商账号，日常需要逐账号检查店铺状态、广告消耗与消息未读数。人工巡检一轮约 40 分钟，且容易漏检。本文记录我们把这个流程自动化的完整实践：用 Playwright 通过 CDP 协议连接多个隔离浏览器环境，构建一个可调度的巡检系统——包括架构设计、核心代码与踩坑记录。

一、问题分析：为什么不是普通爬虫

巡检系统的第一个设计决策：用登录态浏览器会话，还是用 API/爬虫模拟？

我们评估过纯 API 方案（模拟请求）：需要维护各平台的登录态复制、Token 刷新与风控对抗，平台接口一变就失效，维护成本高。最终选择直接复用已登录的浏览器环境——运营同事日常就在隔离环境中维护这些账号，环境里已有完整登录态，巡检系统只需要"接管"这些环境做只读操作。

这就引出第二个决策：如何程序化地接管一个正在运行的浏览器？

Chrome DevTools Protocol（CDP）是标准答案。基于 Chromium 的浏览器都支持以调试模式启动并暴露 CDP 端口，外部程序连接端口后，可以枚举页面、执行脚本、读取 DOM——Playwright 的 connect_over_cdp 封装了这个过程，且提供了比裸 CDP 更高的 API 抽象。

二、架构设计

系统的目标形态：

三个组件的职责：

调度器：定时任务（cron / APScheduler），按账号清单生成巡检任务队列。

Worker 池：异步并发的 Playwright 会话。每个任务从队列取出后，连接目标环境的 CDP 端口，在已有页面上执行巡检脚本。并发度控制在一个保守值（我们用 3）——巡检是只读操作，但并发过高仍会产生异常的访问模式。

环境集群：运行中的隔离浏览器环境。每个环境在启动时记录其 CDP 端口号，写入环境注册表（一个简单的 JSON 文件或数据库表）。

关键设计取舍：巡检系统不创建、不销毁环境，只消费已存在的环境。环境生命周期归运营侧管理，系统与环境的耦合只有一个端口号——这保证了系统本身的简单性。

三、环境准备

环境侧的唯一要求：浏览器以调试模式启动并暴露 CDP 端口。主流的隔离环境类工具（指纹浏览器等）普遍提供此能力——笔者团队使用云登，其环境启动后可在界面查看调试端口；其他同类工具的端口获取方式类似，以各自文档为准。

我们把"环境名 → CDP 端口"的映射维护在一个注册表文件里，格式如下：

注册表由一个独立的同步脚本维护（轮询各环境的端口并更新），巡检系统只读这个文件——两个职责分离后，环境增删不需要改巡检代码。

四、核心实现

Worker：连接环境并执行巡检。这是系统的核心函数：

几个实现细节值得展开：

连接关闭的语义。connect_over_cdp 返回的 browser 对象调用 close() 时，只是断开 Playwright 与该浏览器的连接，不会关闭浏览器进程本身——这是这个方案能"只消费、不破坏"环境的关键。第一次实现时我们误以为 close 会杀掉环境，还专门做了开关测试确认。

页面查找策略。连接后遍历已有页面找目标，找不到再新开——这尊重了运营侧的现场：同事可能正在某个页面操作，巡检不应该打断，只读已有页面的 DOM 是零干扰的。

异常必须捕获且带上下文。巡检系统的价值在于稳定出报告，单个环境连接失败（端口未开、浏览器重启中）不应中断整轮任务——错误信息截断存储，报告里标注即可。

调度与汇总。主函数把注册表里的账号并发跑完，汇总成报告：

告警的阈值规则按业务定：消息未读数超过 N、店铺状态非正常态、巡检本身失败——三类信号分别推给不同负责人。

五、踩坑记录

坑一：环境休眠导致端口失效。 部分环境长时间无操作会进入休眠，CDP 端口随浏览器暂停而不可达。解决：巡检前加一个预检步骤，连接失败的账号先标记，第二轮补检前等待 30 秒（给环境自动唤醒留时间），仍失败才告警——避免把休眠误报成故障。

坑二：evaluate 的时序问题。 页面还在加载时执行采集脚本，拿到的是空值。解决：脚本内不加固定 sleep（拉长整轮耗时），改用 Playwright 的 wait_for_selector 等待关键元素出现后再 evaluate——20 个账号累计节省约 3 分钟。

坑三：并发度不是越高越好。 初版把并发开到 10，出现了页面加载超时率上升（环境所在宿主机资源竞争）。实测并发 3 时整轮耗时约 6 分钟、零超时——巡检这类非紧急任务，稳定优先于速度。

六、收益与小结

上线三个月的数据：单轮巡检从人工 40 分钟降到系统 6 分钟，漏检率归零，两次店铺状态异常在 10 分钟内被告警捕获（此前平均发现时间是半天）。

技术上这套方案的核心价值是解耦：巡检系统与环境集群之间只有 CDP 端口这一个接口，环境用什么工具、怎么配置指纹，系统完全不感知。这意味着环境侧的任何变更（换工具、改代理）都不需要动巡检代码——对于工具链频繁演进的多账号业务，这种解耦带来的维护成本节约，超过了方案本身的开发投入。

后续计划：把"只读巡检"扩展为"受控操作"（自动确认订单等低风险动作），并加入操作审计日志。方向是确定的，实现上会引入更细的任务描述 DSL——等落地后再写一篇。

技术要点回顾

• CDP 端口是接管已运行浏览器的标准接口，Playwright 的 connect_over_cdp 提供了高抽象封装；
• browser.close() 只断开连接不杀进程——"只消费不破坏"环境的关键语义；
• 巡检并发度保守设置（3），稳定优先于速度；
• 系统与环境集群通过注册表解耦，环境侧变更不影响巡检代码。

本文代码基于 Python 3.10 + Playwright 1.40 验证（2026 年 9 月），完整可复现。文中方案与工具选型为团队实践记录，不构成通用建议。