定时任务不想每天扫码:Playwright 登录态持久化的三种做法

举报
yd_222030558 发表于 2026/10/31 19:56:26 2026/10/31
【摘要】 storageState、持久化用户目录、状态回写,三种复用登录态的方式各自适合什么场景。

问题从哪来


用 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 注入。核心是让「登录」这件事只发生一次,而不是每次运行都卡在扫码上。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。