Beego与Locust是独立角色,Locust需模拟真实用户完整走过Beego中间件链(如XSRF、Session、JSON处理),并配合日志追踪和部署配置才能获得准确压测结果。

Beego 本身不内置压测能力,Locust 也不能直接“集成”进 Beego 应用进程里运行——两者是独立角色:Beego 是被测服务端,Locust 是外部模拟客户端。关键在于让 Locust 正确发起符合 Beego 路由和中间件行为的请求,并捕获真实响应指标。
Locust 脚本如何正确调用 Beego 接口
Beego 默认启用 XSRFToken 验证、Session 管理、JSON 自动解析等中间件,若 Locust 直接发裸请求(比如只用 self.client.get("/api/user")),很可能返回 403 或 500,而非业务逻辑错误。
- 先访问一次登录页或首页(如
/或/login),触发 Beego 设置_xsrfcookie 和 sessionid;Locust 会自动维护会话(HttpUser基于 requests.Session) - 从响应 HTML 或 JSON 中提取
_xsrf值(通常在或响应头X-Xsrftoken),存为变量,后续 POST 请求必须带入headers={"X-Xsrftoken": xsrf_value} - Beego 的 JSON 接口默认要求
Content-Type: application/json,且返回体是标准 JSON(无额外包装),Locust 发送时需显式设置json=...参数,不要用data=json.dumps(...)+ 手动设 header - 若 Beego 开启了
EnableGzip = true,Locust 默认不发Accept-Encoding: gzip,会导致响应体被压缩但未解压,表现为乱码或解析失败——建议在on_start中统一加self.client.headers.update({"Accept-Encoding": "gzip"})
Beego 日志与性能瓶颈定位配合点
单纯看 Locust 的 RPS、响应时间不够,容易误判是网络慢还是 Beego 处理卡顿。需要打开 Beego 的详细日志并关联请求 ID。
- 在 Beego 启动前设置:
beego.BeeLogger.SetLevel(beego.LevelDebug),并开启访问日志:beego.BeeLogger.EnableFuncCall(true) - 给每个请求注入唯一 trace ID(例如用
uuid.uuid4().hex),通过ctx.Input.Header("X-Request-ID")读取,并打到 Beego 日志中;Locust 请求时也带上该 header,方便日志串联 - 特别关注 Beego 日志里的
[SQL]行——如果 Locust 并发一上来,SQL 执行时间突增,说明数据库连接池(orm.RegisterDriver配置的maxIdle/maxOpen)可能不足,而非 Beego 代码问题 - Beego 的
RecoverPanic中间件若频繁触发,Locust 报错里会出现大量 500,此时要检查是否并发下结构体字段竞态(如全局 map 未加锁)、或模板渲染 panic(template.Execute传 nil 数据)
Locust 分布式模式下 Beego 服务暴露注意事项
Locust master-worker 模式要求所有 worker 能稳定访问同一个 Beego 实例(或负载均衡后的集群)。这里不是代码问题,而是部署连通性陷阱。
- Beego 默认绑定
127.0.0.1:8080,Locust worker 若不在同一机器,必然连不上——必须改beego.BConfig.Listen.HTTPAddr = ""(空字符串表示监听所有接口) - 若 Beego 前有 Nginx,注意 Nginx 的
proxy_read_timeout和proxy_send_timeout必须 ≥ Locust 设置的timeout(默认 60s),否则长事务会被 Nginx 主动断开,Locust 记为失败 - Beego 的
MaxMemory(文件上传内存限制)和CopyRequestBody(是否缓存 body)会影响大 payload 压测稳定性;Locust 发送 1MB 文件时,若 Beego 未调大beego.BConfig.WebConfig.MaxMemory,会直接 400 - 不要在 Locust worker 本机同时跑 Beego ——协程调度冲突(gevent + beego 的 goroutine)可能导致诡异超时,实测中出现过
greenlet.GreenletExit泄漏
真正难的不是写脚本,而是让 Locust 的每个请求都像真实用户一样走过 Beego 的完整中间件链:CSRF 校验、Session 解析、JSON 编解码、日志 trace、panic 捕获……漏掉任意一环,压测数据就只是网络层幻觉。











