Laravel 8使用Jetstream时集成Spatie实现角色权限的相关问题咨询

疑问1：已有项目能否新增Spatie角色权限功能 #

可以，完全不需要全新安装Laravel项目。多数教程用全新项目演示只是为了排除已有业务代码的干扰，降低演示步骤的复杂度，实际生产环境的已有项目完全可以正常集成。

疑问2：Spatie Permissions和Jetstream是否兼容 #

二者官方支持兼容，网传的兼容性问题绝大多数是开发者使用了版本不匹配的包、或者未正确配置User模型导致的，按正确流程配置不会出现冲突。

可行集成步骤 #

• 提前做好数据备份：将现有代码提交至版本仓库，导出全量数据库备份，避免操作失误导致数据丢失
• 安装匹配Laravel 8的Spatie权限包，执行命令：composer require spatie/laravel-permission:^5.0
• 发布包的配置文件与迁移文件，执行命令：php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"，确认发布的迁移文件无误后执行php artisan migrate生成权限关联表，该操作不会修改你现有的users表或Jetstream相关表，不会影响已有认证功能
• 配置User模型：在Jetstream生成的App\Models\User文件中引入Spatie的特性，将HasRoles Trait加入到模型的use声明中，和原有HasApiTokens、HasFactory等特性放在一起即可，原有模型代码不需要做其他修改
• 守卫适配：Spatie默认使用web守卫，和Jetstream默认的守卫配置完全一致，如果你未自定义守卫不需要额外调整；如果有自定义守卫，只需在config/permission.php的guard_names数组中加入你使用的守卫即可

需求实现说明 #

• 角色维度权限：可通过Spatie提供的方法创建角色、给角色分配权限，给用户绑定角色后，用户会自动继承对应角色的所有权限
• 单个用户权限覆盖：Spatie原生支持直接给用户分配独立权限，用户的最终权限默认是「角色继承权限 + 单独分配权限」的并集，如果需要实现覆盖逻辑，可自行配置权限判断优先级，优先取用户单独分配的权限即可

注意事项 #

• 如果你使用了Jetstream的团队功能，只需在config/permission.php中开启team配置项，给团队模型也添加HasRoles Trait即可适配，不需要修改原有团队逻辑
• 权限校验可以直接使用Laravel原生的can中间件、Blade的@can指令，和常规的Laravel权限校验逻辑完全通用
• 不要直接修改Spatie生成的迁移文件，避免后续版本升级出现兼容问题

内容的提问来源于stack exchange，提问作者Keerthi Dsouza