当前位置:

首页 > 编程开发 > LaravelJetstream怎么用_LaravelJetstream全栈认证方案【推荐】

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 的注册。

    Lara velJetstream怎么用_Lara velJetstream全栈认证方案【推荐】

    最后,还有一个容易被忽略的细节:Jetstream 的团队功能与 Sanctum 的 API token 权限模型是解耦的。你开了 Features::teams(),并不代表 API token 会自动绑定到当前团队。你需要在 App\Models\Token 或中间件中自己做 scope 过滤,否则一个 token 可能跨团队读写数据。这才是关键所在。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 laravel
    相关文章 更多
    laravel官网教程下载与安装入门指南
    laravel官网教程下载与安装入门指南

    想开始学习Laravel却卡在第一步?本文手把手教你配置PHP环境、安装Composer并成功创建第一个Laravel项目,避开常见坑点,快速进入开发状态。

    Laravel如何通过命令行动态调整队列顺序_Laravel通过命令行动态调整队列顺序方法【CLI】
    Laravel如何通过命令行动态调整队列顺序_Laravel通过命令行动态调整队列顺序方法【CLI】

    Laravel可通过五种方法动态调整队列消费顺序:多进程独立监听配合信号控制、基于环境变量动态解析队列名、利用调度器注入临时队列指令、通过Redis键前缀模拟队列切换、借助SupervisorRPC接口热重载配置。这些方法绕过了固定优先级限制,实现运行时灵活变更。

    Laravel 登录后重定向到用户个人主页的完整实现
    Laravel 登录后重定向到用户个人主页的完整实现

    Laravel默认登录跳转使用静态路径,需重写LoginController的authenticated()方法,利用Auth::user()获取当前用户ID,动态拼接/profile/{id}路由重定向,避免硬编码路径错误,确保每个用户登录后跳转到其专属个人主页。

    Laravel 查询中处理可空结束日期的动态范围筛选
    Laravel 查询中处理可空结束日期的动态范围筛选

    在Laravel中处理可空结束日期的动态范围筛选,需避免使用whereBetween或固定条件。正确做法是采用闭包条件化查询,利用或逻辑处理end_at为NULL的情况,避免NULL比较导致记录被过滤,实现半开放时间区间的准确查询。

    如何在 Laravel 中通过关联表查询借阅者所借书籍的完整信息
    如何在 Laravel 中通过关联表查询借阅者所借书籍的完整信息

    在Laravel中,通过多表联结查询借阅者历史借书记录,需关联borrowers、books和borrow三张表。使用JOIN与select方法提取书名、ISBN、作者、借还日期及逾期状态,显式声明所有表关联可增强查询可扩展性,并建议为外键添加索引以提升性能。

    Laravel怎样使用事务确保订单与库存一致性_Laravel电商订单事务一致性方法【业务】
    Laravel怎样使用事务确保订单与库存一致性_Laravel电商订单事务一致性方法【业务】

    Laravel通过DB::transaction闭包、手动事务控制、Eloquent模型事件、事务重试及savepoint局部回滚五种机制,确保电商订单创建与库存扣减的原子性,防止超卖与数据不一致,支持高并发下的死锁处理与灵活回滚。

    Laravel怎样处理表单验证规则_Laravel处理表单验证规则方法【验证】
    Laravel怎样处理表单验证规则_Laravel处理表单验证规则方法【验证】

    在Laravel中,表单验证可通过控制器直接调用validate()方法、使用FormRequest类封装验证逻辑、注册自定义规则、正确编写条件规则以及预处理请求数据来实现。这些方法能够确保验证规则生效,并避免常见冲突,同时提高代码可维护性。

    Laravel怎样实现OAuth2社交登录_Laravel实现OAuth2社交登录方法【集成】
    Laravel怎样实现OAuth2社交登录_Laravel实现OAuth2社交登录方法【集成】

    Laravel实现OAuth2社交登录的四种主流方案:使用Socialite快速集成,手动通过Guzzle实现OAuth2三步骤,结合Passport生成BearerToken,以及抽象中间件统一多平台认证。四种方案各有优劣,适用于不同场景,开发者可根据项目需求权衡选择。

    如何在 Laravel 中使用单一登录接口支持多个 Guards(认证守卫)
    如何在 Laravel 中使用单一登录接口支持多个 Guards(认证守卫)

    在Laravel中通过动态切换认证守卫实现统一登录接口,基于请求参数自动选择对应Guard与模型,预定义映射表并复用原生认证方法,统一响应结构,避免重复代码,提升可维护性与扩展性。需正确配置认证源、模型实现令牌功能,并配合限流中间件保障安全。

    Laravel如何对动态内容做条件缓存_Laravel对动态内容做条件缓存方法【逻辑】
    Laravel如何对动态内容做条件缓存_Laravel对动态内容做条件缓存方法【逻辑】

    Laravel动态内容条件缓存采用五种策略:动态键名配合Cache::remember()区分不同条件;中间件基于请求特征拦截复用缓存;ViewComposers按需注入缓存数据;模型事件自动失效关联缓存;路由闭包嵌套缓存并支持运行时开关。这些方法依据用户身份、参数等驱动缓存,避免静态路径局限。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。