用 Playwright 启动指定 Chrome 账号的本地浏览器, 复用原账号下的cookie信息

最近有个需求，想用 Playwright 启动 Chrome 时直接用某个已经登录好的账号。查了一圈发现这事儿 Playwright 官方是支持的，而且实现起来也不复杂。

核心思路其实很简单：Chrome 的每个账号都对应一个 Profile 目录，Playwright 启动浏览器时指定这个目录就能直接用那个账号。

找到 Chrome 的 Profile 目录

先说 Windows 系统，Chrome 的用户数据都在这个位置：

复制代码

C:\Users\你的用户名\AppData\Local\Google\Chrome\User Data\

打开这个目录能看到几个文件夹：

复制代码

Default           # 主账号
Profile 1
Profile 2
Profile 3

每个文件夹就是一个独立的账号。比如你想用第二个账号，那就是 "Profile 2"。

三种实现方式

方式一：直接用现有 Profile

这是最直接的方法，用 launchPersistentContext 启动浏览器时指定 User Data 目录和 Profile 名称：

typescript 复制代码

import { chromium } from 'playwright';

const context = await chromium.launchPersistentContext(
  'C:/Users/你的用户名/AppData/Local/Google/Chrome/User Data',
  {
    channel: 'chrome',
    headless: false,
    args: ['--profile-directory=Profile 2'],
  }
);

const page = await context.newPage();
await page.goto('https://www.google.com');

这样启动的 Chrome 就是 Profile 2 的账号状态，登录信息、Cookie、扩展都在。

方式二：复制 Profile 单独使用（推荐）

这种方式更稳妥，不会影响你平时用的 Chrome。把需要的 Profile 复制一份出来：

复制代码

从：C:\Users\你\AppData\Local\Google\Chrome\User Data\Profile 2
到：D:\playwright-profiles\profile_work

然后启动时用这个复制的目录：

typescript 复制代码

const context = await chromium.launchPersistentContext(
  'D:/playwright-profiles/profile_work',
  {
    channel: 'chrome',
    headless: false,
  }
);

这样做的好处是 Playwright 用的是独立的环境，不会和你正常使用的 Chrome 冲突，也不会被 Chrome 的锁文件影响。

方式三：只指定 profile-directory

这种方式只指定 Profile 目录，但有个问题：如果 Chrome 正在运行，会因为文件被锁定而失败。

typescript 复制代码

args: ['--profile-directory=Profile 1']

不太推荐这种方式，临时调试可以，正式用还是前两种更稳。

常见问题

必须用 launchPersistentContext

很多人一开始会写成 chromium.launch()，这样是不行的。一定要用 launchPersistentContext，因为它能保持用户数据。

Chrome 正在运行会冲突

Chrome 运行时会锁定 User Data 目录，Playwright 启动会失败。要么关闭 Chrome，要么用复制的 Profile（推荐后者）。

启动后不能切换账号

Playwright 不支持启动后切换账号，只能在启动时指定。所以提前想好用哪个 Profile。

路径要写对

launchPersistentContext 的第一个参数必须是 User Data 目录，不是 Profile 目录。Profile 名称通过 args 里的 --profile-directory 指定。

错误写法：

typescript 复制代码

launchPersistentContext('.../Profile 2')

正确写法：

typescript 复制代码

launchPersistentContext('.../User Data', {
  args: ['--profile-directory=Profile 2']
})

CI/Docker 环境用不了

本地 Profile 在 CI、Docker、WSL 这些环境里用不了，这是系统限制。

生产环境推荐写法

下面这个模板可以直接用：

typescript 复制代码

import { chromium } from '@playwright/test';

const context = await chromium.launchPersistentContext(
  'D:/pw-profiles/work-account',
  {
    channel: 'chrome',
    headless: false,
    viewport: null,
    args: [
      '--start-maximized',
      '--disable-blink-features=AutomationControlled',
    ],
  }
);

const page = await context.newPage();
await page.goto('https://mail.google.com');

这个配置启动的浏览器窗口最大化，而且禁用了自动化检测的特征，更像正常浏览器。

总结

用 Playwright 启动指定 Chrome 账号的关键就是：

找到对应的 Profile 目录
用 launchPersistentContext 启动
最好复制一份 Profile 单独使用，避免冲突

如果你不确定自己的 Profile 在哪里，或者不知道具体该用哪个参数，可以告诉我你的操作系统和 Chrome 账号情况，我可以帮你写出具体的代码。

原博客链接: 用 Playwright 启动指定 Chrome 账号的本地浏览器, 复用原账号下的cookie信息