自动化测试 / 系统课时

复用登录状态

复用登录状态

重复执行 UI 登录既慢又容易受验证码、短信或限流影响。更高效的做法是先完成一次可信登录,把 WebDriver 可见的认证 Cookie 保存下来;新浏览器先进入相同域名,再恢复 Cookie 并访问受保护页面验证状态。

学习目标

  • 能用 get_cookies() 把当前会话保存为 JSON,并在新 WebDriver 会话中恢复。
  • 能处理域名、过期时间和恢复顺序,避免 InvalidCookieDomainException。
  • 能判断 Cookie 复用是否真正恢复了登录状态,而不是只验证文件写入成功。

保存登录后的 Cookie

登录成功后调用 driver.get_cookies() 会得到字典列表,常见字段包括 name、value、domain、path、secure、httpOnly、expiry 和 sameSite。其中 expiry 若存在,单位是 Unix 时间戳秒;会话 Cookie 可以没有该字段。

实际项目应在一个明确的登录成功条件后再保存,例如账户头像出现、受保护接口返回成功,或 URL 进入 /dashboard。不要在“点击登录按钮”之后立即保存,否则可能把认证 Cookie 尚未写入的瞬间状态持久化。

按正确顺序恢复

恢复时最关键的顺序是:创建新浏览器 → 先访问 Cookie 所属域名 → 读取 JSON → 跳过已过期 Cookie → 逐个调用 add_cookie() → 刷新或进入受保护页面。add_cookie() 不能把另一个域名的 Cookie 强行写入当前页面,因此域名不匹配会触发 InvalidCookieDomainException。

登录 Cookie 的保存与恢复数据流

若生产站和测试站域名不同,不要通过修改 domain 字段强行复用生产 Cookie。更安全的做法是在对应测试环境单独建立登录状态,因为 Cookie 可能同时受域名、Secure、SameSite 和服务端会话约束。

完整保存与恢复示例

下面用 Selenium 官方测试页模拟“认证 Cookie”。第一次浏览器把 course_session 保存到 cookies.json;第二次浏览器进入同一域名后恢复它。真实项目只需把“人工添加 Cookie”替换成真正的登录步骤,并把最终检查改成受保护页面断言。

python
import json
import time
from pathlib import Path

from selenium import webdriver

URL = "https://www.selenium.dev/selenium/web/blank.html"
COOKIE_FILE = Path("cookies.json")

first = webdriver.Chrome()

try:
    first.get(URL)

    # 模拟登录后由站点写入的认证 Cookie。
    first.add_cookie({
        "name": "course_session",
        "value": "demo-token",
        "path": "/",
        "sameSite": "Lax",
    })

    saved = [
        c for c in first.get_cookies()
        if c["name"] == "course_session"
    ]
    COOKIE_FILE.write_text(
        json.dumps(saved, ensure_ascii=False, indent=2),
        encoding="utf-8",
    )
    print("saved:", len(saved))
finally:
    first.quit()

second = webdriver.Chrome()

try:
    # 必须先进入 Cookie 所属域名,再调用 add_cookie()。
    second.get(URL)
    now = int(time.time())

    cookies = json.loads(COOKIE_FILE.read_text(encoding="utf-8"))
    restored_count = 0

    for cookie in cookies:
        expiry = cookie.get("expiry")
        if expiry is not None and expiry <= now:
            continue
        second.add_cookie(cookie)
        restored_count += 1

    second.refresh()
    restored = second.get_cookie("course_session")

    print("restored count:", restored_count)
    print("restored value:", restored["value"] if restored else None)
finally:
    second.quit()
    COOKIE_FILE.unlink(missing_ok=True)

预期输出:

text
saved: 1
restored count: 1
restored value: demo-token

这个输出证明 Cookie 跨 WebDriver 会话完成了保存与恢复;真实登录测试还必须继续访问受保护页面,确认服务器接受该会话。

把示例改成真实登录复用

真实项目可把保存动作放在登录准备脚本或测试夹具中。例如每天首次运行时正常登录并保存 Cookie,后续用例直接恢复;若访问 /account 后被重定向到 /login,则说明 Cookie 已过期、服务端会话已失效,或系统还依赖 Cookie 之外的认证状态,此时应重新登录并覆盖缓存。

恢复后的验收至少包含两个检查:一是 get_cookie() 能读取关键认证 Cookie;二是进入受保护页面后出现明确的已登录元素,例如账户名或“退出登录”按钮。第二项比单纯比较 Cookie 值更重要,因为服务端可能已经主动吊销同一个令牌。

处理最常见的恢复失败

出现 InvalidCookieDomainException 时,先打印当前 URL 与 Cookie 的 domain,确认已经导航到对应站点;若 Cookie 的 expiry 小于当前 Unix 时间,则直接丢弃并重新登录。若 Cookie 已成功加入但页面仍是未登录状态,再检查应用是否还依赖 localStorage、设备绑定或服务端会话。

这套判断顺序可以把问题快速分成“无法写入 Cookie”“Cookie 已过期”“服务端不接受会话”三类。不要用无限重试掩盖失败;一旦恢复验收不通过,就回到正常登录流程生成新的状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

复用登录状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通