Cypress拦截匹配异常：错误拦截器触发问题排查

1. 查询参数顺序不匹配 #

当选择两个商品时，实际请求的URL中tags[]参数的顺序可能和自定义intercept的Matcher不一致（比如实际请求是tags[]=6289&tags[]=6287，但Matcher写的是tags[]=6287&tags[]=6289）。Cypress使用字符串/glob匹配时会严格校验查询参数的顺序，顺序不符就会匹配失败，请求转而被更早注册、匹配范围更宽泛的getJustcookRecipes拦截。

2. Glob模式对查询参数的匹配失效 #

自定义intercept的Matcher末尾的_fields**写法不符合Cypress的glob匹配规则，无法正确匹配实际请求中_fields参数的具体内容，导致Matcher无法命中目标请求。

3. Intercept匹配顺序的影响 #

getJustcookRecipes是更早注册的intercept，其https://wpsite.com/wp-json/**的glob模式会匹配所有wp-json路径下的请求。当自定义intercept的Matcher无法精确匹配时，Cypress会优先使用第一个匹配成功的getJustcookRecipes。

1. 使用query选项单独匹配查询参数（推荐） #

将路径和查询参数分开匹配，忽略参数顺序，同时保证匹配精度：

// 单个商品的拦截
cy.intercept('GET', 'https://wpsite.com/wp-json/wp/v2/posts', {
  query: {
    tags: ['6287'],
    _fields: /.*/ // 匹配任意_fields参数值
  }
}).as('getRecipesSku(971520)');

// 两个商品的拦截
cy.intercept('GET', 'https://wpsite.com/wp-json/wp/v2/posts', {
  query: {
    tags: ['6287', '6289'], // 匹配两个tag，顺序无关
    _fields: /.*/
  }
}).as('getRecipesSku(971520,971310)');

2. 使用正则表达式匹配整个URL #

通过正则灵活处理参数顺序和通配需求：

// 匹配单个tag请求，忽略_fields参数具体值
cy.intercept('GET', /^https:\/\/wpsite\.com\/wp-json\/wp\/v2\/posts\?tags\[\]=6287&_fields=.*/)
  .as('getRecipesSku(971520)');

// 匹配两个tag请求，忽略tag顺序和_fields参数值
cy.intercept('GET', /^https:\/\/wpsite\.com\/wp-json\/wp\/v2\/posts\?(tags\[\]=6287&tags\[\]=6289|tags\[\]=6289&tags\[\]=6287)&_fields=.*/)
  .as('getRecipesSku(971520,971310)');

3. 调整Intercept注册顺序 #

将自定义intercept的注册提前到apiClient.initialize之前，让精确匹配的规则优先被检查：

// 先注册自定义拦截
cy.intercept(...).as('getRecipesSku(971520)');
cy.intercept(...).as('getRecipesSku(971520,971310)');

// 再初始化默认mock
apiClient.initialize();

4. 缩小getJustcookRecipes的匹配范围 #

修改默认拦截的逻辑，排除需要精确匹配的请求路径：

cy.intercept('GET', 'https://wpsite.com/wp-json/**', (req) => {
  // 让/wp/v2/posts路径的请求交给自定义intercept处理
  if (req.url.includes('/wp/v2/posts')) {
    req.continue();
  } else {
    req.reply([{ ... }]); // 返回默认mock响应
  }
}).as('getJustcookRecipes');

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