Cypress 12中Session测试二次运行失败：元素定位超时故障

核心原因分析 #

Cypress恢复会话时，仅会还原登录状态（Cookie、LocalStorage等），不会自动导航到测试所需页面，也无法保证页面DOM和首次登录后完全一致。这就导致会话恢复后直接查找元素时，页面可能停留在首页或其他非目标页面，自然找不到目标元素。

具体修复方案 #

1. 会话恢复后强制导航到目标页面 #

修改login命令，在会话块外部添加页面访问逻辑，确保无论首次登录还是会话恢复，都进入正确的页面：

Cypress.Commands.add('login', (login_email, login_password)=>{
    cy.session('loginSession', ()=>{
        cy.visit('https://www.telerik.com/')
        cy.get('#onetrust-accept-btn-handler').click()
        cy.get('#js-tlrk-nav-drawer-button').click()
        cy.get('#js-tlrk-nav-not-auth-container > .TK-Aside-Menu-Button').click()
        cy.get('#email').type(login_email)
        cy.get('.btn').click()
        cy.get('#password').type(login_password)
        cy.get('.btn').click()
        // 验证登录成功，确保会话有效
        cy.get('#js-tlrk-nav-auth-container').should('be.visible')
    })
    // 会话恢复后，导航到账户相关页面（根据实际路径调整）
    cy.visit('https://www.telerik.com/account')
})

2. 替换不稳定的元素选择器 #

:nth-child(1) > .link-button依赖DOM结构，极易受页面布局变化影响，换成基于文本或属性的稳定选择器：

// 示例：按按钮文本定位
cy.contains('编辑资料').click()

// 示例：按测试属性定位（如果按钮有data-testid）
cy.get('[data-testid="edit-profile-btn"]').click()

3. 明确Test Isolation配置 #

确保在cypress.config.js中针对e2e测试正确配置：

module.exports = defineConfig({
  e2e: {
    testIsolation: false,
    // 其他配置项...
  },
})

注：关闭testIsolation后，测试间会保留页面状态，需确保测试逻辑无相互干扰。

4. 会话恢复后强制刷新页面（备选） #

如果页面状态异常，可添加刷新操作确保DOM加载完成：

Cypress.Commands.add('login', (login_email, login_password)=>{
    cy.session('loginSession', ()=>{
        // 原登录逻辑...
    })
    cy.visit('https://www.telerik.com/account')
    cy.reload()
})

验证步骤 #

1. 重新运行测试，确认首次登录和会话恢复后都能正确导航到账户页
2. 检查元素选择器是否能稳定定位目标按钮

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