PHP跨域请求携带Cookie失败的根本原因是前后端配置未严格匹配：前端需设credentials: 'include'，后端须同时设置非通配符Access-Control-Allow-Origin和Access-Control-Allow-Credentials: true，并将Cookie的SameSite设为None且Secure为true。
PHP跨域请求携带 Cookie 失败，核心原因是浏览器的同源策略与服务端响应头不匹配，不是 PHP 本身限制，而是 fetch 或 XMLHttpRequest 发起请求时未声明凭证，且服务端未正确设置 Access-Control-Allow-Credentials 和 Access-Control-Allow-Origin。
前端发起请求时必须显式开启 credentials
即使后端已配置正确，前端若没告诉浏览器“我要传 Cookie”，浏览器直接忽略 Cookie。常见错误是漏掉 credentials: 'include'（fetch）或 withCredentials: true（XMLHttpRequest）。
示例（fetch）：
fetch('https://api.example.com/login', {
method: 'POST',
credentials: 'include', // 必须！不能是 'same-origin' 或省略
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ user: 'a', pass: 'b' })
});
注意：credentials: 'include' 要求后端 Access-Control-Allow-Origin 不能为 *，必须指定具体域名（如 https://myapp.com）。
立即学习“PHP免费学习笔记（深入）”；
PHP 后端必须同时设置两个关键响应头
只设 Access-Control-Allow-Credentials: true 不够，它必须和一个**非通配符**的 Access-Control-Allow-Origin 配套出现，否则浏览器直接拒绝响应。
在 PHP 中（如入口文件或中间件），需输出：
header('Access-Control-Allow-Origin: https://myapp.com'); // 必须写明具体协议+域名
header('Access-Control-Allow-Credentials: true');
header('Access-Control-Allow-Methods: GET, POST, OPTIONS');
header('Access-Control-Allow-Headers: Content-Type, X-Requested-With');
- 如果前端域名是
http://localhost:3000，这里就得写http://localhost:3000，不能写localhost:3000（缺协议） - 开发环境常因 HTTP/HTTPS 混用失败：前端用 HTTPS，后端用 HTTP，或反之——协议、端口、子域都算不同源
- 不要在响应中重复设置这些头（例如 Nginx 已设，PHP 又设一次），可能被覆盖或触发警告
Cookie 自身属性必须兼容跨域场景
即使请求头和响应头全对，Cookie 若带了不兼容的属性，浏览器也不会发送它。
PHP 设置 Cookie 时，必须显式指定：
setcookie('session_id', $value, [
'expires' => time() + 3600,
'path' => '/',
'domain' => '.example.com', // 注意开头的点，表示允许子域共享
'secure' => true, // 如果前端是 HTTPS，则必须设 true
'httponly' => true,
'samesite' => 'None' // 关键！跨域必须为 'None'，且必须搭配 'secure'
]);
-
samesite=None是跨域携带 Cookie 的硬性要求，但 Chrome 80+ 强制要求它必须和secure共存 -
domain值不能是顶级域名（如com或org），也不能带端口；应为.example.com这种可被子域继承的格式 - 如果后端是
api.example.com，前端是www.example.com，两者共用.example.com才能互通 Cookie
调试时最容易忽略的三个点
很多问题卡在细节，而非逻辑：
- 浏览器开发者工具 Network 面板里，检查请求的
Request Headers是否真有Cookie字段（没发出去就别查后端） - 查看响应头中
Access-Control-Allow-Origin的值是否和前端地址**完全一致**（含http/https、www、端口号） - PHP 的
session_start()默认会生成 Cookie，但它不自动加SameSite=None和Secure，必须手动覆盖：ini_set('session.cookie_samesite', 'None');+ini_set('session.cookie_secure', '1');
跨域带 Cookie 看似简单，实则每个环节都依赖精确匹配：前端声明、服务端响应头、Cookie 属性、协议一致性，缺一不可。任意一环写错字符或漏掉标志位，都会静默失败。
