定时任务不想每天扫码:Playwright 登录态持久化的三种做法
问题从哪来
用 Playwright 写了个每天跑的定时任务,第一次手动扫码登录,第二天跑的时候又跳回登录页。原因是:每次 browser.newContext() 都是一个全新的、无痕的浏览器上下文,登录态根本不会保留。
三种做法可以解决,选哪个取决于部署环境。
做法一:storageState(推荐)
Playwright 提供了登录态的序列化能力,cookies 和 localStorage 一起存成一个 JSON:
// 采集:只跑一次,带界面
const browser = await chromium.launch({ headless: false });
const context = await browser.newContext();
const page = await context.newPage();
await page.goto('https://example.com/login');
// 这里停下来等用户手动登录(扫码 / 短信)
await page.waitForURL('**/dashboard', { timeout: 5 * 60_000 });
await context.storageState({ path: 'state.json' });
await browser.close();
之后每次跑:
const context = await browser.newContext({ storageState: 'state.json' });
优点是体积小(一个 JSON,通常几 KB 到几十 KB)、可加密后放进 CI 的 Secret、便于多任务共享。缺点是有时效:cookie 过期就得重新采集,所以要在任务结束时把最新的 storageState 回写,让过期时间不断往后推。
const fresh = await context.storageState();
fs.writeFileSync('state.json', JSON.stringify(fresh));
这一步很关键。很多「昨天还能跑今天就不行」的问题,都是因为没有回写,一直在用第一次采集的那份。
做法二:持久化用户目录
launchPersistentContext 直接复用一个真实的用户数据目录,等价于日常使用 Chrome 时保留的登录信息:
const context = await chromium.launchPersistentContext('./user-data', {
headless: true,
viewport: { width: 1440, height: 900 },
});
好处是能存住 Service Worker、IndexedDB、缓存,对那种「刷新页面就要重新验证」的站点更稳。坏处是目录会越来越大(几十到几百 MB),而且同一目录不能并发启动两个实例,会直接报 ProcessSingleton 错误。
适合单机、单任务的场景。多任务并行就该退回做法一。
做法三:Cookie 注入
如果手头只有浏览器里复制出来的一段 Cookie 字符串,可以直接注入:
await context.addCookies([
{ name: 'SESSION', value: 'xxx', domain: '.example.com', path: '/' },
]);
这种方式最轻,但要注意两点:一是 domain 必须写对,.example.com 和 example.com 在这套 API 里不是一回事,写错就静默不生效;二是只能带 cookie,localStorage 里的 token 带不过去,而现代前端很多把 token 存在 localStorage。
能用做法一就别用这个。
登录态失效了怎么判断
不要等任务跑到一半才发现要登录。开跑前先做一次「登录态探针」:
await page.goto('https://example.com/dashboard');
if (/auth|login/i.test(page.url())) {
throw new Error('登录态失效,请重新采集');
}
只要 URL 被重定向到登录页,就可以立刻判定,省掉后面所有无效操作。比去页面里找「退出登录」按钮稳定得多——按钮文案会改版,重定向行为不会。
放到 CI 里的几个实践
加密存放。登录态等价于账号密码,绝不能进 git。存 CI 变量时做一次 base64:
base64 -w0 state.json # Linux
base64 -i state.json | tr -d '\n' # macOS
脚本里优先读环境变量,读不到再读本地文件,本地开发和云端跑共用一套代码。
专人专号。自动化用的账号和日常用号分开,出问题好定位,也不影响自己使用。
控制频率。定时任务不要做高频轮询,加 500ms–2s 的随机间隔。这不只是礼貌问题,机械化的固定间隔请求很容易被风控识别。
失败要留证据。出错时截一张图存下来,比翻日志快十倍:
await page.screenshot({ path: shots/${Date.now()}.png });
别把密钥贴进对话框。不管是对 AI 助手还是对同事,临时凭证优先用平台注入的方式获取,用完即弃的短期凭证远比长期 AK/SK 安全。
一句话总结
单任务单机用持久化目录,云端多任务用 storageState + 每次回写,只有拿不到完整状态时才退回 cookie 注入。核心是让「登录」这件事只发生一次,而不是每次运行都卡在扫码上。
- 点赞
- 收藏
- 关注作者
评论(0)