# 别再下载第二个 Chromium：playwright-core 复用本机 Chrome 的自动化实践与 7 个坑

## 一、起因

一台 16GB 内存的办公机，常年挂着聊天工具、邮件客户端和几个后台页面，上面跑着一个定时任务——每天把整理好的稿件自动发布到一个内容平台。

用 Playwright 做这件事很自然，但第一次 `npm i playwright` 就让我犹豫了：它会顺带下载一份配套的 Chromium（解压后几百 MB）。而这台机器上**本来就有 Chrome**，还是用户平时在用的那份，登录态、语言、字体全对。

目标因此明确：**用 Playwright 的 API 驱动本机已装的 Chrome，一个字节的浏览器都不下载。**

结论先给：`playwright-core` 加一个 `executablePath` 就够了。真正花掉我一整晚的，不是启动，而是"怎么判断用户已经登录完成"。

---

## 二、两个关键发现

**发现 1：`playwright` 和 `playwright-core` 是两个包。** 前者自带浏览器内核，安装时的 postinstall 会自动下载；后者 API 完全相同，只是不含浏览器二进制，因此**必须自己指定浏览器可执行文件**。要复用本机浏览器，选后者。

**发现 2：判断"登录是否完成"这件事，本身就是最大的坑。** 我最初的做法是循环里定期导航到"需要登录才能看的页面"，没被踢到登录页就算成功。听起来合理，实际上——**每一次轮询都是一次真实导航**。用户正在扫码、正在填验证码，页面却被我的脚本每隔几秒拽走一次。用户看到的现象是："这页面自己在不停地刷新，怎么都登不进去。"

第二个发现比第一个重要得多，下面单独讲。

---

## 三、实现

### 3.1 启动：持久化档案 + 复用本机 Chrome

```js
// launch.js —— 用本机已装的 Chrome，不下载 Chromium
const { chromium } = require('playwright-core');   // 注意：不是 'playwright'
const path = require('path');

const PROFILE = path.join(__dirname, 'browser-profile'); // 档案目录：登录态存在这里

async function launch(headless, chromeExe) {
  return chromium.launchPersistentContext(PROFILE, {
    executablePath: chromeExe,                 // 指向本机浏览器，例：/path/to/chrome
    headless,                                  // 首次人工扫码传 false，跑批传 true
    locale: 'zh-CN',
    viewport: { width: 1180, height: 860 },
    args: [
      '--disable-blink-features=AutomationControlled',
      // 跨域扫码登录的回调依赖第三方 Cookie，新版 Chrome 默认拦截 →
      // 表现是"扫码成功但页面在登录页来回跳"，必须显式关掉
      '--disable-features=TrackingProtection3pcd,BlockThirdPartyCookies',
      // 内存紧张时的降占用组合
      '--disable-extensions', '--disable-sync',
      '--disable-background-networking', '--password-store=basic',
    ],
  });
}
```

两个要点：用 `launchPersistentContext` 而不是 `launch`，登录态才能落盘复用，否则每次跑批都要重新扫码；档案目录**单独放，不要指向用户日常使用的主档案**，避免互相污染。

### 3.2 等待人工登录：等待期间"零导航"

这是全文重点。改造后的等待循环遵守唯一一条纪律：**在用户完成操作之前，脚本不做任何导航，只做被动观察。**

```js
// wait-login.js —— 等待人工完成登录；等待期间绝不打断用户
const WRITE_URL    = 'https://example.com/console/articles/new';
const AUTH_COOKIES = ['uin', 'skey'];      // 仅登录后才出现的凭据类 Cookie

async function hasAuthCookie(ctx) {
  const names = new Set((await ctx.cookies()).map(c => c.name));
  return AUTH_COOKIES.some(k => names.has(k));
}

async function waitLogin(ctx, page, waitMinutes = 25) {
  const deadline = Date.now() + waitMinutes * 60 * 1000;
  let tick = 0, nextVerify = 0, lastUrl = '';

  while (Date.now() < deadline) {
    if (page.isClosed()) return { ok: false, reason: 'window_closed' };
    await page.waitForTimeout(2500);
    tick++;

    // 1) 只记录页面轨迹；URL 去掉 query，避免把令牌写进日志
    const cur = safeUrl(page.url());
    if (cur !== lastUrl) { console.log('[页面]', cur); lastUrl = cur; }

    // 2) 被动判断登录态：只读 Cookie，不导航
    if (await hasAuthCookie(ctx)) {
      const title = await page.title().catch(() => '');
      const onAuthPage = /\/(login|register|verify)/i.test(cur)
                      || /登录|注册|验证/.test(title);
      // 只有"凭据已在 + 用户已离开登录/注册/验证页"时，才允许做一次确认导航
      if (!onAuthPage && tick >= nextVerify) {
        await page.goto(WRITE_URL, { waitUntil: 'domcontentloaded', timeout: 60000 });
        if (!/\/login/.test(page.url())) return { ok: true };
        nextVerify = tick + 120;   // 120 × 2.5s = 5 分钟冷却，绝不反复打扰
      }
    }
  }
  return { ok: false, reason: 'timeout' };
}

// 描述 URL 时只保留 host+path，去掉 query/hash
function safeUrl(u) {
  try { const x = new URL(u); return x.host + x.pathname; }
  catch { return String(u || '').split('?')[0].split('#')[0]; }
}
```

为什么这段代码能治好"页面自己乱跳"：**注册和实名验证的中途，凭据 Cookie 就已经存在了。** 旧版只要一看到凭据就跳去写作页确认，于是用户每往前走一步就被拽回来——看起来是"页面自己在刷新"，其实是我自己的循环在导航。新版的判定条件从"有凭据就算登录"改成"**有凭据 且 已离开登录/注册/验证页**"，并且失败后进入 5 分钟冷却，就算误判一次也不会连续打断。

顺带说一句凭据的处理原则：脚本只把凭据写进本地文件，运行日志里**只打印条数和字符长度，不打印内容**。

---

## 四、踩坑对照表

| # | 现象 | 真因 | 解法 |
|---|---|---|---|
| 1 | `npm i` 报一堆网络/权限错误 | 目标安装目录不存在，npm 找不到落点，报错信息具有误导性 | 先确认并创建安装目录，再执行安装 |
| 2 | 装完库又要下一个几百 MB 的 Chromium | `playwright` 包在 postinstall 阶段自动下载配套浏览器 | 换 `playwright-core` + `executablePath` 指向本机浏览器 |
| 3 | 用户反馈"页面自己不停刷新、登不进去" | 等待循环里一检测到凭据就 `goto` 去确认，把用户正在走的注册/实名流程反复拽走 | 等待期间零导航；仅在"凭据已在 + 已离开登录页"时确认一次，失败后 5 分钟冷却 |
| 4 | 轮询登录态时页面频繁跳动 | 用"导航到需登录页面看是否被踢走"当探针，每次轮询都是真实导航 | 改为只读 `ctx.cookies()` 被动判断，零副作用 |
| 5 | 复用档案目录启动失败 / 进程残留 | 上次异常退出留下浏览器进程与 profile 锁文件 | 启动前确认无同名进程、清锁文件；档案目录独立，别指向用户主档案 |
| 6 | 扫码成功但始终停在登录页 | 新版 Chrome 默认拦第三方 Cookie，跨域 SSO 回调拿不到票据 | 启动参数关闭 `TrackingProtection3pcd,BlockThirdPartyCookies` |
| 7 | 日志里出现带 token 的完整 URL | 直接把 `page.url()` 写进日志 | 统一走 `safeUrl()`，只记 host+path |

---

## 五、效果

**依赖体积**：从"库里自带一份几百 MB 的浏览器内核"变成零浏览器依赖，`node_modules` 只有几 MB——对磁盘和内存都紧张的老办公机，这个差别很实在。

**内存占用**：跑批时关掉扩展、同步、后台联网，无头模式下的常驻占用明显低于日常开着的浏览器窗口，这也是它敢和聊天工具、邮件客户端挤在同一台 16GB 机器上的原因。

**稳定性**：最关键的变化不是"跑得更快"，而是**用户终于能一次走完登录流程**——改造前扫码会陷入"脚本抢页面 → 用户重试 → 又被抢"的循环，改造后扫码一次通过、凭据落本地，之后的定时跑批无人值守。

如果只留一句话：**自动化脚本在等待人类操作时，最大的美德是安静。** 把"我现在能导航了吗"从猜测换成只读的状态观察，大部分"页面自己乱跳"的灵异现象都会消失。

一台 16GB 内存的办公机，常年挂着聊天工具、邮件客户端和几个后台页面，上面跑着一个定时任务——每天把整理好的稿件自动发布到一个内容平台。

别再下载第二个 Chromium：playwright-core 复用本机 Chrome 的自动化实践与 7 个坑

用 playwright-core 驱动本机已装的 Chrome 跑自动化，省去几百 MB 浏览器下载；并复盘"脚本自己抢用户页面"导致登录死循环的排查与修法。

开发工具

测试

前端

使用playwright-core复用本机Chrome实现自动化，避免下载Chromium内核。核心要点：通过executablePath指向本地浏览器，采用launchPersistentContext持久化登录态，等待用户操作时严格零导航原则，仅通过Cookie被动判断登录状态。破解扫码登录跳转问题需禁用第三方Cookie拦截，等待确认导航设置5分钟冷却期。内存占用降低，适合16GB内存办公机批量运行场景。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

使用playwright-core复用本机Chrome实现自动化，避免下载Chromium内核。核心要点：通过executablePath指向本地浏览器，采用launchPersistentContext持久化登录态，等待用户操作时严格零导航原则，仅通过Cookie被动判断登录状态。破解扫码登录跳转问题需禁用第三方Co...

别再下载第二个 Chromium：playwright-core 复用本机 Chrome 的自动化实践与 7 个坑-腾讯云开发者社区-腾讯云

别再下载第二个 Chromium：playwright-core 复用本机 Chrome 的自动化实践与 7 个坑

别再下载第二个 Chromium：playwright-core 复用本机 Chrome 的自动化实践与 7 个坑

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐