Beego无开箱即用认证模块,需用InsertFilter在BeforeRouter阶段统一拦截请求;JWT验证须手动解析Authorization头、校验签名与过期,并将用户信息存入ctx.Input.Data供控制器使用。

Beego 没有开箱即用的完整认证模块,但它的中间件机制和生命周期钩子(如 Prepare、InsertFilter)足够灵活,能让你在几小时内落地一个安全、可维护的认证方案。关键不是“选哪个库”,而是“在哪拦截、怎么透传、如何校验”。
用 InsertFilter 在路由层统一拦截请求
这是最常用也最可控的方式——把认证逻辑放在框架路由分发前,避免每个控制器重复写校验代码。
-
InsertFilter支持BeforeRouter、BeforeExec等阶段,认证必须用BeforeRouter,否则无法拦截未注册的路径 - 别在
Prepare()里做全局认证:它只对匹配到控制器的请求生效,404 请求会绕过,导致权限漏洞 - 过滤器函数接收
*context.Context,可直接调用ctx.Redirect(401, ...)或ctx.Abort(401) - 注意路径匹配顺序:Beego 的通配符
/api/v1/*会匹配/api/v1/user,但不匹配/api/v1/(末尾斜杠问题),建议统一加或不加
JWT 验证要自己解析并注入用户上下文
Beego 不内置 JWT 解析,需手动验证签名、检查过期、提取 payload,并把用户信息挂到 ctx.Input.Data 供后续控制器使用。
- 推荐用
github.com/golang-jwt/jwt/v5(注意 v5 是当前主流,dgrijalva/jwt-go已归档且有安全风险) - 从
Authorization: Bearer <token></token>头取值时,记得切掉"Bearer "前缀,否则解析失败报square/go-jose: error in cryptographic primitive - 验证通过后,务必调用
ctx.Input.SetData("user_id", claims.UserID),而不是只存进局部变量——控制器里得靠这个拿用户身份 - 不要把原始 token 存进
ctx.Input.Data,避免意外泄露;只存解码后的必要字段(如user_id、role)
固定 Token 或 Basic Auth 适合内部服务快速验证
对外暴露的 API 不建议用,但运维接口、配置中心、健康检查等场景下,简单有效。
- Basic Auth 可复用
github.com/abbot/go-http-auth,但注意其Secret函数返回的是 crypt hash(如$1$...),不是明文密码;若对接 LDAP 或数据库,需自行实现哈希比对逻辑 - 固定 Token 方式别硬编码在代码里,应从
beego.AppConfig.String("auth::api_token")读取,方便不同环境切换 - 这类认证通常跳过登录流程,所以无需 session 或 cookie,但也要校验请求头是否存在、是否为空字符串,否则
"" == "xxx"会误放行 - 若同时支持多种认证方式(如 JWT + 固定 Token),需在过滤器里按优先级判断,避免短路逻辑漏掉 header
LDAP 或数据库认证要处理用户首次同步逻辑
企业内网常见需求:用户存在 LDAP 中,但 Beego 应用本地无记录。此时不能只查 DB 返回 401,而要尝试拉取并落库。
- 先查本地
models.UserOneByUsername(username),查不到再连 LDAP 执行ConnLDAP(username) - LDAP 查询成功后,需生成本地密码哈希(如
utils.String2md5(data.UserPassword)),但注意:LDAP 密码字段可能是密文或不可读,实际应以绑定成功为准,而非读取 password 属性 - 用户状态同步是双向的:LDAP 用户删除后,本地 DB 对应记录也应标记为禁用(而非物理删除),避免历史数据丢失
- 所有 LDAP 调用必须加超时(
ldap.Dial("tcp", addr, ldap.DialWithDialer(...))),否则网络抖动会导致整个 HTTP 请求 hang 住
/login、/healthz)、哪些必须拒绝(如 /admin/*)、以及错误响应体是否暴露过多信息(比如把 invalid signature 直接返回给前端)。这些边界条件,比选哪个 JWT 库重要得多。


















