Cypress E2E测试中如何控制请求发送的Cookie范围？

方案1：拦截请求并精准控制Cookie发送 #

使用Cypress的cy.intercept()拦截所有后端请求，在请求发出前过滤掉不需要的Cookie，这种方式对前端原生请求和cy.request()都生效：

// 在cypress/support/e2e.js（或测试入口文件）中添加全局拦截逻辑
cy.intercept('**/*', (req) => {
  // 仅保留access_token，移除其余Cookie
  if (req.headers.cookie) {
    const allowedCookies = req.headers.cookie.split('; ')
      .filter(cookie => cookie.startsWith('access_token='))
      .join('; ');
    req.headers.cookie = allowedCookies || undefined;
  }
}).as('filterCookies');

如果需要完全阻止所有Cookie发送，直接删除请求头中的Cookie字段：

cy.intercept('**/*', (req) => {
  delete req.headers.cookie;
}).as('removeAllCookies');

方案2：调整Cypress浏览器启动参数 #

针对本地localhost环境，在配置文件中修改浏览器启动参数，适配SameSite=strict的Cookie行为：

// cypress.config.js
const { defineConfig } = require('cypress');

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      if (config.baseUrl.includes('localhost')) {
        on('before:browser:launch', (browser = {}, launchOptions) => {
          if (browser.family === 'chromium') {
            // 调整Chromium系浏览器的Cookie处理策略
            launchOptions.args.push('--disable-features=SameSiteByDefaultCookies,CookiesWithoutSameSiteMustBeSecure');
          }
          return launchOptions;
        });
      }
    },
    modifyObstructiveCode: false, // 禁用Cypress对页面代码的默认修改
  },
});

方案3：测试用例中动态清理Cookie #

如果仅需在特定场景下控制Cookie，可在测试前置步骤中清除不需要的Cookie：

beforeEach(() => {
  // 清除新增的两个业务Cookie，保留token类Cookie
  cy.clearCookie('新增Cookie名称1');
  cy.clearCookie('新增Cookie名称2');
});

注意：该方式仅删除会话中的Cookie，若前端页面会自动重新设置，仍可能被发送，建议配合拦截方案使用。

关键提示 #

你遇到的本地环境Cookie异常发送问题，大概率和HTTP协议下SameSite=strict的Cookie行为差异有关——原生浏览器在HTTP环境下对strict Cookie的发送限制更严格，而Cypress内置浏览器的处理逻辑存在区别。优先推荐方案1，它直接在请求层面控制Cookie发送，不受页面Cookie设置的影响，适配范围最广。

内容的提问来源于stack exchange，提问作者Melvin S.