使用Cypress.IO访问SalesForce时登录后测试中断该如何解决

核心原因 #

当前测试卡住的核心原因有两点：

1. SalesForce登录流程涉及多域名跨域跳转，Cypress默认的同源安全策略会阻断跳转后的命令执行
2. 直接通过cy.request拼接账号密码的登录方式不符合SalesForce的安全登录逻辑，且元素选择器过于脆弱、未适配SalesForce Lightning页面的Shadow DOM结构

具体修复步骤 #

• 第一步：调整Cypress全局配置
  在cypress.config.js（旧版本为cypress.json）中添加以下配置：

const { defineConfig } = require('cypress')

module.exports = defineConfig({
  e2e: {
    chromeWebSecurity: false, // 关闭跨域安全限制，适配SalesForce多域名跳转
    experimentalSessionAndOrigin: true, // 开启跨域会话支持
    includeShadowDom: true // 适配SalesForce Lightning页面的Shadow DOM结构，可直接选中内部元素
  }
})

注意：chromeWebSecurity: false仅适用于内部测试场景，不要在涉及公网不可信站点的测试中开启

• 第二步：使用cy.session管理登录态，替换原有登录逻辑
  Cypress官方推荐用cy.session处理跨域系统的登录状态留存，避免每次用例重复登录，也能解决跨域跳转后的上下文丢失问题，修正后的代码示例如下：

/// <reference types="Cypress"/>

describe("访问SalesForce测试", function() {
  // 建议将登录信息存到cypress环境变量，避免硬编码
  const sfUrl = "https://test.lightning.force.com";
  const username = Cypress.env('SF_USERNAME') || "user@compnamy.com.ecommerce";
  const password = Cypress.env('SF_PASSWORD') || "password";

  // 封装复用登录逻辑
  const loginToSalesForce = () => {
    cy.session('sf-login', () => {
      cy.visit(sfUrl);
      // 优先用name、aria-label等稳定属性定位元素，不要用索引eq
      cy.get('input[name="username"]').type(username);
      cy.get('input[name="pw"]').type(password);
      cy.get('input[type="submit"]').click();
      // 显式等待登录完成，确认进入SalesForce首页后再执行后续操作，超时时间适配沙盒加载速度
      cy.get('[title="App Launcher"]', {timeout: 30000}).should('be.visible');
    }, {
      cacheAcrossSpecs: true // 跨用例文件复用登录态
    })
  }

  it("成功访问SalesForce并执行后续操作", function() {
    loginToSalesForce();
    cy.visit(sfUrl);
    
    // 后续操作可正常执行
    cy.reload();
    cy.log("Hello, world!");
  });
});

• 额外注意事项：
  • 不要用索引eq(n)选择元素，SalesForce页面渲染时元素顺序可能发生变化，优先用name、data-id、aria-label等稳定属性定位
  • 涉及SalesForce页面操作的超时时间可以适当拉长，沙盒加载速度通常较慢，默认4秒超时容易报错
  • 账号密码建议存在cypress.env.json或者CI环境变量中，不要硬编码在测试代码里避免泄露

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