go-admin不是可go get的库，而是需用adm cli生成独立管理服务；强行嵌入主项目会导致路由冲突、中间件丢失、db连接覆盖，正确做法是初始化隔离工程并共用数据库但独占连接池。
go-admin 不是拿来 go get 进主项目的库，而是一个需独立部署的管理服务——强行嵌入 Gin/Echo 主应用会导致路由冲突、中间件丢失、数据库连接覆盖，后续维护成本远高于从零写。
adm CLI 生成独立管理服务才是正确起点
很多人想“复用现有项目结构”，直接在业务代码里 go get github.com/GoAdminGroup/go-admin，结果启动就 panic 或权限中间件不生效。根本原因：它自带 http.Server 和完整路由树，不是插件式组件。
正确做法是用官方 CLI 工具 adm 初始化一个最小可运行工程：
- 先安装：
GO111MODULE=on go install github.com/GoAdminGroup/go-admin/adm@latest - 新建目录后执行：
adm init（会引导选驱动、填 DB 地址、选表） - 生成物包含
main.go、config.yaml、datamodel/，完全隔离于业务进程 - 部署时共用同一套 MySQL，但 DB 连接由该服务自己初始化，不共享
*gorm.DB实例
模型生成后字段不更新或报 unknown field 错误
adm generate 输出的 user.go 等文件默认用 GORM v2 tag（如 gorm:"column:id;primaryKey"），若你的主项目还在用 GORM v1 或自定义了 struct tag（比如 json:"name" 覆盖了 gorm tag），运行时就会跳过字段或 panic。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 检查生成代码中每个字段是否含
gorm:tag；缺失说明adm读表结构失败（常见于 MySQL 的ENUM、JSON类型或无列注释） - 手动补 tag 后，必须同步改
table.Config.Driver：MySQL 用db.DriverMysql，PostgreSQL 必须显式设为db.DriverPostgresql，否则 SQL 构建器拼错 - 复合主键或无主键表会被
adm自动跳过——不是 bug，是设计限制；需在GetUserTable()里手动调用.SetPrimaryKey("id", "tenant_id")
Gin 适配器下 RBAC 权限失效的典型断层点
你配了 policy.csv，也写了 e.Enforce(role, path, method)，但 /api/user 总是 403。问题不在 Casbin 规则本身，而在上下文没传到权限检查函数里。
-
AuthCheckRole中从c.Get(jwtauth.JwtPayloadKey)取 payload，意味着前置 JWT 中间件必须已执行且 key 名一致；若你用的是自定义鉴权中间件，key 名不匹配就取不到 role - Gin 适配器注册路由时，若没把权限中间件加到对应 group（比如
adminGroup := r.Group("/admin").Use(AuthCheckRole())），整个 group 都绕过检查 - Casbin 的
e实例必须全局唯一且已加载 policy；若每次请求都新建enforcer，策略不会生效
微服务场景下必须避免的 DB 共享陷阱
多个微服务共用一个数据库时，容易误以为“只要连同一个 MySQL 就行”，结果出现事务不一致、连接池耗尽、慢查询拖垮所有服务。
-
adm生成的服务必须使用独立的数据库连接池（gorm.Open(..., &gorm.Config{...})），不能复用主服务的*gorm.DB实例 - 连接参数建议显式设
MaxOpenConns: 10、MaxIdleConns: 5，避免抢光主服务连接 - 若主服务用了分库分表中间件（如 ShardingSphere），
adm服务无法自动识别逻辑库名，需直连物理库并手动处理表名前缀
真正的复杂点不在“怎么搭”，而在“怎么划界”：管理后台和业务服务之间必须有明确的进程边界、DB 连接边界、中间件链边界。一旦模糊，后面加审计日志、做灰度发布、切流量，全都会卡在这些隐式耦合上。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
