Playwright 登录态保持:storageState 与 Cookie 生命周期

举报
yd_260750576 发表于 2026/11/20 08:32:03 2026/11/20
【摘要】 storageState 保存的是某一刻的 Cookie 和 localStorage 快照,不是“登录能力”。它的失效点和你想的不一样:首页往往匿名可访问,真正暴露问题的是提交表单时的 401。我的

storageState 保存的是某一刻的 Cookie 和 localStorage 快照,不是“登录能力”。它的失效点和你想的不一样:首页往往匿名可访问,真正暴露问题的是提交表单时的 401。我的做法是保存时记录签发时间,用之前校验剩余有效期,提前 5 分钟刷新,而不是等用例失败再重登。

一、storageState 里到底存了什么

一个 state.json 的结构只有两块:cookies 数组和 origins 数组。cookies 里每项包含 name、value、domain、path、expires、httpOnly、secure、sameSite;origins 里是按域名分组的 localStorage 键值对。没有 sessionStorage,没有 IndexedDB,没有 Cache Storage。

这个边界决定了很多东西存不进去。有些后台把 token 放在 sessionStorage,刷新页面就丢,用 storageState 恢复不了;有些应用把权限缓存放 IndexedDB,恢复后要重新拉一次。遇到这类系统,要么改应用把 token 放 localStorage,要么接受每次多一次初始化请求。

expires 字段是最容易被忽略的。它的值是 Unix 时间戳(秒),-1 表示 session cookie。浏览器语义里 session cookie 在浏览器关闭时失效,但 Playwright 是通过 CDP 注入 cookie 的,不依赖浏览器的会话恢复机制,所以文件里 expires: -1 的 cookie 在新 context 里照样生效,直到 context 关闭。这个反直觉的行为让很多人以为 session cookie 可以长期复用,实际上它只是“不会因为时间到期而失效”,服务端的会话仍然可能在 30 分钟后被踢掉。

二、失效点不在首页,在第一次写操作

我见过最多的错误验证方式是“打开首页,看到用户名就认为登录态有效”。首页通常是匿名可访问的,顶栏显示用户名可能来自一个独立的轻量接口,甚至来自 localStorage 里的缓存。真正需要鉴权的是提交表单、加载列表、下载文件这些动作。

正确的探测点是找一个必须鉴权的接口,比如 /api/me 或者 /api/orders?page=1,在加载 storageState 之后先请求一次,状态码不是 200 就判定失效。这个请求只要几十毫秒,比跑完一整个用例再失败要划算得多。

更细的判断要看业务错误码。有些系统鉴权失败也返回 200,body 里 code: 40101。只判断 HTTP 状态码会漏掉这一类,探测函数要把业务码也检查一遍。

还有一个注入不生效的坑在 domain 和 path 上。storageState 里的 cookie 带着原始 domain,如果测试环境从 https://test.example.com 换到 https://staging.example.com,cookie 的 domain 对不上,浏览器会直接丢弃,表现是“加载了 state 但仍是未登录”。跨环境复用要么重新登录,要么在加载后手动改写 domain。path 同理,限定在 /app 下的 cookie 不会带到 /。

三、三条路线:重登、复用状态、复用 context

路线 单次成本 隔离性 失效影响 适用
每个用例重新登录 2-4s 最好 无 登录流程本身的测试
复用 storageState 50-200ms 好 全部用例失败 绝大多数业务用例
复用 browser context 接近 0 差 状态互相污染 只读、串行场景

我默认选第二条。globalSetup 里登录一次,把状态写到 playwright/.auth/user.json,所有 project 通过 use: { storageState } 引用。这样每个 test 仍然是独立 context,隔离性保住,登录成本只付一次。

第三条只在特殊场景用,比如要测试“连续操作导致的状态变化”,这时 context 里的内存状态本身就是被测对象。一旦并发,共享 context 必然出问题:两个 test 同时点同一个按钮,路由互相跳转,失败信息完全不可读。

四、刷新策略:按剩余有效期,不按失败次数

我的做法是在 state 文件旁边存一个 meta,记录签发时间和 access token 的过期时间。用之前算剩余时间,小于 5 分钟就重新登录。这样失败不会发生在用例中间,而是发生在准备阶段,报错清晰。

如果拿不到 token 的过期时间,退化成固定 TTL。经验值是服务端会话超时的 60%,比如会话 30 分钟,state 就用 18 分钟。这个比例留了足够的余量,又不至于频繁重登。

// global-setup.ts
import { chromium, FullConfig } from '@playwright/test';
import fs from 'node:fs';

const STATE = 'playwright/.auth/user.json';
const META = 'playwright/.auth/user.meta.json';
const TTL_MS = 18 * 60 * 1000; // 会话 30 分钟,取 60%

export default async function globalSetup(config: FullConfig) {
  if (fs.existsSync(META)) {
    const { issuedAt } = JSON.parse(fs.readFileSync(META, 'utf8'));
    if (Date.now() - issuedAt < TTL_MS) return; // 未过期,直接复用
  }
  const browser = await chromium.launch();
  const page = await browser.newPage();
  await page.goto(`${process.env.BASE_URL}/login`);
  await page.getByLabel('用户名').fill(process.env.TEST_USER!);
  await page.getByLabel('密码').fill(process.env.TEST_PASS!);
  await page.getByRole('button', { name: '登录' }).click();
  await page.waitForURL('**/dashboard');

  await page.context().storageState({ path: STATE });
  fs.writeFileSync(META, JSON.stringify({ issuedAt: Date.now() }));
  await browser.close();
}

waitForURL 这一步不能省。点击登录之后立刻取 storageState,可能拿到的是跳转前的状态,cookie 还没写全。等 URL 变成目标页,再等一个必须鉴权的接口返回 200,两个条件都满足才保存。

五、并发下的账号策略

workers: 4 的时候,四个 test 同时跑。如果它们共用一个账号,任何写操作都会互相影响:A 改了昵称,B 的断言就挂了;A 下了单,B 的订单列表多了一条。这类问题排查起来极其痛苦,因为单独跑都能过。

我的做法是按 worker 分配账号,环境变量里准备 TEST_USER_0 到 TEST_USER_3,globalSetup 为每个账号生成一份 state,test 里用 testInfo.parallelIndex 取对应的文件。账号数量等于 worker 数量,扩容时同步加账号。

只读场景可以共用账号,但要接受一个前提:这个账号的权限是只读的,任何用例都不会写。这个约定要写进 README,否则新人加一个“修改密码”的用例就会把所有人踢下线。

六、落地节奏

  1. 先确认应用的 token 存哪里,localStorage 能覆盖就用 storageState,存 sessionStorage 的要先改应用。
  2. globalSetup 登录一次,保存 state 加 meta,记录签发时间。
  3. 加一个鉴权探测接口,加载 state 后先请求,失败就重登,不要等到用例中间。
  4. TTL 设为服务端会话时长的 60%,拿得到 token 过期时间就用精确值。
  5. 写操作用例按 worker 分账号,账号数等于并发数。
  6. 把 playwright/.auth/ 加进 .gitignore,state 里有真实 cookie,不能进仓库。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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