如何在cypress-cucumber-preprocessor并行测试中实现多用户登录

核心问题分析 #

• 应用特性：同一用户在不同浏览器登录时，首个会话会被强制登出
• 单用户并行测试时，新启动的测试会话会踢掉现有会话，直接导致测试失败

多用户并行测试实现方案 #

1. 准备多测试用户池 #

• 提前在应用后台创建一批测试专用账号，比如test_user_1到test_user_n，数量建议≥并行执行的容器/进程数
• 将用户信息（用户名、密码）存储在环境变量或配置文件中，比如在cypress.env.json中维护：

  {
    "testUsers": [
      {"username": "test_user_1", "password": "test_pass_1"},
      {"username": "test_user_2", "password": "test_pass_2"},
      {"username": "test_user_3", "password": "test_pass_3"}
    ]
  }
  

2. 为并行测试分配独立用户 #

• 利用Cypress的并行模式结合进程/容器编号，为每个并行实例分配唯一用户
• 在Cucumber登录步骤的定义文件中，通过环境变量获取当前实例的用户索引，从用户池中取出对应账号：

  // 示例：loginSteps.js
  import { Given } from 'cypress-cucumber-preprocessor/steps';
  
  Given('用户登录系统', () => {
    const userIndex = Cypress.env('TEST_USER_INDEX') || 0;
    const targetUser = Cypress.env('testUsers')[userIndex];
    
    cy.visit('/login');
    cy.get('#username-input').type(targetUser.username);
    cy.get('#password-input').type(targetUser.password);
    cy.get('#login-btn').click();
  });
  

3. Jenkins + Docker 环境下的并行配置 #

• 在Jenkins流水线中启动多个Docker容器并行执行测试，每个容器传递唯一的TEST_USER_INDEX环境变量
• Jenkinsfile示例片段：

  pipeline {
    agent any
    stages {
      stage('并行执行测试') {
        parallel {
          stage('测试实例1') {
            steps {
              sh 'docker run -e TEST_USER_INDEX=0 -v $(pwd)/tests:/app/tests cypress/included:13.6.0'
            }
          }
          stage('测试实例2') {
            steps {
              sh 'docker run -e TEST_USER_INDEX=1 -v $(pwd)/tests:/app/tests cypress/included:13.6.0'
            }
          }
          stage('测试实例3') {
            steps {
              sh 'docker run -e TEST_USER_INDEX=2 -v $(pwd)/tests:/app/tests cypress/included:13.6.0'
            }
          }
        }
      }
    }
  }
  

• 也可通过动态生成并行任务的方式，根据用户池数量自动创建对应数量的容器，避免硬编码

4. 结合cypress-cucumber-preprocessor的优化 #

• 利用tags或splitTests配置，将测试文件/场景分组分配到不同并行实例，保证每个实例的测试用例都使用专属用户
• 避免在单个.feature文件中编写过多依赖同一用户的场景，拆分后分配到不同实例

额外优化建议 #

• 测试完成后调用登出接口清理会话，避免用户账号被系统锁定
• 定期校验测试用户池的可用性，及时更新失效账号
• 在Jenkins中添加失败重试机制，避免因偶发的用户分配冲突导致测试失败

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