ThinkPHP多子域Cookie无法共享的根本原因是默认domain为完整域名，解决需统一设为'.example.com'并确保HTTPS；手动写入时必须显式指定domain；开发环境须用test.example.com替代localhost调试。
如果您在 ThinkPHP 项目中启用了多子域（如 www.example.com、api.example.com、admin.example.com），但 Cookie 无法在各子域间共享，则很可能是由于 Cookie 的 domain 属性未正确配置。以下是解决此问题的步骤：
一、统一设置全局 Cookie domain 值
ThinkPHP 默认将 Cookie 的 domain 设为当前完整主机名（例如 www.example.com），导致其他子域无法读取该 Cookie。必须显式将其设为带前导点号的根域名，使浏览器识别为跨子域有效。
1、打开 config/app.php 文件，定位到 'cookie' => [] 配置块。
2、确保其中包含 'domain' => '.example.com'（注意开头的英文句点）。
3、确认 'path' => '/'，避免路径限制导致子域路径不可见。
4、若部署于 HTTPS 环境，同步设置 'secure' => true，否则浏览器拒绝写入带 domain 的跨域 Cookie。
二、手动写入 Cookie 时显式指定 domain
当使用 Cookie::set() 或 cookie() 辅助函数动态写入 Cookie 时，框架不会自动继承全局 domain 配置，必须在选项中显式传入，否则以手动值为准。
1、在控制器中调用 Cookie::set() 时，传入完整选项数组。
2、写法示例：Cookie::set('token', 'abc123', ['domain' => '.example.com', 'expire' => 3600, 'secure' => true, 'httponly' => true])。
3、若使用辅助函数 cookie()，同样需传入第三参数选项：cookie('user_id', 1001, ['domain' => '.example.com'])。
4、严禁混用不同 domain 值——例如一个 Cookie 设为 'domain' => 'www.example.com'，另一个设为 '.example.com'，将导致覆盖冲突或读取失败。
三、开发环境绕过 localhost 限制
浏览器禁止对 localhost 设置带 domain 的 Cookie（即使设为 '.localhost' 也无效），这是硬性安全策略，非框架缺陷。必须切换至可配置 domain 的测试域名。
1、修改本地 hosts 文件，添加映射：127.0.0.1 test.example.com。
2、Nginx 或 Apache 配置中新增 server_name test.example.com，指向项目根目录。
3、将浏览器访问地址由 http://localhost 改为 http://test.example.com。
4、此时可在 config/app.php 中安全设置 'domain' => '.example.com' 并正常调试跨子域 Cookie 行为。
四、验证 domain 是否生效
仅查看响应头中的 Set-Cookie 字段不足以确认 domain 生效，需检查浏览器实际存储的 Cookie 属性。关键验证点是 domain 字段是否显示为 .example.com（含前导点）且 path 为 /。
1、在 Chrome 浏览器中按 F12 打开 DevTools，切换至 Application → Cookies 标签页。
2、左侧选择当前访问的子域（如 api.example.com）。
3、右侧列表中找到目标 Cookie，双击查看 detail，确认 Domain 列值为 .example.com。
4、在同一浏览器中切换至另一子域（如 www.example.com），刷新后检查该 Cookie 是否仍存在且可被 Cookie::get() 正确读取。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
