Cypress退出iframe后丢失测试场景无法继续执行如何处理

Cypress测试运行器默认托管初始加载的测试页面上下文，所有非Cypress API触发的顶层页面硬跳转（尤其是从第三方支付iframe域跳回业务域的跨域跳转），会被运行器判定为测试场景意外退出，直接清空步骤执行队列，表现为左侧测试步骤面板停止更新、后续用例逻辑中止，属于Cypress默认安全沙箱和页面生命周期监听逻辑的固有行为，不是测试脚本语法错误。

按优先级从高到低排列：

• 方案1：测试层接管按钮跳转行为（通用无副作用，优先选）
  核心逻辑是阻止按钮默认的硬跳转行为，拿到目标地址后通过Cypress原生的cy.visit触发页面加载，全程保持测试上下文不丢失。 示例代码：

  // 等待支付iframe加载完成，替换选择器为实际业务使用的iframe标识
  cy.frameLoaded('#payment-container iframe')
  // 定位iframe内的「返回应用」按钮
  cy.iframe().find('a, button:contains("返回应用")').as('backBtn')
  
  // 提前绑定点击事件拦截默认跳转
  cy.get('@backBtn').invoke('on', 'click', (e) => {
    e.preventDefault()
    // 读取按钮上配置的回跳地址
    const redirectUrl = e.target.href
    // 用Cypress托管的visit方法加载目标页
    cy.visit(redirectUrl)
  })
  
  // 触发按钮点击
  cy.get('@backBtn').click()
  
  // 后续正常写业务校验逻辑即可
  cy.url().should('include', '/order/pay-result')
  cy.contains('订单支付完成').should('be.visible')
  

  如果按钮配置了target="_blank"触发新标签打开，在绑定事件前加一行移除target属性的逻辑即可：

  cy.get('@backBtn').invoke('removeAttr', 'target')
  

• 方案2：关闭跨域安全限制（仅适用于同根域场景）
  若支付回跳地址和测试访问的业务地址属于同根域，可以在Cypress配置文件中关闭Chrome安全策略，让运行器允许跨域上下文切换：

  // cypress.config.js
  const { defineConfig } = require("cypress");
  module.exports = defineConfig({
    e2e: {
      chromeWebSecurity: false,
      // 保留原有其他配置
    },
  });
  

  注意该配置仅对Chromium内核浏览器生效，跨根域场景下该方案无法解决上下文丢失问题。

不要通过加长等待时间、手动调用页面重载的方式尝试解决该问题。只要顶层跳转不是通过cy.visit/cy.request等Cypress原生API触发，运行器就会主动中止当前用例执行，和页面加载速度无关。

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