Cypress从SQL Server获取数据后循环执行测试失败的问题

解决方案 #

你的问题核心是Cypress的同步执行机制：describe和it块在测试启动前就会被解析完成，而before钩子是在所有it执行前才运行，导致forEach遍历空数组，没有生成任何测试用例。以下是两种可行的解决方法：

方案1：用Cypress Task在Node环境获取数据（推荐，支持独立测试块）

将SQL查询逻辑移到Node环境（避开Cypress命令链的异步限制），提前获取数据后动态生成每个用户对应的it块。

1. 配置Cypress Task（在cypress.config.js中）

const { defineConfig } = require("cypress");
const sql = require("mssql");

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      on("task", {
        async fetchUsers() {
          // 替换为你的SQL Server连接配置
          const connectionConfig = {
            user: config.env.sqlUser,
            password: config.env.sqlPassword,
            server: config.env.sqlServer,
            database: config.env.sqlDatabase,
            options: {
              encrypt: true,
              trustServerCertificate: true,
            },
          };

          try {
            await sql.connect(connectionConfig);
            // 替换为你的用户查询语句
            const result = await sql.query("SELECT * FROM Users");
            return result.recordset;
          } finally {
            await sql.close();
          }
        },
      });
    },
    env: {
      sqlUser: "你的SQL用户名",
      sqlPassword: "你的SQL密码",
      sqlServer: "你的SQL服务器地址",
      sqlDatabase: "你的数据库名称",
    },
  },
});

2. 编写测试文件

// 提前获取用户数据，确保describe解析前拿到结果
let users = [];

(async () => {
  users = await cy.task("fetchUsers");
})();

describe("用户专属测试", () => {
  users.forEach((user) => {
    it(`验证用户 ${user.username} 的功能`, () => {
      // 这里编写单个用户的测试逻辑
      cy.visit("/login");
      cy.get("#username").type(user.username);
      cy.get("#password").type(user.password);
      cy.get("#submit-btn").click();

      // 验证登录成功
      cy.url().should("include", "/dashboard");
      cy.get(".welcome-text").should("contain", user.username);
    });
  });
});

方案2：在单个测试块内遍历用户（快速实现，无需额外配置）

如果不需要每个用户生成独立的测试报告，可将所有用户测试放在一个it块中，用cy.each遍历数据：

describe("批量用户测试", () => {
  let users;

  before(() => {
    // 假设cy.getUser返回用户数组，若返回单个用户则调整为[value]
    return cy.getUser(1, 0).then((data) => {
      users = Array.isArray(data) ? data : [data];
    });
  });

  it("为所有用户执行测试", () => {
    cy.wrap(users).each((user) => {
      cy.log(`正在测试用户：${user.username}`);
      
      // 测试逻辑示例
      cy.visit("/profile");
      cy.get("#username-display").should("have.text", user.username);
      cy.get("#email-display").should("have.text", user.email);
    });
  });
});

原代码失效原因 #

• Cypress的describe和it是同步解析的，测试启动前就会执行users.forEach，此时before钩子还未运行，users仍是空数组，因此没有生成任何测试用例。
• before钩子的异步逻辑只会在所有it执行前完成，无法影响describe阶段的同步代码。

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