ThinkPHP6需手动实现权限系统初始化：建auth_role、auth_rule、auth_role_rule三表，通过命令行php think init:auth填充默认角色与权限，并支持注解扫描自动刷新节点，确保权限数据随代码演进同步。
ThinkPHP6 本身不提供类似 Laravel 的 migrate 命令来自动管理数据库结构变更，但“添加授权数据迁移”实际指的是为权限系统（如 Auth、RBAC）准备初始的数据库表和基础数据——比如角色表、权限规则表、用户-角色关联表，以及预设管理员、访客等角色及其对应权限。这类操作不是框架原生迁移，而是通过手动建表 + 数据填充完成，关键在于结构设计合理、初始化脚本可复用、便于后续扩展。
创建授权所需的数据表
权限系统至少需要三张核心表（以 MySQL 为例）：
-
auth_role：存储角色，字段如
id、name（如“管理员”“编辑员”）、status、create_time -
auth_rule：存储权限节点（菜单或操作），字段含
id、name（如“user/edit”）、title（中文名）、type（menu 或 action）、pid、path（用于树状查询，如“0-1-5”）、status -
auth_role_rule：角色与权限的多对多关系表，字段为
role_id和rule_id
建议使用 ThinkPHP6 的 think-migration 扩展或直接在数据库中执行 SQL 创建；若用迁移扩展，需先安装：composer require topthink/think-migration，再运行 php think migrate:create InitAuthTables 编写建表逻辑。
填充基础授权数据
建表后需插入默认角色和权限。推荐方式是编写一个命令行指令（如 php think init:auth），在 app/command/InitAuth.php 中实现：
立即学习“PHP免费学习笔记（深入）”；
- 先检查
auth_role是否为空，若空则插入 “超级管理员” 和 “普通用户” 角色 - 清空并重建
auth_rule表中的预设节点，例如后台首页、用户列表、内容编辑等路由标识 - 将超级管理员角色与全部规则绑定到
auth_role_rule
这样每次部署新环境时，只需执行一条命令即可完成授权体系初始化，避免人工漏填或顺序错误。
配合节点自动刷新机制
权限节点（auth_rule）不应全靠手动维护。若使用 EasyAdmin 或自研注解式权限（如 @Node("user/list", "用户列表")），需提供「一键刷新节点」功能：
- 扫描所有控制器方法，提取注解中的
name和title - 对比数据库已有记录，只新增缺失项，不覆盖已配置的
status或pid - 刷新后自动清除缓存（如
cache('auth_rules', null)），确保下次请求读取最新权限树
该机制让权限数据随代码演进自动同步，降低运维成本。
权限数据与业务解耦的关键点
授权数据迁移不是一次性动作，而是持续演进的过程：
- 不要把权限判断逻辑写死在控制器里，统一交由中间件（如
AuthMiddleware）处理 - 所有权限标识（如
'user/delete'）应定义为常量或配置项，避免字符串散落各处 - 用户登录后，从数据库加载其角色所拥有的全部
rule.name并缓存，后续Auth::check()直接查内存，不查库 - 删除控制器方法后，务必触发「清除失效节点」，否则残留规则可能造成误判
不复杂但容易忽略
