一、withCredentials是什么?

  withCredentials 是浏览器 XMLHttpRequest 或 Fetch API(以及 axios 等基于它们的库)中的一个配置项,作用是控制跨域请求时是否携带 Cookie、HTTP 认证信息等凭证

用更通俗的方式解释:

二、核心作用

它就像一个 "通行证开关":

  • 当设为 true 时:跨域请求会带上当前域名下的 Cookie、HTTP 认证信息(如用户名密码)等 "身份凭证"
  • 当设为 false 时(默认值):跨域请求会自动忽略这些凭证,服务器无法识别你的身份

三、适用场景

  1. 跨域登录状态维持
    比如你的前端在 a.com,后端接口在 b.com

    • 登录成功后,后端会在 b.com 域名下种一个 Cookie 作为登录凭证
    • 后续发请求时,如果 withCredentials: true,浏览器会把这个 Cookie 带给 b.com 服务器,证明 "我已经登录过"
    • 如果不开启,服务器会把你当成未登录用户
  2. 跨域需要认证的接口
    对于需要 HTTP 基础认证(账号密码)、或依赖 Cookie 做权限校验的接口,必须开启这个配置才能正常访问。

四、注意事项

  1. 后端必须配合
    服务器响应头必须包含 Access-Control-Allow-Credentials: true,否则即使前端开了 withCredentials,浏览器也会拒绝接收响应。

  2. 影响跨域范围
    当使用 withCredentials 时,后端 Access-Control-Allow-Origin 不能设为 *(通配符),必须指定具体的前端域名(如 https://a.com)。

  3. 同域请求不受影响
    只有跨域请求时这个配置才起作用,同域名下的请求会自动携带凭证,无需手动设置。

        简单说,withCredentials 就是为了解决 "跨域场景下如何证明我是谁" 的问题,是实现跨域登录状态共享的关键配置。

五、Cookie是什么时候携带上去的

当你设置 withCredentials: true 后,Cookie 的携带是自动的,不需要你手动写任何代码去附加 Cookie

具体来说:

  1. Cookie 由服务器种下
    比如登录成功时,服务器会通过响应头 Set-Cookie: xxx=xxx 把 Cookie 存到浏览器里(这一步是服务器做的,前端不用管)。

  2. 浏览器自动携带
    当你下次用 withCredentials: true 发请求到同一个服务器域名时,浏览器会自动找出该域名下的 Cookie,偷偷加到请求头里发给服务器。

举个例子:

  • 你登录 api.xxx.com 后,浏览器保存了服务器给的 token=abc123 Cookie
  • 之后你用 axios 发请求:
    axios.post('https://api.xxx.com/data', data, {withCredentials: true  // 关键配置
    })
    

  • 浏览器会自动在请求头里加 Cookie: token=abc123,你不用手动写这行代码

你只需要保证两点:

  1. 前端请求时打开 withCredentials: true 开关
  2. 服务器之前已经给浏览器种下了该域名的 Cookie

剩下的携带工作,浏览器会自动完成,不用你手动处理 Cookie 内容。

六、大白话阐述(更好理解)

  withCredentials 就是用来控制 axios 发送请求时,是否带上 Cookie 信息 的开关。

举个例子:

  • 当你登录某个网站后,服务器会给你一个 Cookie 作为 "身份凭证"
  • 之后你再发请求时,如果 withCredentials: trueaxios 就会自动带上这个 Cookie,服务器就能认出你是谁
  • 如果是 false(默认值),就不会带 Cookie,服务器可能会把你当成未登录的新用户

这个参数主要用在 跨域请求 场景,比如你的前端和后端不在同一个域名下时,需要显式设置 withCredentials: true 才能让 Cookie 正常传递,否则跨域请求会丢失 Cookie 信息。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如若转载,请注明出处:http://www.pswp.cn/web/95406.shtml
繁体地址,请注明出处:http://hk.pswp.cn/web/95406.shtml
英文地址,请注明出处:http://en.pswp.cn/web/95406.shtml

如若内容造成侵权/违法违规/事实不符,请联系英文站点网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

window系统使用命令行来安装OpenSSH服务器或客户端

可以通过 PowerShell 命令行来安装,这种方式更直接可靠:以管理员身份打开 PowerShell: 按下 Win S 搜索 “PowerShell”右键点击 “Windows PowerShell”,选择"以管理员身份运行"安装 OpenSSH 客户端: Add-…

vim中常见操作及命令

在 Vim 中为所有行的行首添加相同字符,可以使用以下方法: 方法1:使用 :%s 替换命令(推荐) vim :%s/^/要添加的字符/ 例如要在所有行首添加 #:vim :%s/^/#/ 方法2:使用块选择模式(可视…

开发使用mybatis是用混合模式还是全注解模式

在使用 MyBatis 开发项目时,Mapper 接口是为数据库操作提供最直观的方法,但在实现方式上,我们有两种选择:全注解模式和混合模式。那么,他们有什么区别,应该如何选择?我们一起来讨论一下。一、全…

WS2812灯带效果设计器上位机

软件使用方法介绍:bilibili地址 【免写单片机代码WS2812灯带效果设计软件-哔哩哔哩】 https://b23.tv/xFhxMGm

Docker 容器(二)

Docker四、Docker容器数据卷1.数据卷的主要特点2.卷的共享与继承(1)卷的共享(Sharing)(2) 卷的继承(Inheritance)3.数据卷运行实例五、Dockerfile1.Dockerfile2. 创建一个名为 myubuntu的自定义镜像第 1 步…

PCB基础细节--工艺篇

pcb基础细节(工艺篇) 1. 孔与焊盘2. PCB各层之间的作用3. 阻抗匹配 3.1. 什么是传输线?我们只看特性阻抗,时延以后再说。 在画原理图时,我们把电阻,电容,电感是抽象成一个点了。两边加一个电压&…

信创服务器总死机原因及解决办法

哈喽,你好啊,我是雷工!最近有个项目使用信创的服务器,总是出现死机的情况,联系厂家检查了一下,说是沐创网卡固件较低造成的,让移除网卡或升级固件尝试一下。记得5月份按厂家的说法处理过一台&am…

03_网关ip和端口映射(路由器转发)操作和原理

网关ip和端口映射(路由器转发)操作和原理IP 与端口映射配置全指南:2 种方案搞定外网访问内网一、先搞懂:为什么需要 IP 与端口映射?二、方案一:路由器端口映射(适合有公网 IP,长期稳…

「数据获取」《安徽建设统计年鉴》(2002-2007)(2004、2006缺失)(获取方式看绑定的资源)

01、数据简介《安徽建设统计年鉴》是一部全方位反映安徽省建设事业发展变迁的重要统计资料著作。该书系统收集并精心整理了 2006 年度安徽省城乡建设领域的核心统计数据,涵盖城乡建设固定资产投资、建筑业发展态势、城镇建设推进情况等多个关键方面,为政…

Python/JS/Go/Java同步学习(第一篇)格式化/隐藏参数一锅端 四语言输出流参数宇宙(附源码/截图/参数表/避坑指南/老板沉默术)

🤝 免骂声明: 本文四语言输出流参数经本蜀黎实战整理,旨在提供快速参考指南📝因各语言版本迭代及不同系统环境差异,偶尔可能出现整理不全面之处,实属正常✅欢迎理性交流补充,喷子勿喷——毕竟你…

人工智能助力流感疫苗选择:MIT 团队推出 VaxSeer 系统

每周跟踪AI热点新闻动向和震撼发展 想要探索生成式人工智能的前沿进展吗?订阅我们的简报,深入解析最新的技术突破、实际应用案例和未来的趋势。与全球数同行一同,从行业内部的深度分析和实用指南中受益。不要错过这个机会,成为AI领…

使用 qmake 生成 Makefile,Makefile 转换为 Qt 的 .pro 文件

使用 qmake 生成 Makefile 的完整指南 qmake 是 Qt 提供的构建工具,用于从 .pro 项目文件生成 Makefile。以下是详细的使用方法: 基本使用方法 1. 从 .pro 文件生成 Makefile bash qmake -o Makefile your_project.pro2. 直接运行 qmake(自动…

利用DeepSeek编写验证xlsx格式文件中是否启用sharedStrings.xml对读写效率影响python程序

让他分别用100*10000个单元格有100、1000、10000个不同的1-200字符长的大写英文字母字符串测试. 一开始DeepSeek没有找到启用sharedStrings.xml的写xlsx模块,我自己找了pyxlsbwriter的例子告诉他才改好的。 import os import time import random import string impo…

【C++框架#2】gflags 和 gtest 安装使用

spdlog 安装和使用 1. 概述 介绍:spdlog 是一个高性能、超快速、零配置的 C 日志库,它旨在提供简洁的 API 和丰富的功能,同时保持高性能的日志记录。它支持多种输出目标、格式化选项、线程安全以及异步日志记录。 github 链接:htt…

平衡掌控者-游戏数值战斗设计

一、有效生命值1、计算公式有效生命生命值/(1-伤害减免率)/(1-闪避率)2、前摇和后摇对数值来说,战斗由两大模块组成,一个是战斗公式生效前的战斗攻击流程,一个是战斗公式与自身流程。比如说&…

使用DataLoader加载本地数据 食物分类案例

目录 一.食物分类案例 1..整合训练集测试集文档 2.导入相关的库 3.设置图片数据的格式转换 3.数据处理 4.数据打包 5.定义卷积神经网络 6.创建模型 7.训练和测试方法定义 8.损失函数和优化器 9.训练模型,测试准确率 10.测试模型 之前我们DataLoader加载…

从零开始的python学习——函数(2)

ʕ • ᴥ • ʔ づ♡ど 🎉 欢迎点赞支持🎉 个人主页:励志不掉头发的内向程序员; 专栏主页:python学习专栏; 文章目录 前言 一、变量作用域 二、函数执行过程 三、链式调用 四、嵌套调用 五、函数递归 六、…

RAG 的完整流程是怎么样的?

RAG(检索增强生成)的完整流程可分为5个核心阶段:数据准备:清洗文档、分块处理(如PDF转文本切片);向量化:使用嵌入模型(如BERT、BGE)将文本转为向量&#xff1…

研发文档版本混乱的根本原因是什么,怎么办

研发文档版本混乱的根本原因通常包括缺乏统一的版本控制制度、团队协作不畅、文档管理工具使用不当以及项目需求频繁变化等因素。这些问题使得研发团队在日常工作中容易出现文档版本混乱的情况,导致信息的不一致性、沟通不畅以及开发进度的延误。为了解决这一问题&a…

ChartView的基本使用

Qt ChartView(准确类名 QChartView)是 Qt Charts 模块里最常用的图表显示控件。一句话概括:“它把 QChart 画出来,并自带缩放、平移、抗锯齿等交互能力”。QML ChartView 简介(一句话先记住:ChartView 是 Q…