javascript fetch api 处理 cors 预检请求的核心在于区分简单请求与非简单请求,并在非简单请求场景下由浏览器自动完成预检流程。当请求方法为 post、put 等且 content-type 为 application/json 时,浏览器会先发送 options 请求获取服务器许可,只有收到允许后才会发送实际业务请求。开发者无需手动编写代码去触发或拦截这个预检过程,只需确保后端正确响应 options 请求并返回必要的 cors 头即可。

如何判断一个 Fetch 请求是否会触发预检
判断依据主要看请求的 Method、Content-Type 以及自定义 Header。如果请求是 GET 或 HEAD,或者 Content-Type 仅为 text/plain、multipart/form-data 或 application/x-www-form-urlencoded,且没有自定义 Header,则属于简单请求,不会触发预检。一旦使用了 JSON 格式提交数据,或者设置了 Authorization 等自定义头,就会触发预检。理解这一机制有助于在开发阶段快速定位跨域问题的根源。

const data = { username: 'test' }; fetch('https://api.example.com/data', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer token123' }, body: JSON.stringify(data) }).then(response => response.json()).then(console.log).catch(console.error);
上述代码中,由于指定了 Content-Type: application/json 和自定义的 Authorization 头,浏览器在发送实际的 POST 请求前,会先向 https://api.example.com/data 发送一个 OPTIONS 请求。如果服务器未配置正确的 CORS 响应头,该预检将失败,导致主请求被浏览器拦截。
后端如何正确响应预检请求以允许后续调用
后端服务器必须能够识别并正确处理浏览器发出的 OPTIONS 请求。对于预检请求,服务器需要返回 HTTP 200 或 204 状态码,并在响应头中包含 Access-Control-Allow-Origin、Access-Control-Allow-Methods 以及 Access-Control-Allow-Headers。这些头部明确告知浏览器,当前源被允许访问资源,且允许使用的 HTTP 方法和请求头字段是什么。只有当预检成功,浏览器才会继续执行后续的实际业务请求。
在代码库出现结构漂移之前,扫描JS或TS代码库中的禁止导入、循环依赖、孤立模块和其他依赖规则违规情况。

// Node.js Express 示例 app.options('/data', (req, res) => { res.setHeader('Access-Control-Allow-Origin', 'https://frontend.example.com'); res.setHeader('Access-Control-Allow-Methods', 'POST, OPTIONS'); res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization'); res.sendStatus(204); });
这段代码展示了如何在服务端针对 /data 路径处理 OPTIONS 请求。通过显式设置允许的来源、方法和头部,确保了前端使用 fetch 发送带有 JSON 数据和认证头的 POST 请求时,能够通过浏览器的预检检查。若缺少任一关键头部,预检均会失败。
预检请求失败时的常见错误与排查步骤
当预检请求失败时,控制台通常会报错 No 'Access-Control-Allow-Origin' header is present on the requested resource 或 Method not allowed。这通常意味着服务器未正确处理 OPTIONS 请求,或者返回的头部不匹配前端发送的请求特征。排查时应首先检查网络面板中的 OPTIONS 请求是否发出,其次确认服务器返回的状态码是否为 2xx,最后核对 Allow-Methods 和 Allow-Headers 是否覆盖了前端请求的具体内容。确保前后端配置一致是解决此类问题的关键。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










