Laravel检测用户首次访问配置失效 反复触发首次访问页面问题排查

核心问题及修复方案 #

问题1：类型不匹配导致判断失效 #

你数据库中first_visit定义为布尔类型，但代码里给session赋值的是字符串类型的'false'。PHP中非空字符串做布尔判断时会被识别为true，所以@if($first_visit)永远命中if分支，这是你需要加!才会显示常规首页的核心原因。
另外你第一段中间件存在语法错误：session(['first_visit => 'false'])中箭头写到了引号内，会把first_visit => false整体识别为键名，完全不符合预期。

问题2：逻辑写反 #

你第一段中间件的逻辑是：如果session存在first_visit就设为false，不存在就设为true，和你“首次访问默认true、访问后改false”的需求完全相反。

问题3：缺失默认值 fallback 逻辑 #

仅在数据库sessions表新增字段，Laravel的session读取不会自动同步该字段的默认值，需要你手动处理初始值的兜底逻辑。

具体修复步骤 #

1. 只保留后置中间件，修正逻辑：

public function handle(Request $request, Closure $next)
{
    $response = $next($request);
    // 首次访问完成后将标记设为布尔型false，不要用字符串
    if (session()->get('first_visit', true)) {
        session()->put('first_visit', false);
    }
    return $response;
}

注意要将该中间件注册到web中间件组，否则session不会生效。

2. 修正控制器读取逻辑，添加默认值：

public function first_visit(Request $request)
{
    // 第二个参数为兜底默认值，首次读取不到session时默认返回true
    return view('welcome', [
        'first_visit' => session('first_visit', true)
    ]);
}

3. 修正Blade判断逻辑：

@if($first_visit)
    {{-- 首次访问的密钥设置页面 --}}
@else
    {{-- 常规首页 --}}
@endif

4. 修复first_visit反复变回true的问题
   该问题由两个原因导致：旧的错误中间件每次访问都会重置first_visit为true；用字符串'false'存值导致后续判断逻辑异常。按上面代码修改后即可解决，如果仍复现，检查是否有其他逻辑重置session、或是session驱动配置错误导致数据未持久化。

内容的提问来源于stack exchange，提问作者Daniel Neonzz Young