Files
go-trustlog/api/persistence/retry_worker_test.go
ryan 88f80ffa5e feat: 新增数据库持久化模块(Persistence),实现 Cursor + Retry 双层架构
## 核心功能

### 1. 数据库持久化支持
- 新增完整的 Persistence 模块 (api/persistence/)
- 支持三种持久化策略:
  * StrategyDBOnly - 仅落库,不存证
  * StrategyDBAndTrustlog - 既落库又存证(推荐)
  * StrategyTrustlogOnly - 仅存证,不落库
- 支持多数据库:PostgreSQL, MySQL, SQLite

### 2. Cursor + Retry 双层架构
- CursorWorker:第一道防线,快速发现新记录并尝试存证
  * 增量扫描 operation 表(基于时间戳游标)
  * 默认 10 秒扫描间隔,批量处理 100 条
  * 成功更新状态,失败转入重试队列
- RetryWorker:第二道防线,处理失败记录
  * 指数退避重试(1m → 2m → 4m → 8m → 16m)
  * 默认最多重试 5 次
  * 超限自动标记为死信

### 3. 数据库表设计
- operation 表:存储操作记录,支持可空 IP 字段
- trustlog_cursor 表:Key-Value 模式,支持多游标
- trustlog_retry 表:重试队列,支持指数退避

### 4. 异步最终一致性
- 应用调用立即返回(仅落库)
- CursorWorker 异步扫描并存证
- RetryWorker 保障失败重试
- 完整的监控和死信处理机制

## 修改文件

### 核心代码(11个文件)
- api/persistence/cursor_worker.go - Cursor 工作器(新增)
- api/persistence/repository.go - 数据仓储层(新增)
- api/persistence/schema.go - 数据库 Schema(新增)
- api/persistence/strategy.go - 策略管理器(新增)
- api/persistence/client.go - 客户端封装(新增)
- api/persistence/retry_worker.go - Retry 工作器(新增)
- api/persistence/config.go - 配置管理(新增)

### 修复内部包引用(5个文件)
- api/adapter/publisher.go - 修复 internal 包引用
- api/adapter/subscriber.go - 修复 internal 包引用
- api/model/envelope.go - 修复 internal 包引用
- api/model/operation.go - 修复 internal 包引用
- api/model/record.go - 修复 internal 包引用

### 单元测试(8个文件)
- api/persistence/*_test.go - 完整的单元测试
- 测试覆盖率:28.5%
- 测试通过率:49/49 (100%)

### SQL 脚本(4个文件)
- api/persistence/sql/postgresql.sql - PostgreSQL 建表脚本
- api/persistence/sql/mysql.sql - MySQL 建表脚本
- api/persistence/sql/sqlite.sql - SQLite 建表脚本
- api/persistence/sql/test_data.sql - 测试数据

### 文档(2个文件)
- README.md - 更新主文档,新增 Persistence 使用指南
- api/persistence/README.md - 完整的 Persistence 文档
- api/persistence/sql/README.md - SQL 脚本说明

## 技术亮点

1. **充分利用 Cursor 游标表**
   - 作为任务发现队列,非简单的位置记录
   - Key-Value 模式,支持多游标并发扫描
   - 时间戳天然有序,增量扫描高效

2. **双层保障机制**
   - Cursor:正常流程,快速处理
   - Retry:异常流程,可靠重试
   - 职责分离,监控清晰

3. **可空 IP 字段支持**
   - ClientIP 和 ServerIP 使用 *string 类型
   - 支持 NULL 值,符合数据库最佳实践
   - 使用 sql.NullString 正确处理

4. **完整的监控支持**
   - 未存证记录数监控
   - Cursor 延迟监控
   - 重试队列长度监控
   - 死信队列监控

## 测试结果

-  单元测试:49/49 通过 (100%)
-  代码覆盖率:28.5%
-  编译状态:无错误
-  支持数据库:PostgreSQL, MySQL, SQLite

## Breaking Changes

无破坏性变更。Persistence 模块作为可选功能,不影响现有代码。

## 版本信息

- 版本:v2.1.0
- Go 版本要求:1.21+
- 更新日期:2025-12-23
2025-12-23 18:59:43 +08:00

98 lines
2.5 KiB
Go

package persistence
import (
"testing"
"time"
)
func TestDefaultRetryWorkerConfig(t *testing.T) {
config := DefaultRetryWorkerConfig()
if config.RetryInterval != 30*time.Second {
t.Errorf("expected RetryInterval to be 30s, got %v", config.RetryInterval)
}
if config.MaxRetryCount != 5 {
t.Errorf("expected MaxRetryCount to be 5, got %d", config.MaxRetryCount)
}
if config.BatchSize != 100 {
t.Errorf("expected BatchSize to be 100, got %d", config.BatchSize)
}
if config.BackoffMultiplier != 2.0 {
t.Errorf("expected BackoffMultiplier to be 2.0, got %f", config.BackoffMultiplier)
}
if config.InitialBackoff != 1*time.Minute {
t.Errorf("expected InitialBackoff to be 1m, got %v", config.InitialBackoff)
}
}
func TestRetryWorkerConfig_CustomValues(t *testing.T) {
config := RetryWorkerConfig{
RetryInterval: 1 * time.Minute,
MaxRetryCount: 10,
BatchSize: 50,
BackoffMultiplier: 3.0,
InitialBackoff: 2 * time.Minute,
}
if config.RetryInterval != 1*time.Minute {
t.Errorf("expected RetryInterval to be 1m, got %v", config.RetryInterval)
}
if config.MaxRetryCount != 10 {
t.Errorf("expected MaxRetryCount to be 10, got %d", config.MaxRetryCount)
}
if config.BatchSize != 50 {
t.Errorf("expected BatchSize to be 50, got %d", config.BatchSize)
}
if config.BackoffMultiplier != 3.0 {
t.Errorf("expected BackoffMultiplier to be 3.0, got %f", config.BackoffMultiplier)
}
if config.InitialBackoff != 2*time.Minute {
t.Errorf("expected InitialBackoff to be 2m, got %v", config.InitialBackoff)
}
}
func TestRetryWorker_CalculateNextRetry(t *testing.T) {
config := RetryWorkerConfig{
InitialBackoff: 1 * time.Minute,
BackoffMultiplier: 2.0,
}
worker := &RetryWorker{
config: config,
}
tests := []struct {
name string
retryCount int
minDuration time.Duration
maxDuration time.Duration
}{
{"first retry", 0, 1 * time.Minute, 2 * time.Minute},
{"second retry", 1, 2 * time.Minute, 3 * time.Minute},
{"third retry", 2, 4 * time.Minute, 5 * time.Minute},
{"fourth retry", 3, 8 * time.Minute, 9 * time.Minute},
}
now := time.Now()
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
nextRetry := worker.calculateNextRetry(tt.retryCount)
duration := nextRetry.Sub(now)
if duration < tt.minDuration || duration > tt.maxDuration {
t.Errorf("retry %d: expected duration between %v and %v, got %v",
tt.retryCount, tt.minDuration, tt.maxDuration, duration)
}
})
}
}