Yii 2无法读取JavaScript设置的Cookie问题求助

嘿，我之前在Yii2开发里也碰到过一模一样的情况！明明浏览器里能看到Cookie存在，但后端代码就是读不到，这大概率是Cookie的属性配置不匹配导致的，咱们一步步来排查解决：

1. 优先检查Cookie的path属性 #

JS设置Cookie时如果没指定path，默认会绑定当前页面的路径。比如你在/user/login页面设置的Cookie，默认path就是/user/login，但如果你的Yii2后端逻辑是在根目录或者其他路径下，就会读不到这个Cookie。

解决方法很简单，设置Cookie的path为根目录/，让它在整个域名下都能被访问：

function setCookie(cname, cvalue, exdays) {
  var d = new Date();
  d.setTime(d.getTime() + (exdays*24*60*60*1000));
  var expires = "expires="+ d.toUTCString();
  // 关键：添加path=/，确保全域名可访问
  document.cookie = cname + "=" + cvalue + ";" + expires + ";path=/";
}

2. 排查domain属性是否匹配 #

如果你的前端页面和Yii2后端不在同一个子域名下（比如前端是www.yourdomain.com，后端是api.yourdomain.com），那必须指定domain属性，让Cookie能在子域名间共享：

// 注意domain前面的点，这样所有子域名都能读取
document.cookie = cname + "=" + cvalue + ";" + expires + ";path=/;domain=.yourdomain.com";

3. 确认没有误加HttpOnly属性 #

这里要注意：HttpOnly是用来禁止JS读取Cookie的，但后端是可以正常读取的。不过如果你在JS设置Cookie时错误地加上了HttpOnly，虽然JS能设置成功，但还是建议检查下你的代码，确保没写错这个属性，避免不必要的混淆。

4. 用调试代码确认后端接收的Cookie #

你当前的判断代码是对的，但可以先打印出所有后端接收到的Cookie，直观确认HELLO是否在其中：

// 打印所有Cookie，方便排查
var_dump(Yii::$app->request->cookies);
// 再执行你的判断逻辑
if(Yii::$app->getRequest()->getCookies()->has('HELLO')) { 
    die("YES COOKIE"); 
} else { 
    die("NO COOKIE"); 
}

5. 排除浏览器缓存或Cookie冲突 #

有时候浏览器会缓存旧的Cookie，或者存在同名的过期Cookie干扰，建议你清空浏览器的Cookie缓存，或者用隐私模式打开页面测试，排除这类问题。另外还要注意Cookie名称的大小写，虽然大部分情况下不区分，但个别环境可能会有影响，确保HELLO的大小写前后一致。

内容的提问来源于stack exchange，提问作者kevinkt