Cucumber 的 BeforeAll 钩子因浏览器启动超时（默认 5000ms）失败，根本原因在于 Playwright 的 setDefaultTimeout 对 Cucumber 无效；需通过 Cucumber 自身配置或改用 @playwright/test 框架统一管理超时。
cucumber 的 `beforeall` 钩子因浏览器启动超时（默认 5000ms）失败，根本原因在于 playwright 的 `setdefaulttimeout` 对 cucumber 无效；需通过 cucumber 自身配置或改用 `@playwright/test` 框架统一管理超时。
该错误并非 Playwright 启动失败，而是 Cucumber 主动终止了耗时过长的钩子函数——其默认全局超时为 5000 毫秒，且与 Playwright 的 setDefaultTimeout 完全无关。你在 launch() 中设置的 setDefaultTimeout: 60 * 1000 仅影响后续 Playwright API 调用（如 page.goto()、locator.click() 等），但无法延长 Cucumber 执行钩子本身的等待时限。
✅ 正确解决方案（二选一）
方案一：配置 Cucumber 超时（推荐用于现有 Cucumber 项目）
在 cucumber.js 或 cucumber.conf.js 配置文件中显式提升 beforeAll 钩子超时：
// cucumber.js
module.exports = {
default: {
// 其他配置...
timeout: '30000', // ← 全局步骤/钩子超时设为 30 秒
}
};
或更精准地为 BeforeAll 单独指定超时（Cucumber v7+ 支持）：
// hooks.js
const { BeforeAll } = require('@cucumber/cucumber');
BeforeAll({ timeout: 30 * 1000 }, async () => {
console.log('Launch Browser');
global.browser = await playwright.chromium.launch({
headless: false,
// ⚠️ 注意：remove setDefaultTimeout — 它在此处无意义
});
console.log('Browser launched successfully');
});
? 提示：Cucumber 的 timeout 选项单位为毫秒，且必须作为第一个参数对象传入钩子函数，不能写在 async 函数体内。
Manikantasai Playwright Automation下载使用Playwright API直接进行浏览器自动化。导航网站、与元素交互、提取数据、截图、生成PDF、录制视频，自动化复杂工作流程。比MCP方法更可靠。
方案二：迁移到 @playwright/test（强烈推荐新项目）
彻底规避 Cucumber 超时耦合问题，利用 Playwright 原生测试框架的声明式生命周期与内置超时机制：
// example.spec.ts
import { test, expect } from '@playwright/test';
test.describe.configure({ timeout: 30000 }); // 整个 describe 超时
test.beforeAll(async ({ browser }) => {
console.log('Browser is auto-managed by Playwright — no manual launch needed');
});
test('login flow', async ({ page }) => {
await page.goto('https://example.com/login');
await page.getByLabel('Username').fill('test');
await page.getByRole('button', { name: 'Sign in' }).click();
await expect(page).toHaveURL(/dashboard/);
});
优势包括：
- ✅ 自动浏览器/上下文/页面生命周期管理（无需 global. 变量）；
- ✅ 超时配置统一、语义清晰（test.setTimeout() / test.describe.configure({ timeout })）；
- ✅ 原生重试、截图、trace、reporter 支持；
- ✅ 类型安全（TypeScript 开箱即用）。
⚠️ 注意事项
- ❌ 不要在 launch() 中传入 setDefaultTimeout — 它不控制启动过程，且已被 Playwright 弃用（v1.40+）；
- ❌ 避免使用 global.browser 等全局变量 — 易引发并发测试污染，@playwright/test 的 fixture 注入机制更健壮；
- ✅ 若坚持使用 Cucumber，请确保所有异步钩子（BeforeAll/Before）均返回 Promise 且未被意外阻塞（如同步死循环、未 await 的 Promise）；
- ✅ 在 CI 环境中，Chromium 启动可能更慢，建议将 timeout 设为 45000 并启用 --no-sandbox（Linux）或 headless: true 加速。
综上，超时本质是测试框架职责边界问题：Cucumber 控制钩子生命周期，Playwright 控制浏览器行为。明确分工、正确配置，即可稳定启动浏览器并执行自动化流程。
