Playwright存储认证状态过期问题：是否需手动更新机制？

核心结论 #

Playwright不会自动检测并更新过期的共享认证状态，你需要自行实现认证状态的更新机制。

具体说明 #

• 官方的共享认证方案是将认证状态序列化后存储（比如保存为文件），测试前直接加载该预存状态。如果状态过期，加载后访问系统会直接触发权限错误，Playwright不会主动重新执行登录流程。
• 针对5分钟超时的场景，有两种实用解决方案：
  1. 每次测试前重新登录：虽然会增加少量测试耗时，但能彻底避免过期问题，适合对测试速度要求不极高的场景。
  2. 添加状态校验与自动刷新逻辑：
     • 在测试启动前，先加载已存储的认证状态，然后访问一个用于校验登录状态的轻量页面/接口（比如个人信息页）。
     • 如果校验失败（比如未找到登录态标识、返回401状态码），则自动重新执行登录流程，更新存储的认证状态后再启动测试。
     • 可以把这套校验+刷新逻辑封装成工具函数，在所有测试用例的前置钩子中调用。

参考代码示例 #

以下是用Playwright测试钩子实现校验逻辑的示例（以JavaScript为例）：

import { test as base } from '@playwright/test';

// 封装带有认证状态校验的page
const test = base.extend({
  authenticatedPage: async ({ page }, use) => {
    // 加载预存的认证状态
    await page.context().storageState({ path: 'auth.json' });
    // 跳转到登录校验页面
    await page.goto('/user/profile');
    // 根据系统实际情况，判断是否处于登录状态
    const isLoggedIn = await page.locator('#user-avatar').isVisible();
    
    if (!isLoggedIn) {
      // 重新登录并更新认证状态文件
      await page.goto('/login');
      await page.locator('#username').fill('your-username');
      await page.locator('#password').fill('your-password');
      await page.locator('button[type="submit"]').click();
      // 保存新的认证状态
      await page.context().storageState({ path: 'auth.json' });
    }
    // 将处理后的page传递给测试用例
    await use(page);
  },
});

// 测试用例使用封装后的authenticatedPage
test('业务功能测试', async ({ authenticatedPage }) => {
  await authenticatedPage.goto('/target-business-page');
  // 编写测试逻辑...
});

内容的提问来源于stack exchange，提问作者Digid3vil