0

0

javascript如何与后端API交互_cors和预检请求如何处理【教程】

幻影之瞳

幻影之瞳

发布时间:2026-01-19 21:46:02

|

499人浏览过

|

来源于php中文网

原创

fetch触发options预检当使用put/delete等非常规方法、含自定义请求头或非标准content-type时;前端可降级为简单请求规避,但需后端配合,且credentials需显式设为include并配对应响应头。

javascript如何与后端api交互_cors和预检请求如何处理【教程】

JavaScript 无法绕过浏览器的同源策略直接请求不同源的后端 API,CORS 不是前端能“解决”的问题,而是必须由后端配置响应头;但前端可以主动规避预检(preflight)或适配其行为。

为什么 fetch 会触发 OPTIONS 预检请求

fetch 发出的请求满足以下任一条件时,浏览器会在发实际请求前自动发送一个 OPTIONS 请求(即预检):

  • 使用了除 GETHEADPOST 之外的 HTTP 方法(如 PUTDELETE
  • 设置了自定义请求头(如 AuthorizationX-Request-ID
  • Content-Type 不是以下三种之一:text/plainmultipart/form-dataapplication/x-www-form-urlencoded

预检失败(如后端未返回 Access-Control-Allow-Origin 等头)会导致整个请求被浏览器拦截,控制台报错 Failed to fetchNo 'Access-Control-Allow-Origin' header

如何让前端不触发预检(简单场景适用)

如果后端暂时无法改 CORS 配置,可尝试让请求“降级”为简单请求:

立即学习Java免费学习笔记(深入)”;

一帧秒创
一帧秒创

基于秒创AIGC引擎的AI内容生成平台,图文转视频,无需剪辑,一键成片,零门槛创作视频。

下载
  • POST 代替 PUT/DELETE,并在 body 中传 {_method: "PUT"}(需后端配合解析)
  • 避免设置 Authorization 头,改用 query 参数或 cookie(前提是后端支持且 cookie 已开启 withCredentials
  • 传 JSON 时不要手动设 Content-Type: application/json,改用 JSON.stringify() + 默认 text/plain(但后端可能无法解析,慎用)
  • 若必须传 JSON 且要免预检,唯一合规方式是后端把 Content-Type: application/json 加入 Access-Control-Allow-Headers

fetch 中正确处理 withCredentials 和 credentials

当需要携带 Cookie 或认证信息时,credentials 选项不能省略或设为 "omit"

fetch('https://api.example.com/data', {
  method: 'GET',
  credentials: 'include' // 必须显式写,不能依赖默认值
})

同时后端响应头必须包含:

  • Access-Control-Allow-Origin: https://your-frontend-domain.com(不能为 *
  • Access-Control-Allow-Credentials: true

漏掉任意一项,浏览器都会拒绝响应。注意:本地开发时 http://localhost:3000http://127.0.0.1:3000 被视为不同源,也需分别配置。

调试预检失败最有效的三步

遇到 CORS 报错,别急着改前端代码:

  • 打开浏览器 DevTools → Network → 找到那个 OPTIONS 请求 → 看 Response Headers 是否含 Access-Control-Allow-OriginAccess-Control-Allow-MethodsAccess-Control-Allow-Headers
  • 检查该 OPTIONS 响应状态码是否为 200(不是 404405
  • 确认后端是否对 OPTIONS 请求做了特殊拦截(如某些框架默认不处理,或中间件跳过了 preflight)

很多“前端调不通”的问题,根源是后端没真正响应 OPTIONS,或者响应头拼写错误(比如写成 Access-Control-Allow-Orgin)。预检这一步,前端只能观察和适配,没法替后端兜底。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

182

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

226

2025.12.18

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

455

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

546

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

334

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

82

2025.09.10

cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

6500

2023.06.30

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

368

2023.11.23

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 3.4万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号