Laravel 10 + Jetstream+Livewire生产环境登录异常问题排查

排查会话配置 #

• 检查.env文件中的SESSION_DRIVER：
  • 若为file驱动，确保storage/framework/sessions目录权限匹配服务器web用户（如www-data），执行命令修复：

    chmod -R 755 storage/framework/sessions
    chown -R www-data:www-data storage/framework/sessions
    

  • 若使用redis等其他驱动，确认服务已启动、配置参数正确，可通过php artisan redis:cli测试连接。

验证Livewire错误渲染逻辑 #

• 打开登录视图文件（默认路径resources/views/auth/login.blade.php），确认包含错误信息渲染代码：

  <x-jet-validation-errors class="mb-4" />
  
  @if (session('status'))
      <div class="mb-4 font-medium text-sm text-green-600">
          {{ session('status') }}
      </div>
  @endif
  

• 清除Livewire组件缓存：

  php artisan livewire:clear
  

修正环境变量与配置缓存 #

• 确保.env中的APP_URL与服务器实际域名完全一致（包含http/https前缀）：

  APP_URL=https://your-production-domain.com
  

• 重新生成配置缓存：

  php artisan config:clear
  php artisan config:cache
  

清理全量缓存 #

• 执行完整缓存清理命令，避免旧缓存干扰：

  php artisan cache:clear
  php artisan route:clear
  php artisan view:clear
  php artisan optimize:clear
  

检查服务器URL重写配置 #

• 若使用Nginx，确认配置文件包含支持Laravel和Livewire的重写规则：

  location / {
      try_files $uri $uri/ /index.php?$query_string;
  }
  
  location ^~/livewire {
      try_files $uri $uri/ /index.php?$query_string;
  }
  

• 配置修改后重启web服务（systemctl restart nginx或systemctl restart apache2）。

确认Jetstream登录逻辑 #

• 若自定义过登录控制器（app/Http/Controllers/Auth/LoginController.php），确保错误凭据处理逻辑保留错误闪存：

  protected function sendFailedLoginResponse(Request $request)
  {
      throw ValidationException::withMessages([
          $this->username() => [trans('auth.failed')],
      ]);
  }
  

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