一键将现有自动化测试从Cypress或Selenium迁移到…

# Selenium → Playwright 迁移方案（38个Python测试文件）

一、前期准备

• 环境搭建：安装 pytest-playwright，配置 playwright install（含浏览器内核）；建议Playwright与pytest同项目虚拟环境隔离，避免与Selenium依赖冲突。
• 迁移顺序：按模块分批迁移，建议顺序：工具类/公共封装 → 普通页面模块 → 购物车 → 支付流程（最后做，便于对照验证）。
• 兼容策略：迁移期间保留两套CI任务，旧测试不动，新测试逐个接入，避免“一刀切”导致回归盲区。

二、核心改造点

1. API映射（常见替换）

• driver.get(url) → page.goto(url)
• find_element(By.X, ...) → page.locator(...)，定位策略对应：By.ID→#id、By.CSS_SELECTOR→css=、By.XPATH→xpath=（尽量淘汰）
• WebDriverWait + expected_conditions → Playwright内置自动等待，绝大多数显式等待可直接删除
• switch_to.frame / window → page.frame_locator() / page.context 页面事件
• ActionChains → page.hover() / drag_to()
• select 下拉 → page.select_option()

2. 选择器改造为 data-testid

• 优先规则：page.get_by_test_id("xxx")，先在配置中统一 test_id_attribute（默认是 data-testid，如团队用 data-test 需自定义）。
• 改造流程：

1. 盘点现有CSS/XPath选择器，按页面/组件列清单；

2. 与前端协作在模板中补加 data-testid 属性（购物车条目、结算按钮、支付方式单选、优惠码输入框等是重点）；

3. 替换时删除文本类、动态类名类脆弱定位。

• 无法加属性的老页面，用 get_by_role()（语义化）作为次选。

三、购物车与支付重点处理

• 购物车：涉及数量增减、库存联动，用 expect(locator).to_have_text() 断言最终状态而非中间态；多商品场景用 locator.all() 遍历校验。
• 支付流程：
• 涉及第三方跳转/iframe（收银台、短信验证），用 context.expect_page() 和 frame_locator() 处理；
• 敏感操作（支付提交）在测试环境务必使用沙箱/模拟支付通道，不要打真实接口；
• 增加网络层断言：page.expect_response() 校验下单/支付接口状态码，比纯UI断言更稳。
• 幂等设计：支付用例需可重复执行，每条用例独立创建测试订单，避免依赖历史数据。

四、收尾与验证

• 统一封装 conftest.py：fixture管理登录态（可用 storage_state 复用会话，大幅提速）。
• 接入trace：pytest --tracing=retain-on-failure，失败自动留现场截图+录屏。
• 38个文件全部迁移后，跑一轮全量对比：新旧套件同环境执行，核对通过用例覆盖是否一致，再下线Selenium。