composer require gmars/tp5-rbac 易失败主因是依赖未就绪（缺think-migration或版本不匹配）、composer.lock冲突、autoload未刷新；须指定dev-master分支，启用openssl，配置国内镜像，执行composer dump-autoload -o并验证class_exists('rbac')。
直接用 composer require gmars/tp5-rbac 安装会失败，不是包名写错，而是它依赖未就绪、锁文件冲突或 autoload 未刷新 —— 这三类问题占实际报错的 90% 以上。
为什么 composer require gmars/tp5-rbac 总是报错
常见错误现象包括：Class 'Rbac' not found、Package gmars/tp5-rbac not found、require-dev is empty 或直接卡在 “Loading composer repositories”。
- 该包不发布到 Packagist 主源，必须显式指定分支：
dev-master，否则 Composer 默认只查 stable 版本 - 它强依赖
topthink/think-migration（用于建表），但很多 TP5 项目没装或版本不匹配（如装了 v3.x 却需要 v2.0.*） -
autoload_psr4.php没更新，尤其在 Windows 下有时缓存残留，导致 new Rbac() 找不到类 - 部分环境 OpenSSL 扩展未启用（见报错
The openssl extension is required），composer 无法下载 zip 包
正确安装步骤（TP5.0 / TP5.1 兼容）
别跳步，顺序执行：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 先确保已启用 OpenSSL：运行
php -m | findstr openssl（Windows）或php -m | grep openssl（Linux/macOS），无输出则需在php.ini中取消;extension=openssl前的分号 - 配置国内镜像（避免超时）：
composer config -g repo.packagist composer https://packagist.phpcomposer.com - 进入 TP5 项目根目录，一次性装齐依赖：
composer require topthink/think-migration=2.0.* gmars/tp5-nestedsets:dev-master gmars/tp5-rbac:dev-master - 强制重刷自动加载：
composer dump-autoload -o - 验证类是否可识别：
php -r "var_dump(class_exists('Rbac'));"输出bool(true)即成功
建表失败？别用 createTable() 直接跑
该方法默认走迁移，但若你没配 migration.path 或数据库权限不足，会静默失败或抛出 SQLSTATE[HY000] [1045] 类错误。
- 更稳的方式是手动导入 SQL：
vendor/gmars/tp5-rbac/gmars_rbac.sql，替换其中的###为你的表前缀（如tp5_） - 如果要用迁移，必须在
application/config.php中加配置：'migration'=>['path'=> ROOT_PATH .'vendor/gmars/tp5-rbac/'] -
createTable()执行后会在runtime/rbac/下生成锁文件.install.lock，重复执行会直接 return；要重试就得删掉它 - 注意：该包建的表含外键，MySQL 必须是 InnoDB 引擎，且
FOREIGN_KEY_CHECKS=1开启状态
初始化后第一件事：检查 rbac 配置项是否生效
很多人卡在权限验证始终放行，根源是配置没加载进框架上下文。
- 配置必须放在
application/config.php的顶层（不能嵌在database或app下），且 key 名必须是'rbac'，大小写敏感 -
'type'值只能是'jwt'或'service'，填错（比如写成'cookie'）会导致Rbac实例内部跳过验证逻辑 -
'db.prefix'必须和你实际导入的表前缀完全一致，例如 SQL 里建的是tp5_permission，这里就得填'tp5_'，多一个空格都不行 - 测试配置是否读取成功：
$rbac = new Rbac(); var_dump($rbac->getConfig());—— 如果输出为空数组，说明配置位置或 key 名错了
最易被忽略的是：这个包的 Rbac 类不自动读取 TP5 的全局数据库配置，所有 DB 操作都走自己配置里的 rbac.db，哪怕你只改了 database.hostname 而忘了同步改 rbac.db.hostname，就会连错库甚至连本地 127.0.0.1 都失败。
