Beego无内置访问量统计中间件,须用beego.InsertFilter结合sync.Map或atomic实现线程安全计数;静态资源需用BeforeStatic单独注册,API路径统计应以"/api/"前缀注册过滤器,结尾斜杠防误匹配。

Beego 没有内置访问量统计中间件,必须自己用 beego.InsertFilter + 线程安全计数器实现;直接操作全局变量或 map 会 panic,且静态资源路径(如 /static/)默认不走常规过滤器链。
为什么全局变量计数器在 Beego 里会出错
Beego 是并发模型,每个请求由独立 goroutine 处理。如果用普通 var count int 或未加锁的 map[string]int,会出现数据竞争(data race),导致计数值跳变、丢失甚至 crash。Go runtime 在 race detector 下会直接报错:fatal error: concurrent map writes。
- 必须用
sync.Map或sync.Mutex包裹读写逻辑 - 不要在
init()里初始化计数器后就不管——它只是变量声明,不是线程安全保证 -
sync.Map适合键值离散(如按 path 统计)、读多写少场景;若需原子整数累加(如总请求数),用sync/atomic更轻量
如何只统计 API 路径(比如 /api/)的访问量
不能靠中间件函数里写 if strings.HasPrefix(ctx.Request.URL.Path, "/api/") 再计数——这会漏掉 beego.BeforeStatic 阶段的请求,且语义上违背 Beego 的过滤点设计。正确方式是利用 beego.InsertFilter 的路径前缀注册机制:
- 注册时用
beego.InsertFilter("/api/", beego.BeforeRouter, apiCounter),结尾斜杠确保精确匹配 - 避免写
"/api"(会误匹配/apixxx)或"/api/*"(v2.3.5 不支持通配符语法,会静默失效) - 该注册必须在
beego.Run()前,否则不生效
示例计数函数:
var apiHitCount sync.Map // key: string(path), value: *atomic.Int64
func apiCounter(ctx *context.Context) {
path := ctx.Request.URL.Path
counter, _ := apiHitCount.LoadOrStore(path, &atomic.Int64{})
counter.(*atomic.Int64).Add(1)
ctx.Next()
}
怎么把静态资源访问也纳入统计(比如 /static/js/app.js)
/static/ 请求绕过整个路由系统,BeforeRouter 和 BeforeExec 都不会触发。唯一能拦截它的阶段是 beego.BeforeStatic,但要注意:
- 此时
ctx.Input.Param()、ctx.Controller等字段未初始化,调用会 panic - 只能从
ctx.Request.URL.Path提取路径,不能依赖任何路由解析结果 - 必须单独注册一次:
beego.InsertFilter("/static/", beego.BeforeStatic, staticCounter) - 如果想合并统计,建议复用同一个
sync.Map实例,避免两套计数器逻辑
统计结果怎么安全暴露给管理员页面
不要把计数器变量直接塞进 c.Data 传给模板——模板渲染是同步阻塞的,高并发下可能卡住。推荐两种方式:
- 写一个专用 Controller 方法(如
GetStats()),用atomic.LoadInt64()或sync.Map.Range()快速快照当前值,返回 JSON - 定期 dump 到 Redis 或本地文件(如每分钟写一次
stats.json),前端定时拉取,避免每次请求都查内存 - 切忌在统计中间件里做日志 I/O 或网络调用——它会拖慢所有请求
最容易被忽略的一点:Beego 的 BeforeStatic 过滤器无法获取用户 session 或 token,所以“按用户统计”必须放在 BeforeExec 阶段,且得先校验登录态——这两者根本不在同一执行链上,不能混为一谈。











