Casbin通过Model定义规则、Policy存储数据、Enforcer执行校验，内置角色继承、通配符匹配（如keyMatch2）、热更新原子操作及高并发安全机制，避免手写RBAC时的死循环、漏匹配、缓存失效和竞态问题。
直接用 casbin，别手写 RBAC 核心逻辑——90% 的自研权限系统会在角色继承、通配符匹配、热更新失效上翻车。
为什么不能自己写 CheckPermission 函数
看似几行 if-else 就能判断 “用户是否属于 admin 角色”，但真实场景会立刻暴露问题：
- 角色有层级（如
editor→senior_editor→admin），手写递归查继承链容易漏节点或死循环 - 资源路径带通配符（
/api/v1/users/*或/api/v1/orders/{id}），字符串==匹配完全失效 - 运行时给用户加了新角色，但内存里缓存的
userRoles映射没刷新，下次请求仍走旧路径 - 高并发下多个 goroutine 同时读写
rolePermsmap，不加锁 panic，加锁又成性能瓶颈
casbin 初始化必须核对的三件事
casbin.NewEnforcer("rbac_model.conf", "rbac_policy.csv") 看似简单，错一个字符就导致 enforce() 永远返回 false：
-
rbac_model.conf文件编码必须是 UTF-8 无 BOM；Windows 记事本默认带 BOM，会导致解析失败且无提示 -
rbac_policy.csv里不能有空行、不能有#开头的注释行——Casbin 把它当无效策略丢弃，但不报错 -
[request_definition]中参数顺序决定Enforce()调用顺序：比如定义为r.sub, r.obj, r.act，就必须按e.Enforce("alice", "/articles/123", "delete")传，反了直接 panic
路径匹配必须显式替换 matcher 函数
默认模型用 r.obj == p.obj 做字符串全等，根本无法支持 RESTful 路径。要让 /api/v1/users/123 匹配策略里的 /api/v1/users/*，必须：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
- 在
rbac_model.conf里声明：matcher = eval(keyMatch2(r.obj, p.obj)) - 确保你用的是
casbin/v2或更高版本（keyMatch2在 v1 不可用） - 策略文件中写
p, admin, /api/v1/users/*, GET，而不是/api/v1/users/123
热更新权限时最常踩的坑
线上改策略不能重启服务，但直接调 e.AddPolicy() 并不等于立即生效：
-
e.AddPolicy()只写入内存策略表，但 Casbin 默认启用缓存，旧请求可能还在用老 cache 结果 -
e.LoadPolicy()会清空全量策略再重载，高并发下可能出现短暂“全员无权限”窗口 - 正确做法是：
e.AddNamedPolicy("p", "alice", "/data", "read")+e.RemoveNamedPolicy("p", "alice", "/data", "write")，它们只操作指定行，不 reload 全量，也绕过缓存污染风险
真正难的不是写通第一个 enforce()，而是保证十万级并发下每次匹配都原子、可预测、不漏角色继承、不卡住 Goroutine——这些 Casbin 底层已用前缀树 + RWMutex + LRU cache 做了收敛，自己重造轮子只会把问题从“怎么写”变成“为什么有时对有时错”。
