Playwright中遇CORS错误：无法访问源域名下的登录API该如何解决？

从源地址'https://xxxxx.jp'访问'https://xxxxx.jp/v1/login'的XMLHttpRequest请求被CORS策略阻止：预检请求的响应未通过访问控制检查：请求的资源上不存在'Access-Control-Allow-Origin'头信息。

仅在Playwright运行时触发上述CORS错误，Chrome等常规浏览器无此问题，导致无法登录。已完成以下排查：

• 在采用不同登录机制的其他站点测试，相同测试代码未报错；
• 已在Access-Control-Allow-Methods头中配置OPTIONS方法，避免预检请求返回500错误；
• 已在Access-Control-Allow-Origin头中明确指定触发错误的URL，问题未解决；
• 参照Playwright相关issue配置后，问题依旧存在。

针对性解决建议 #

1. 拦截响应强制注入CORS头 #

利用Playwright的网络拦截能力，在目标接口的响应返回前，手动添加缺失的CORS头，绕过服务器端的配置问题：

// JavaScript示例
await page.route('https://xxxxx.jp/v1/login', async (route) => {
  const originalResponse = await route.fetch();
  const modifiedHeaders = new Headers(originalResponse.headers());
  // 按需添加必要的CORS头
  modifiedHeaders.set('Access-Control-Allow-Origin', 'https://xxxxx.jp');
  modifiedHeaders.set('Access-Control-Allow-Credentials', 'true');
  modifiedHeaders.set('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
  
  await route.fulfill({
    response: originalResponse,
    headers: modifiedHeaders
  });
});

2. 关闭Playwright浏览器的跨域安全检查 #

测试环境下可以通过启动参数直接关闭浏览器的跨域安全机制，快速绕过CORS限制：

// JavaScript示例
const { chromium } = require('playwright');

const browser = await chromium.launch({
  args: [
    '--disable-web-security',
    '--disable-features=IsolateOrigins,site-per-process'
  ]
});

⚠️ 注意：该方案仅适用于测试场景，绝对不能用于生产环境。

3. 捕获网络日志排查真实请求 #

通过Playwright的请求/响应监听，捕获完整的预检（OPTIONS）请求和响应内容，确认服务器端是否真的返回了预期的CORS头：

// 打印预检请求头
page.on('request', req => {
  if (req.method() === 'OPTIONS' && req.url().includes('/v1/login')) {
    console.log('预检请求头:', req.headers());
  }
});

// 打印预检响应头
page.on('response', res => {
  if (res.request().method() === 'OPTIONS' && res.url().includes('/v1/login')) {
    console.log('预检响应头:', res.headers());
    console.log('响应状态:', res.status());
  }
});

如果日志显示服务器未返回配置的CORS头，说明服务器端可能存在UA检测或其他逻辑，仅针对非Playwright请求返回正确头信息。

4. 验证源地址与请求地址的一致性 #

确认浏览器地址栏的源地址（https://xxxxx.jp）与请求接口的地址（https://xxxxx.jp/v1/login）在协议、域名、端口上完全一致，Playwright对跨域的检测逻辑可能比常规浏览器更严格，细微的差异（比如是否带www、端口是否默认）都可能触发错误。

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