feat: SSE Last-Event-ID 补投 + 连接状态指示 + 限速器 DB 化

## SSE Last-Event-ID 补投

EventSource 断线重连时自带 Last-Event-ID 头,但服务端直接忽略了——
所有断线期间的邮件通知都丢失。用户刷新页面也会错过已推的事件。

改为 per-user 事件环形缓冲区(500 条,~100KB/用户,20 在线 ≈ 2MB):
每次 Broadcast/SendToUser/SendToAgent 同时写入对应用户的缓冲区;
AddClient 时取 Last-Event-ID 头,找到该 ID 的位置后从下一条回放。
找不到 ID 说明事件已被覆盖(缓冲区溢出),从头回放全部。

事件 ID 用全局递增序列号(非 UUID),EventSource 的 Last-Event-ID
就是靠这个 ID 记住断点的。

新增测试:缓冲区回放、溢出行为、并发安全(10 goroutine × 200 次 push)、
端到端重连验证(SendToUser → 带 Last-Event-ID 的 AddClient → 补投)。

## 连接状态指示器

Sidebar 用户头像右下角的小圆点:绿=已连接,黄=连接中,橙=重连中,红=断开。
NarrowNav 底栏也有(移动端)。

SSE 模块新增 onSSEStatus/getSSEStatus 接口,onerror/onopen 驱动状态变化。
状态点用 absolute 定位在头像边缘,不遮挡文字。

## 限速器 DB 化(解决多实例部署时的计数漂移)

原实现:LoginLimiter 与 sessionRateLimiter 都是进程内内存计数器。
多实例部署时各自独立计数,等效上限变成 N 倍。

改为 rate_limits 表(bucket + ts),两个限速器共享同一套基础设施:
- LoginLimiter:bucket="login:<username>",COUNT(*) >= 5 → 锁定 5 分钟
- sessionRateLimiter:bucket="session:<agent_name>",COUNT(*) >= 20/h → 拒绝

判断与写入在同一个 BEGIN IMMEDIATE 事务里——SQLite 的 IMMEDIATE
在事务开始时获取 RESERVED 锁,防并发写事务同时进入 COMMIT 阶段。
实测 80 并发下恰好放行 20 次(旧内存版同样通过,但 DB 版才能多实例共享)。

DB 不可用时放行(宁可放开限速也不能让用户完全无法使用)。
新建 rate_limits 表迁移(SQLite + PG 两版)。
This commit is contained in:
2026-09-02 14:33:41 +08:00
parent 07e6b789b2
commit 9d4718a412
18 changed files with 760 additions and 243 deletions

View File

@ -1,52 +1,57 @@
package repo
import (
"context"
"sync"
"testing"
"time"
"github.com/agentmail/gateway/internal/db"
)
// 每个测试用独立的 limiter,避免相互污染(全局那个是进程级的)
func newLimiter() *sessionRateLimiter {
return &sessionRateLimiter{marks: make(map[string][]time.Time)}
}
// 新建会话速率限制:DB 版
//
// 这些测试用真实的 SQLite(setupTestDB),验证速率限制的原子性与窗口滑动。
// 原来的内存版测试依赖 sessionRateLimiter 结构体,替换为 DB 版后重写。
func TestSessionRateAllowsUpToLimit(t *testing.T) {
l := newLimiter()
setupTestDB(t)
ctx := context.Background()
for i := 1; i <= sessionRateLimit; i++ {
if ok, _ := l.Allow("bot"); !ok {
if ok, _ := AllowNewSession(ctx, "bot"); !ok {
t.Fatalf("第 %d 次应放行(上限 %d)", i, sessionRateLimit)
}
}
ok, retry := l.Allow("bot")
ok, retry := AllowNewSession(ctx, "bot")
if ok {
t.Fatal("超过上限应拦下")
}
if retry < 1 {
t.Fatalf("应给出正的重试等待秒数,实际 %d", retry)
}
if retry > int(sessionRateWindow.Seconds())+1 {
t.Fatalf("重试等待 %d 秒超过了窗口长度", retry)
}
}
// 不同 Agent 各自计数,一个刷满不该影响另一个
func TestSessionRateIsPerAgent(t *testing.T) {
l := newLimiter()
setupTestDB(t)
ctx := context.Background()
for i := 0; i < sessionRateLimit; i++ {
l.Allow("busy")
AllowNewSession(ctx, "busy")
}
if ok, _ := l.Allow("busy"); ok {
if ok, _ := AllowNewSession(ctx, "busy"); ok {
t.Fatal("busy 应已被拦")
}
if ok, _ := l.Allow("idle"); !ok {
if ok, _ := AllowNewSession(ctx, "idle"); !ok {
t.Fatal("另一个 Agent 不该被牵连")
}
}
// 判断与记账必须在同一把锁里,否则并发请求双双通过检查把上限刷穿
// 并发请求不能把上限刷穿(判断与记账必须原子)
func TestSessionRateConcurrentDoesNotOverrun(t *testing.T) {
l := newLimiter()
setupTestDB(t)
ctx := context.Background()
var wg sync.WaitGroup
var mu sync.Mutex
passed := 0
@ -55,7 +60,7 @@ func TestSessionRateConcurrentDoesNotOverrun(t *testing.T) {
wg.Add(1)
go func() {
defer wg.Done()
if ok, _ := l.Allow("bot"); ok {
if ok, _ := AllowNewSession(ctx, "bot"); ok {
mu.Lock()
passed++
mu.Unlock()
@ -70,48 +75,53 @@ func TestSessionRateConcurrentDoesNotOverrun(t *testing.T) {
}
}
// 建会话失败时要还名额:那次新建实际上没有发生
// 建会话失败时要还名额
func TestSessionRateRelease(t *testing.T) {
l := newLimiter()
setupTestDB(t)
ctx := context.Background()
for i := 0; i < sessionRateLimit; i++ {
l.Allow("bot")
AllowNewSession(ctx, "bot")
}
if ok, _ := l.Allow("bot"); ok {
if ok, _ := AllowNewSession(ctx, "bot"); ok {
t.Fatal("应已刷满")
}
l.Release("bot")
if ok, _ := l.Allow("bot"); !ok {
ReleaseNewSession(ctx, "bot")
if ok, _ := AllowNewSession(ctx, "bot"); !ok {
t.Fatal("归还名额后应能再开一条")
}
// 空记录上 Release 不该 panic
l2 := newLimiter()
l2.Release("nobody")
}
// 窗口滑过后自动恢复 —— 这正是它优于「终身额度」的地方:
// 终身额度跑满要人工重置,速率限制过一个窗口自己好
func TestSessionRateWindowSlides(t *testing.T) {
l := newLimiter()
old := time.Now().Add(-sessionRateWindow - time.Minute)
marks := make([]time.Time, sessionRateLimit)
for i := range marks {
marks[i] = old
}
l.marks["bot"] = marks
if ok, _ := l.Allow("bot"); !ok {
t.Fatal("窗口外的记录应被清掉,此次应放行")
}
if len(l.marks["bot"]) != 1 {
t.Fatalf("过期记录未清理,剩余 %d 条", len(l.marks["bot"]))
}
}
// 人类不走限速(空 agentName)
func TestAllowNewSessionSkipsHumans(t *testing.T) {
setupTestDB(t)
ctx := context.Background()
for i := 0; i < sessionRateLimit*3; i++ {
if ok, _ := AllowNewSession(""); !ok {
if ok, _ := AllowNewSession(ctx, ""); !ok {
t.Fatal("人类不该被限速")
}
}
}
// 窗口滑过后自动恢复(过期记录自动清理)
func TestSessionRateWindowSlides(t *testing.T) {
setupTestDB(t)
ctx := context.Background()
// 插入过期记录(1小时前)
cutoff := time.Now().Add(-sessionRateWindow - time.Minute)
for i := 0; i < sessionRateLimit; i++ {
_, err := db.DB.ExecContext(ctx,
`INSERT INTO rate_limits (bucket, ts) VALUES ($1, $2)`,
"session:bot", cutoff)
if err != nil {
t.Fatalf("插入过期记录失败: %v", err)
}
}
// 窗口外的记录应被清理,此次应放行
if ok, _ := AllowNewSession(ctx, "bot"); !ok {
t.Fatal("窗口外的记录应被清掉,此次应放行")
}
}