test: 后端测试从 SQLite 全面切换到 MySQL,与生产环境对齐

测试库不再使用 SQLite 内存库,改为每个测试包独立的 MySQL 库,
表结构由 backend/migrations 的真实迁移建立。

基础设施
- 新增 internal/database/testdb.go:NewTestDB() 保持原签名(28 处调用零改动),
  内部连接 MySQL 测试库,首次调用重建库并执行全部真实迁移,之后每次调用清空全表
- 库名 = 测试库基础名 + 包目录名,同包共享、跨包隔离,使 go test ./... 可并发执行
  (共用一库时各包会互相 DROP/CREATE 导致 database exists)
- 新增 NewDryRunDB():MySQL 方言 + DryRun,供断言 SQL 形态的 5 处测试使用
- 新增 AutoMigrateIfMissing():只对不存在的表 AutoMigrate,
  避免改动迁移定义的索引与约束
- 新增 scripts/prepare-test-db.sh:建库与通配授权,可重复执行
- 33 处 sqlite.Open 全部替换,26 个测试文件改用 MySQL
- 删除 46 处手写 SQLite 方言 DDL(AUTOINCREMENT / INTEGER PRIMARY KEY / TEXT),
  表统一由真实迁移建立
- go.mod 移除 gorm.io/driver/sqlite 与 mattn/go-sqlite3
- 删除生产代码里 distribution/repository.go 的 sqlite 方言分支(strftime)

对齐环境后暴露并修复的真实问题
- DATE(col) 在 MySQL 返回 DATE 类型,使 Date string 字段变成 RFC3339 时间串,
  大盘日期会带出时间部分;28 处改为 DATE_FORMAT(col, '%Y-%m-%d')
- 系统自动创建分销结算批次时 created_by 写入 0,违反指向 admin_users 的外键,
  生产会直接插入失败;改为写 NULL(新增 adminRef helper)
- MySQL DATETIME 仅到秒,静默截断 Go 侧写入的时间,
  导致租用时长计算与结算时点回读比对偏差;
  rental_orders 的 9 个业务时间列提到 DATETIME(6)
- 测试数据补齐严格模式要求的 NOT NULL 列、修正超出列长的取值、补齐外键父记录

迁移
- 000065 的 ALTER TABLE rental_orders 一并完成业务时间列精度调整,
  feature 侧不再单开迁移文件

脚本与文档
- check.sh / check-backend-coverage.sh 去掉 -p 1 串行与 SQLite 相关注释
- 更新 docs/Repository层测试补充总结.md 的测试运行说明
This commit is contained in:
yml2213
2026-09-10 14:34:01 +08:00
parent 2b8c74a0f1
commit cbd5412315
72 changed files with 933 additions and 1002 deletions
+20 -14
View File
@@ -31,7 +31,7 @@
- ✅ `TestNewLedgerNoUsesReadableFormat` - 流水号格式验证
#### 1.2 集成测试 (`repository_integration_test.go`)
创建了 **9 个集成测试用例**,使用内存 SQLite 数据库:
创建了 **9 个集成测试用例**,使用 MySQL 测试库:
**Account 相关**:
- ✅ `TestRepositoryAccountCreatesAccountIfNotExists` - 账户自动创建
@@ -54,15 +54,15 @@
#### 2.1 测试辅助工具 (`database/test_helper.go`)
创建了数据库测试辅助函数:
```go
func NewTestDB() *gorm.DB // 创建内存数据库
func NewTestDBWithName(name string) *gorm.DB // 创建命名内存数据库(支持多连接)
func NewTestDB() *gorm.DB // 返回指向 MySQL 测试库的干净连接
func NewDryRunDB() *gorm.DB // MySQL 方言的 DryRun 连接,仅生成 SQL 不执行
```
**优势**:
- 使用 SQLite 内存数据库,无需 MySQL 环境
- 测试速度快(纯内存操作)
- 测试隔离性好(每个测试独立数据库)
- 支持并发测试
**特点**:
- 测试跑在真实 MySQL 上,表结构由 `backend/migrations` 的真实迁移建立,与生产一致
- 每个测试包使用独立库 `hfb_sys_test_<包名>`,因此 `go test ./...` 可并发执行
- 每次 `NewTestDB()` 调用会清空全部表,测试之间互相隔离
- 需要 MySQL 可用:首次执行 `bash scripts/prepare-test-db.sh` 完成建库授权
---
@@ -209,11 +209,17 @@ func TestXxx(t *testing.T) {
## 🚀 如何运行测试
### 1. **首次运行(需要安装 SQLite 驱动)**
### 1. **首次运行(需要准备 MySQL 测试库)**
```bash
cd backend
go mod tidy # 下载依赖(包括 gorm.io/driver/sqlite)
# 启动本地 MySQL(如未启动)
bash scripts/dev.sh
# 建库并授权(可重复执行,只需一次)
bash scripts/prepare-test-db.sh
```
测试库由测试代码自行创建:首次连接时会重建 `hfb_sys_test_<包名>` 并执行
`backend/migrations` 下的真实迁移,无需手工建表。
可通过 `HFB_TEST_DSN` 覆盖测试库连接(库名必须包含 `test` 或 `e2e`)。
### 2. **运行所有 wallet 模块测试**
```bash
@@ -290,11 +296,11 @@ go tool cover -html=coverage.out
---
**备注**:
- 集成测试需要先运行 `go mod tidy` 下载 SQLite 驱动
- 所有测试代码已编写完成,等待依赖安装后即可运行
- 集成测试跑在真实 MySQL 上,需先执行 `bash scripts/prepare-test-db.sh` 完成建库授权
- 表结构来自 `backend/migrations` 的真实迁移,测试环境与生产一致
- 测试覆盖了核心业务逻辑、边界条件、并发安全和数据一致性
**下一步建议**:
1. 运行 `go mod tidy` 安装依赖
1. 执行 `bash scripts/prepare-test-db.sh` 准备测试库
2. 运行 wallet 模块所有测试验证通过
3. 继续为 order 和 payment 模块补充 Repository 层测试