宏任务过度积压导致测试超时，本质是事件循环被长时间阻塞，使Playwright无法及时响应页面状态变化或完成断言；表现为waitForSelector、click等操作迟迟不返回并最终超时，需通过Trace Viewer分析主线程火焰图、检查未清理定时器、验证异步退化及环境差异来诊断。
宏任务过度积压导致的测试超时，本质是事件循环被长时间阻塞，使 Playwright 无法及时响应页面状态变化或完成断言。这类问题不会在控制台直接报错“宏任务堆积”，而是表现为：页面看似加载完成、元素已存在，但 waitForSelector、click 或自定义断言迟迟不返回，最终触发全局 timeout（如 30s）。诊断需绕过表象，直击事件循环行为。
观察浏览器主线程是否持续高负载
这是最直观的线索。在 Playwright 测试中启用 trace 并复现失败用例：
- 运行测试时加上
--trace on或配置trace: 'on-first-retry' - 测试失败后执行
npx playwright show-report - 在 Trace Viewer 中切换到 “Performance” 标签页，查看主线程火焰图
- 若发现某段 JS 执行持续占用主线程（>100ms 且无明显 IO 等待），尤其是重复出现的长任务（如大量 DOM 操作、未分片的数组遍历、同步 Canvas 渲染），即为宏任务积压信号
检查是否存在未清理的定时器或轮询逻辑
前端代码中残留的 setInterval、反复 setTimeout 或 MutationObserver 回调，会在测试期间持续触发，抢占事件循环资源：
PigX UI 前端开发
下载
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 在测试前注入调试脚本，统计活跃定时器数量：
await page.evaluate(() => { return { intervals: window['__intervalCount'] || 0, timeouts: window['__timeoutCount'] || 0 } }); - 检查被测页面是否在组件卸载/路由离开时遗漏
clearInterval或clearTimeout - 特别关注埋点 SDK、性能监控脚本、实时消息心跳等第三方逻辑——它们常在测试环境下持续运行，却在生产中因用户行为自然中断
验证异步操作是否意外退化为同步执行
某些看似异步的 API，在特定条件下会同步执行并阻塞线程，例如：
立即学习“前端免费学习笔记（深入）”；
-
requestIdleCallback在空闲时间不足时可能延迟执行，甚至被跳过；若测试逻辑依赖它推进状态，就会卡住 - 大量
Promise.then链未被正确 await，导致微任务队列暴涨，间接拖慢宏任务调度（虽非直接原因，但会加剧表现） - 使用
document.write、sync XHR（已废弃但旧代码可能存在）、或强制重排重绘（如连续读取offsetHeight后立即修改样式）都会引发同步布局抖动，延长单个宏任务耗时 - 可在 Trace 的 “Layout” 和 “Paint” 时间轴中查看是否出现密集、重复的 Layout → Paint → Composite 循环
隔离前端业务逻辑，确认是否由测试环境触发
宏任务积压常在测试环境被放大，因为：
- 开发模式下 React/Vue 的严格模式、警告日志、源码映射等额外开销
- Mock 服务（如 MSW）拦截请求后未及时 resolve，导致后续依赖该数据的定时器反复尝试
- 测试中未关闭自动刷新、自动保存、实时校验等交互增强功能
- 建议在测试启动时注入一段“环境净化”脚本：
await page.addInitScript(() => { clearInterval(window.__testInterval); window.__testInterval = null; });
