Laravel注册自动登录后刷新页面Auth::check()返回false问题排查

1. 注册接口未加载Session中间件（最高概率原因） #

Laravel 中定义在routes/api.php下的路由默认使用api中间件组，该组默认不包含StartSession、AuthenticateSession等会话相关中间件。你当前的注册接口路径为/api/v1/list/register，大概率归类在API路由下，即使控制器中调用了Auth::login($user)，由于没有Session中间件负责持久化会话、返回会话Cookie给前端，登录状态仅在当前请求生效，不会被保存下来，刷新页面后自然无法获取登录态。

解决方法： #

• 优先将注册接口迁移到routes/web.php中，Web路由默认加载会话相关中间件，可正常持久化登录状态
• 若必须放在API路由下，可给对应路由单独添加web中间件：

// routes/api.php
Route::post('/v1/list/register', [YourController::class, 'register'])->middleware('web');

2. Axios未配置携带Cookie #

如果前后端域名、端口不一致存在跨域，需要给Axios开启withCredentials配置，否则前端不会接收后端返回的会话Cookie，也不会在后续请求中携带Cookie，导致登录态失效。

解决方法： #

全局配置或者单请求添加配置即可：

// 全局配置（推荐，一次配置所有请求生效）
axios.defaults.withCredentials = true;

// 单请求配置
axios.post('/api/v1/list/register', {
  email: this.data.email, 
  password: this.data.password
}, {
  withCredentials: true
})

3. Session配置不匹配运行环境 #

检查config/session.php中的配置项是否符合你的实际运行环境：

• domain：需和前端访问的域名完全匹配，否则Cookie会被浏览器拦截
• secure：如果站点是HTTPS访问需设置为true，HTTP访问则设为false
• same_site：推荐设置为lax，避免跨站Cookie被浏览器安全策略拦截
  另外检查app/Http/Kernel.php中web中间件组是否包含以下默认中间件，缺失的话需补充：

\Illuminate\Session\Middleware\StartSession::class,
\Illuminate\View\Middleware\ShareErrorsFromSession::class,

额外优化建议 #

注册登录成功后建议新增会话再生逻辑，避免会话固定攻击：

Auth::login( $user );
request()->session()->regenerate(); // 新增该行

return response()->json([
    'user' => Auth::user(), 
]);

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