Laravel 8 中必须通过 Jetstream 脚手架启用现代化功能:需满足 PHP ≥ 8.0、Node.js ≥ 16.14,执行 composer require laravel/jetstream、php artisan jetstream:install livewire(或 inertia)、php artisan key:generate、php artisan migrate、npm install && npm run dev 后方可访问 /login。

要在 Laravel 8 中快速启用用户认证、团队管理、API 支持和双因素验证等现代化功能,必须正确配置 Jetstream 脚手架——它不是装完就能访问 /login 的独立包,而是依赖 PHP 版本、Node.js 环境、数据库迁移和密钥生成的完整初始化流程。
确认环境与基础项目准备
运行 php -v 确保版本 ≥ 8.0;运行 node -v 确保 Node.js ≥ 16.14(Laravel 8 对应要求);若用国内网络,建议先配置 Composer 镜像:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
【跳过 --git 参数会导致后续无法回滚初始状态】 使用 Laravel Installer 创建项目时务必加上 --git: laravel new myapp --jet --git。这会自动初始化 Git 仓库并提交初始 commit,方便你对比 Jetstream 注入前后的文件差异。
若已存在 Laravel 8 项目,则直接执行 composer require laravel/jetstream 即可,无需重装框架。
选择前端技术栈并安装
Jetstream 提供两种互斥的前端集成方式,选其一即可:
方法一:Livewire(适合 Blade 开发者)
执行 php artisan jetstream:install livewire → 此命令会覆盖默认的认证视图、注册 Livewire 组件、修改 RouteServiceProvider 并写入 Tailwind 配置。
方法二:Inertia(适合 Vue/React 偏好者)
执行 php artisan jetstream:install inertia → 该命令会在 resources/js/Pages 下生成 Vue 文件,同时配置 Inertia 中间件和响应格式。
如需启用团队功能,在上述任一命令后追加 --teams,例如:php artisan jetstream:install livewire --teams。
完成构建与数据库初始化
第一步:生成应用密钥
运行 php artisan key:generate —— 这一步不可跳过,否则 Session 和 CSRF 机制将失效,/login 页面会报 500 错误。
第二步:运行数据库迁移
执行 php artisan migrate —— Jetstream 依赖的 users、password_resets、sessions、teams、team_user 等表均由迁移文件定义,未执行则所有认证流程无法持久化。
第三步:安装并编译前端资源
依次运行:npm install → npm run dev。
注意:若终端卡在 @inertiajs/vue3 安装阶段,大概率是 Node.js 版本低于 16.14,请升级后再试。
第四步:启动开发服务器
运行 php artisan serve,然后访问 https://www.php.cn/link/098cfa8d18627149daffb8f4e05692d0 即可看到 Jetstream 提供的登录界面。


















