跨域请求经常遇到需要携带 cookie 的场景,为了确保跨域请求能够携带用户的认证信息或其他状态,浏览器提供了 withCredentials 这个属性。
如何在 Axios 中使用 withCredentials
为了在跨域请求中携带 cookie,需要在 Axios 配置中设置 withCredentials 为 true。
全局设置:
bash
import axios from 'axios';
// 配置 axios 默认选项
axios.defaults.withCredentials = true; // 启用跨域请求时携带 cookie
// 或者在单独的请求中设置
axios.get('https://api.example.com/data', {
withCredentials: true, // 也可以在请求中单独设置
})
.then(response => {
console.log(response.data);
})
.catch(error => {
console.error(error);
});
局部设置:
bash
import axios from 'axios';
axios.get('https://api.example.com/data', {
withCredentials: true, // 确保跨域请求时携带 cookie
})
.then(response => {
console.log('响应数据:', response.data);
})
.catch(error => {
console.error('请求错误:', error);
});
后端:如何配置 CORS 以支持跨域请求携带 cookie:
前端配置好 withCredentials 后,后端需要确保响应头正确配置,以允许跨域请求携带 cookie。
- 设置 Access-Control-Allow-Origin
Access-Control-Allow-Origin 头告诉浏览器哪些域是被允许跨域访问的。如果要支持跨域携带 cookie,这个头不能设置为 *,而必须指定一个明确的域。
bash
Access-Control-Allow-Origin: https://www.example.com
- 设置 Access-Control-Allow-Credentials
Access-Control-Allow-Credentials 头需要设置为 true,以允许浏览器在跨域请求中携带 cookie。
bash
Access-Control-Allow-Credentials: true
- 设置 SameSite 和 Secure 属性
为了确保 cookie 在跨域请求中能正常发送,服务器设置的 cookie 必须带上合适的 SameSite 和 Secure 属性:
SameSite=None:确保 cookie 在跨站请求时也会被发送。
Secure:要求 cookie 只能通过 HTTPS 协议发送。
bash
Set-Cookie: user=JohnDoe; SameSite=None; Secure; domain=.example.com; path=/;