Casbin 与 Iris 集成需手动注入单例 Enforcer，权限中间件提取 sub/obj/act 三元组并调用 Enforce；菜单按钮权限须实时查询+缓存，策略热更新应优先增量操作而非全量 LoadPolicy。
casbin 与 Iris 的集成方式
动态权限配置在 Iris 中不靠框架原生支持，而是通过 casbin 实现——Iris 本身只负责路由和中间件调度，真正的策略加载、匹配、缓存都由 casbin 完成。你必须手动把 casbin.Enforcer 注入到请求上下文或全局应用实例中，否则每次鉴权都要重新初始化，性能极差。
常见错误是直接在每个 handler 里调用 enforcer.Enforce(...) 却没做初始化校验，导致首次请求报 nil pointer dereference；或者用内存模型（file-adapter）但没监听策略文件变更，改了 CSV 权限表却没生效。
- 推荐使用
redis-adapter或gorm-adapter，避免文件 I/O 阻塞 HTTP 请求 - 初始化 enforcer 必须在
app.Run()前完成，且建议封装为独立函数，例如initCasbin() - 不要在中间件里重复调用
casbin.NewEnforcer()，应复用单例
权限检查中间件的写法要点
Iris 中权限中间件本质是拦截 ctx.Path() 和 ctx.Method()，传给 enforcer.Enforce(sub, obj, act)。关键在于 sub（用户标识）、obj（资源路径）、act（HTTP 方法）三元组如何提取——很多项目硬编码 "user" 当 sub，结果 RBAC 失效。
正确做法是：从 token 解析出用户 ID 或角色名作为 sub；把 /api/v1/users 这类路由抽象为统一 obj（而非带参数的 /api/v1/users/123），否则策略表会爆炸；act 建议转为小写，避免 GET 和 get 匹配失败。
- 示例：若当前用户角色是
"admin"，访问GET /api/v1/logs，则调用enforcer.Enforce("admin", "/api/v1/logs", "get") - 需提前在 casbin 策略中定义
p, admin, /api/v1/logs, get - 若要支持按钮级控制（如“导出”按钮），可将
obj设为"button:export"，act设为"click"
菜单与按钮权限的运行时同步
前端需要动态渲染菜单和按钮，意味着后端得提供接口返回当前用户可见的菜单树和按钮列表。这不能靠静态 JSON，而应实时查 casbin 策略表：遍历所有 p 规则，按 sub == currentUserRole 筛出 obj，再按前缀（如 menu:、btn:）分类。
容易踩的坑是直接 SELECT * 扫全表，高并发下拖慢整个权限接口；更糟的是把按钮权限硬编码进前端 JS，后端不做二次校验——这等于裸奔。
- 建议对菜单权限加 Redis 缓存，key 为
menu_perm:<role></role>，TTL 5 分钟 - 按钮权限必须在 API 层再次校验，不能仅依赖前端隐藏
- 避免在策略表里写死路径如
/user/edit，改用逻辑标识如user:update，解耦路由变化
策略更新后如何不重启服务
casbin 支持热更新，但 Iris 默认不监听。你需要主动调用 enforcer.LoadPolicy()，并在外部触发（如收到管理后台的“发布权限”事件）。如果用数据库 adapter，可以监听表变更；如果用文件，可用 fsnotify 监控 CSV 修改时间。
最常被忽略的一点：LoadPolicy() 是全量重载，不是增量更新。如果你只改了一行策略，它仍会清空内存策略再重读全量——高频更新时可能引发短暂 403。生产环境建议用 enforcer.AddPolicy() / RemovePolicy() 增量操作。
- Redis adapter 下，可订阅 channel 如
casbin:policy:update，收到消息后执行enforcer.LoadPolicy() - 务必在
LoadPolicy()后加日志，记录加载条数，便于排查策略丢失 - 测试时用
enforcer.GetPolicy()打印当前策略，确认是否真已刷新
真正难的不是写通 casbin，而是让策略变更能秒级触达所有服务实例——尤其在多节点部署时，一个节点更新了，其他节点还缓着旧策略。这个一致性问题，得靠分布式锁或中心化存储兜底，而不是指望中间件自动解决。
