Laravel8本地环境登录API会话Cookie未存储至浏览器问题

1. 跨域请求的Credentials配置问题 #

如果前端与后端运行在不同端口（比如前端localhost:3000、后端localhost:8000），属于跨域场景，浏览器默认不会保存跨域响应的Cookie，必须满足两个条件：

• 后端配置CORS允许携带凭证
• 前端请求时开启withCredentials

后端CORS配置 #

修改config/cors.php：

return [
    'paths' => ['api/*'],
    'allowed_methods' => ['*'],
    'allowed_origins' => ['http://localhost:3000'], // 替换为你的前端实际地址
    'allowed_origins_patterns' => [],
    'allowed_headers' => ['*'],
    'exposed_headers' => [],
    'max_age' => 0,
    'supports_credentials' => true, // 必须设为true
];

前端请求配置 #

如果使用axios：

axios.post('http://localhost:8000/api/login', loginData, {
    withCredentials: true
})

如果使用fetch：

fetch('http://localhost:8000/api/login', {
    method: 'POST',
    credentials: 'include',
    body: JSON.stringify(loginData),
    headers: {'Content-Type': 'application/json'}
})

2. 会话Cookie的Domain属性验证 #

检查.env中的SESSION_DOMAIN是否与前端域名匹配：

• 若前后端都是localhost（不同端口），SESSION_DOMAIN设为localhost或留空（让Laravel自动适配）
• 避免添加端口号，浏览器会忽略端口匹配Cookie

修改.env后清除配置缓存：

SESSION_DOMAIN=

php artisan config:clear

3. 确认Session中间件加载正确性 #

虽然已在路由添加middleware('session')，仍需确保StartSession中间件被正确加载。检查app/Http/Kernel.php：

protected $middlewareGroups = [
    'web' => [
        // ...
        \Illuminate\Session\Middleware\StartSession::class,
    ],
    'api' => [
        // ...
        \Illuminate\Session\Middleware\StartSession::class, // 若API全局需要session，可添加至此
    ],
];

4. 检查响应Cookie属性 #

打开浏览器开发者工具（Network标签），查看登录请求的响应头Set-Cookie：

• 确认Domain为localhost
• Secure为false（符合配置）
• SameSite为Lax
• HttpOnly为false（与你的session.php配置一致）
  若属性不符，再次清除配置缓存并重启服务测试。

5. 验证会话文件与Cookie对应关系 #

登录后查看storage/framework/sessions下的会话文件，确认文件内包含你设置的key => value，同时对比响应头Set-Cookie中的会话ID是否与文件名一致，确保会话生成逻辑正常。

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