排查Cypress E2E测试性能缓慢问题及下一步排查建议

1. 修正日志准确性，解决Promise异步时间差问题 #

• 替换普通console.log为Cypress原生cy.log()，因为Cypress命令队列是异步执行的，普通日志会脱离命令流提前输出，导致时间线失真。将日志语句改为cy.log('after visiting the country page')，让日志严格跟随命令执行顺序，确保耗时区间的准确性。
• 手动添加时间戳辅助验证：在关键节点执行cy.then(() => cy.log(Timestamp: ${Date.now()}))，通过计算时间戳差值确认真实耗时，排除日志异步导致的误判。

2. 排查Cypress内部等待机制 #

• 检查cy.visit()的默认等待逻辑：Cypress会等待页面load事件完成，若页面存在大量第三方异步资源（如统计脚本、广告SDK），会触发长时间等待。可通过cy.visit(url, { timeout: 5000 })缩短超时时间，或用onBeforeLoad钩子拦截不必要的资源请求，验证是否减少耗时。
• 查看远程环境的命令日志：开启Cypress完整日志输出（远程运行时添加--record参数），重点查看cy.visit()到测试启动之间的自动等待行为，比如是否存在cy.get()等待元素超时、未处理的API请求等待等隐性延迟。
• 临时调整默认超时配置：在cypress.config.js中设置defaultCommandTimeout: 2000，或在特定命令后添加{ timeout: 1000 }，若耗时明显缩短，即可定位为自动等待超时导致的问题。

3. 远程环境（Docker+Linux+Firefox）专属优化排查 #

• 调整容器资源限制：Docker容器和GitHub Actions默认分配的CPU、内存有限，尝试在Docker启动时添加--cpus 2 --memory 4g参数，或在GitHub Actions workflow中指定runs-on: ubuntu-latest-xl这类高资源实例，验证是否因资源不足导致性能瓶颈。
• 优化Firefox启动参数：在Cypress配置中为Firefox设置启动参数，比如--headless=new（新版无头模式性能更优）、--disable-gpu、--no-sandbox，减少渲染和资源占用。
• 使用官方Cypress镜像：替换自定义Docker镜像为cypress/included:13.15.1，避免因依赖冗余、环境配置不当引发的性能问题。

4. 代码层面的异步逻辑检查 #

• 排查测试中的未跟踪Promise：若cy.visit()后使用了普通then()包裹异步操作但未返回Promise，会导致Cypress无法跟踪异步状态，出现无意义等待。确保所有异步逻辑都用Cypress命令封装，或在then()中正确返回Promise。
• 临时禁用全局钩子：暂停beforeEach/afterEach中的全局操作（如重复登录、数据清理），仅保留当前测试的必要钩子，验证耗时是否降低，排查全局操作带来的延迟。
• 拦截第三方请求：用cy.intercept()阻止页面中非必要的第三方脚本（如广告、统计）加载，或返回mock数据，排除外部资源对测试性能的影响。

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