LaravelJetstream怎么用_LaravelJetstream全栈认证方案【推荐】
Jetstream并非开箱即用，需手动执行迁移、在配置中显式开启功能、发布Sanctum配置并设置域名，否则API认证静默失败；二因素认证启用后密码确认中间件会拦截敏感操作；团队功能与APItoken权限解耦，需自行处理范围过滤。
Jetstream 装完就能直接用了吗？答案是否定的。它并非一个开箱即用的黑盒，恰恰相反，你需要手动确认配置、执行迁移，并深刻理解它和 Sanctum 之间的耦合关系。否则，很可能登录页正常， API 认证却在后台静默失败。
我先说几个容易踩坑的点：
jetstream:install 命令执行后，必须立刻跑 migrate
无论你执行的是 php artisan jetstream:install livewire 还是 Inertia 版本，Jetstream 都只帮你生成代码和配置文件，并不会自动执行数据库变更。它依赖的那些表——比如 teams、user_teams、personal_access_tokens——都不会自己冒出来。
- 如果漏掉了
php artisan migrate，注册时就会直接抛出SQLSTATE[42S02]: Base table or view not found错误。 - 如果已经运行过迁移但没清缓存，旧 migration 缓存可能导致字段缺失，比如
two_factor_secret字段为空。 - Livewire 版本还需要确保
npm install && npm run build成功，否则resources/js/Pages/Auth/Login.vue（Inertia）或resources/views/auth/login.blade.php（Livewire）里的组件根本无法渲染。
config/jetstream.php 里的 features 必须显式开启
Jetstream 默认只启用最简单的认证（注册/登录）。双因素认证、团队功能、API Token 这些，全靠 config/jetstream.php 中的 'features' 数组来开关。你不配，就等于没开，前端按钮和后端逻辑都不会加载。
- 不加
Features::twoFactorAuthentication()，用户界面就看不到“启用双重验证”按钮，two_factor_secret字段也不会被写入。 - 不加
Features::teams()，哪怕数据库里已经有了teams表，TeamController的路由和权限策略也不会注册。 - 修改之后，务必运行
php artisan config:clear，否则缓存会导致新配置无法生效。
API 认证依赖 Sanctum，但 Jetstream 不会自动发布 Sanctum 配置
Jetstream 内置了 Sanctum 支持，但只负责安装包和注册服务提供者，不会发布 config/sanctum.php。这意味着，跨域请求（比如 Vue 前端调用 /api/user）大概率会返回 401，而且错误信息极其模糊，让人摸不着头脑。
- 必须手动执行
php artisan vendor:publish --provider="Lara vel\Sanctum\SanctumServiceProvider"。 - 检查
.env中的SANCTUM_STATEFUL_DOMAINS是否包含了你的前端域名（例如localhost:5173或myapp.test）。 - Inertia 用户还要确认
app/Http/Middleware/HandleInertiaRequests.php里是否已经在share()方法中添加了'X-XSRF-TOKEN'，否则 XSRF 校验会失败。
二因素认证启用后，密码确认中间件会拦截敏感操作
当你启用了 Features::twoFactorAuthentication()，所有涉及密钥变更的操作——比如禁用 2FA 或重置恢复码——都会触发 ConfirmsPassword 中间件。它不会弹个提示框，而是直接跳转到 /user/confirm-password 页面，等着用户重新输入密码。
- 这个页面默认是存在的，但如果你删除了
resources/views/auth/confirm-password.blade.php，或者覆盖了ConfirmablePasswordResponse，就会直接 404。 - Livewire 版本中，
ConfirmablePasswordResponse类位于vendor/lara vel/jetstream/src/Actions/ConfirmablePasswordResponse.php，千万别误删。 - 如果只是开发环境想跳过确认，可以临时注释掉
app/Providers/JetstreamServiceProvider.php中对ConfirmsPassword的注册。
最后，还有一个容易被忽略的细节：Jetstream 的团队功能与 Sanctum 的 API token 权限模型是解耦的。你开了 Features::teams()，并不代表 API token 会自动绑定到当前团队。你需要在 App\Models\Token 或中间件中自己做 scope 过滤，否则一个 token 可能跨团队读写数据。这才是关键所在。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
