jetstream 不支持 laravel 6,最早仅兼容 laravel 8;强行安装会因版本断层报错,如 class "laravel\jetstream\jetstream" not found,且 laravel 6 已于 2022 年 9 月终止安全支持。

为什么 laravel/jetstream 安装会直接报错
执行 composer require laravel/jetstream 时 Composer 会明确拒绝:
laravel/jetstream v4.0.0 requires laravel/framework ^10.0|^11.0(截至 2026 年 9 月,最新稳定版已要求 Laravel 10+)
即使你降级到 Jetstream v1.x(历史最老版本),它最低也要求 laravel/framework ^8.0。Laravel 6 的 illuminate/contracts 和 illuminate/database 签名与 Jetstream 所需的 Eloquent、Pipeline、Route 组件不兼容,PHP 7.2+ 也早被弃用。
Mac 上确认 Laravel 版本和 PHP 环境是否“够格”
别跳过这步——很多报错其实卡在底层环境:
- 运行
php -v:Laravel 6 要求 PHP ≥ 7.2,但 Jetstream 最低要 PHP 8.0+(v1.x)→ 升级 PHP 是硬前提 - 运行
which php:Mac 自带 PHP 已废弃,Homebrew 安装的 PHP(如php@8.2)必须被 shell 正确识别,否则artisan命令看似执行,实则调用旧版本 - 检查
composer show laravel/framework:确认输出是6.x-dev或v6.20.42这类,不是误装成 8.x
替代方案:Laravel 6 应该用什么认证脚手架
Laravel 6 原生推荐且完全兼容的是 Breeze(轻量)、Fortify(无 UI,纯后端逻辑)或手写认证:
-
composer require laravel/breeze --dev→php artisan breeze:install→npm install && npm run dev,5 分钟跑通登录注册 - 若只需 API 认证,用
composer require laravel/fortify+ 手动配config/fortify.php和 Sanctum,不依赖前端框架 - Jetstream 的“团队管理”“两步验证 UI”等高级功能,在 Laravel 6 里没有对应 Hook 机制(如
Jetstream::inertia()),强行复制代码会导致Class 'Laravel\Jetstream\Jetstream' not found
真要 Jetstream?唯一可行路径是升级 Laravel
这不是“配置问题”,而是版本断层。升级前注意:
- Laravel 6 → 7 → 8 是逐级迁移,不能跨大版本直升;Laravel 8 是 Jetstream 首个支持版本,也是最低可行基线
- 升级后需重跑
php artisan migrate,因 Jetstream 新增teams、user_teams、personal_access_tokens等表,Laravel 6 的 migration 结构不兼容 - Mac 上用
valet use php@8.2切换 PHP 版本,再用composer create-project laravel/laravel:^8.0 myapp新建干净项目更稳妥
App\Providers\JetstreamServiceProvider、resources/js/Pages/Auth/Login.vue)和 Laravel 6 的服务容器绑定、Blade 编译流程存在根本性差异,试图 patch 会陷入无限报错循环。升级 Laravel 本身比魔改 Jetstream 兼容性成本更低、更可靠。











