Kratos 集成 Casbin 实现 RBAC 的关键在于中间件分层挂载、路径标准化、Enforcer 单例注入及策略中 sub 填 role 而非 userID;漏任一环将导致 Enforce() 返回 false 或 panic。

直接结论:Kratos 里集成 Casbin 做 RBAC,核心不是“能不能”,而是“中间件链路怎么串、enforcer 怎么注入、资源路径怎么标准化”。漏掉任一环,enforcer.Enforce() 就会返回 false 或 panic。
为什么 Kratos 的 JWT 中间件和 Casbin 中间件必须分两层挂载
Kratos 的 jwt.NewServer() 只负责解析 token 并把用户信息(如 userID 或 role)塞进 ctx,它不关心“这个用户能访问哪些接口”。Casbin 的 enforcer.Enforce() 需要明确的三元组:sub(主体)、obj(资源路径+方法)、act(动作),而这些在 JWT 解析前根本不可得。
所以必须:
- 先挂
jwt.NewServer(),确保ctx里有userID或role(推荐存为ctx.Value("user_id")) - 再挂自定义的
casbinMiddleware,从ctx取身份、拼obj、映射act,最后调enforcer.Enforce(sub, obj, act) - 不能把两者逻辑揉在一个中间件里——JWT 解析失败时,Casbin 没法 fallback,容易 panic
如何让 /v1/users/123 这类 RESTful 路径匹配 /v1/users/:id 策略
Kratos 默认路由参数(如 :id)不会自动转成 Casbin 可识别的通配格式。直接传 /v1/users/123 给 enforcer.Enforce(),策略表里写 p, admin, /v1/users/:id, GET 是完全不匹配的。
实操上要在 casbinMiddleware 里做路径标准化:
- 用
r.Context().Value("http_route")或r.URL.Path获取原始路径 - 调
strings.ReplaceAll(path, "/"+idValue, "/:id")不可靠——ID 值可能含斜杠或重复;正确做法是依赖 Kratos 的路由元信息,或在server.Register()时显式记录路由模板 - 更稳妥的是在
matchers段启用keyMatch:在 model.conf 里写m = g(r.sub, p.sub) && keyMatch(r.obj, p.obj) && r.act == p.act,并初始化时注册函数:enforcer.AddFunction("keyMatch", util.KeyMatch) - 策略里写
p, admin, /v1/users/*, GET或p, admin, /v1/users/:id, GET(取决于 model 是否支持:id占位符)
Wire 注入 enforcer 时最容易踩的三个坑
Casbin 的 Enforcer 必须是全局单例,且初始化时机早于 HTTP server 启动,否则中间件里拿到的是 nil。
Wire 提供商写法常见错误:
- 没加
bind:标签导致 provider 不被调用,enforcer始终未初始化 - adapter 初始化用了相对路径(如
"./policy.csv"),Wire 构建时工作目录非项目根目录,文件打不开 - model 加载后没调
enforcer.LoadPolicy(),或者用了 file-adapter 但没开自动重载(watcher),改了 policy 文件也不生效
推荐 Wire provider 写法:
func NewEnforcer(modelPath string, adapter *fileadapter.Adapter) *casbin.Enforcer {
e, _ := casbin.NewEnforcer(modelPath, adapter)
e.LoadPolicy()
return e
}
并在 wire.Build() 中显式调用该函数,路径用 filepath.Join(os.Getenv("PWD"), "configs/casbin_model.conf") 更稳。
RBAC 策略里 sub 字段该填 userID 还是 role
填 role 更合理。Kratos 场景下,用户和角色通常是 1:N 关系(一个用户可属多个角色),而 Casbin 的 g 规则天然支持角色继承。如果你在策略里写 p, user_123, /v1/orders, GET,等于给每个用户单独授权,失去 RBAC 的复用价值。
正确姿势:
- JWT 解析后,从 token claims 取
role字段(如"admin"、"editor"),存入ctx - 策略表写
p, admin, /v1/orders, GET,再补g, user_123, admin表示用户归属 - model.conf 必须含
[role_definition]段:g = _, _,否则g(r.sub, p.sub)不生效
注意:如果业务要求“用户级权限覆盖角色级”,可以双轨并存,但需在 matchers 里合并逻辑,比如 m = g(r.sub, p.sub) || r.sub == p.sub,这时 sub 才可同时接受 user_123 和 admin。
最常被忽略的一点:Casbin 的 Enforce() 返回 false 不一定代表“拒绝”,也可能是 enforcer 本身未加载策略、或 sub/obj/act 任意一项为空字符串。上线前务必用 enforcer.GetPolicy() 和 enforcer.GetRolesForUser() 打印实际加载内容,别只信日志里的 Access denied。


















