junhong_cmp_fiber/docs/add-user-organization-model/测试总结.md

Shop Service 单元测试总结

测试文件: tests/unit/shop_service_test.go 完成时间: 2026-01-09 状态: ✅ 全部通过

---

一、测试概述

本次为 Shop Service（店铺业务服务层）编写了完整的单元测试，重点验证了层级校验逻辑、业务规则验证和错误处理。

---

二、测试覆盖

2.1 TestShopService_Create（创建店铺）

测试用例数: 6 个 全部通过: ✅

测试用例	目的	状态
创建一级店铺成功	验证创建一级店铺的基本流程	✅
创建二级店铺成功	验证创建下级店铺并正确计算层级	✅
层级校验-创建第8级店铺应失败	核心测试：验证最大层级限制（7级）	✅
店铺编号唯一性检查-重复编号应失败	验证店铺编号唯一性约束	✅
上级店铺不存在应失败	验证上级店铺存在性检查	✅
未授权访问应失败	验证用户授权检查	✅

核心测试详解：

// 创建 7 级店铺层级结构
for i := 1; i <= 7; i++ {
    var parentID *uint
    if i > 1 {
        parentID = &shops[i-2].ID
    }
    // 创建第 i 级店铺
    shopModel := &model.Shop{
        Level:    i,
        ParentID: parentID,
        // ...
    }
    err := shopStore.Create(ctx, shopModel)
    require.NoError(t, err)
}

// 尝试创建第 8 级店铺（应该失败）
req := &model.CreateShopRequest{
    ParentID: &shops[6].ID, // 第7级店铺的ID
    // ...
}
result, err := service.Create(ctx, req)
assert.Error(t, err)

// 验证错误码
appErr, ok := err.(*errors.AppError)
require.True(t, ok)
assert.Equal(t, errors.CodeShopLevelExceeded, appErr.Code)
assert.Contains(t, appErr.Message, "不能超过 7 级")

2.2 TestShopService_Update（更新店铺）

测试用例数: 4 个 全部通过: ✅

测试用例	目的	状态
更新店铺信息成功	验证更新店铺基本信息	✅
更新店铺编号-唯一性检查	验证更新时的编号唯一性	✅
更新不存在的店铺应失败	验证店铺存在性检查	✅
未授权访问应失败	验证用户授权检查	✅

2.3 TestShopService_Disable（禁用店铺）

测试用例数: 3 个 全部通过: ✅

测试用例	目的	状态
禁用店铺成功	验证禁用功能并检查状态变更	✅
禁用不存在的店铺应失败	验证店铺存在性检查	✅
未授权访问应失败	验证用户授权检查	✅

2.4 TestShopService_Enable（启用店铺）

测试用例数: 3 个 全部通过: ✅

测试用例	目的	状态
启用店铺成功	验证启用功能并检查状态变更	✅
启用不存在的店铺应失败	验证店铺存在性检查	✅
未授权访问应失败	验证用户授权检查	✅

注意事项：

• GORM 在保存时会忽略零值（Status=0），导致使用数据库默认值
• 测试中先创建启用状态的店铺，再通过 Update 禁用，最后测试 Enable 功能

2.5 TestShopService_GetByID（获取店铺详情）

测试用例数: 2 个 全部通过: ✅

测试用例	目的	状态
获取存在的店铺	验证正常查询流程	✅
获取不存在的店铺应失败	验证错误处理	✅

2.6 TestShopService_List（查询店铺列表）

测试用例数: 1 个 全部通过: ✅

测试用例	目的	状态
查询店铺列表	验证列表查询功能	✅

2.7 TestShopService_GetSubordinateShopIDs（获取下级店铺ID列表）

测试用例数: 1 个 全部通过: ✅

测试用例	目的	状态
获取下级店铺 ID 列表	验证递归查询功能	✅

---

三、测试结果

=== RUN   TestShopService_Create
--- PASS: TestShopService_Create (11.25s)
    --- PASS: TestShopService_Create/创建一级店铺成功 (0.16s)
    --- PASS: TestShopService_Create/创建二级店铺成功 (0.29s)
    --- PASS: TestShopService_Create/层级校验-创建第8级店铺应失败 (0.59s)
    --- PASS: TestShopService_Create/店铺编号唯一性检查-重复编号应失败 (0.14s)
    --- PASS: TestShopService_Create/上级店铺不存在应失败 (0.07s)
    --- PASS: TestShopService_Create/未授权访问应失败 (0.00s)

=== RUN   TestShopService_Update
--- PASS: TestShopService_Update (7.86s)
    --- PASS: TestShopService_Update/更新店铺信息成功 (0.22s)
    --- PASS: TestShopService_Update/更新店铺编号-唯一性检查 (0.16s)
    --- PASS: TestShopService_Update/更新不存在的店铺应失败 (0.02s)
    --- PASS: TestShopService_Update/未授权访问应失败 (0.00s)

=== RUN   TestShopService_Disable
--- PASS: TestShopService_Disable (8.01s)
    --- PASS: TestShopService_Disable/禁用店铺成功 (0.29s)
    --- PASS: TestShopService_Disable/禁用不存在的店铺应失败 (0.02s)
    --- PASS: TestShopService_Disable/未授权访问应失败 (0.00s)

=== RUN   TestShopService_Enable
--- PASS: TestShopService_Enable (9.29s)
    --- PASS: TestShopService_Enable/启用店铺成功 (0.49s)
    --- PASS: TestShopService_Enable/启用不存在的店铺应失败 (0.03s)
    --- PASS: TestShopService_Enable/未授权访问应失败 (0.00s)

=== RUN   TestShopService_GetByID
--- PASS: TestShopService_GetByID (9.27s)
    --- PASS: TestShopService_GetByID/获取存在的店铺 (0.18s)
    --- PASS: TestShopService_GetByID/获取不存在的店铺应失败 (0.04s)

=== RUN   TestShopService_List
--- PASS: TestShopService_List (9.24s)
    --- PASS: TestShopService_List/查询店铺列表 (0.45s)

=== RUN   TestShopService_GetSubordinateShopIDs
--- PASS: TestShopService_GetSubordinateShopIDs (8.98s)
    --- PASS: TestShopService_GetSubordinateShopIDs/获取下级店铺_ID_列表 (0.40s)

PASS
ok  	command-line-arguments	64.887s

总计: 20 个测试用例全部通过 ✅

---

四、测试要点

4.1 Context 用户 ID 模拟

Service 层需要从 Context 中获取当前用户 ID，测试中使用辅助函数模拟：

// createContextWithUserID 创建带用户 ID 的 context
func createContextWithUserID(userID uint) context.Context {
    return context.WithValue(context.Background(), constants.ContextKeyUserID, userID)
}

4.2 层级校验测试策略

7 级层级创建：

1. 循环创建 1-7 级店铺，每级店铺的 parent_id 指向上一级
2. 验证第 7 级店铺创建成功
3. 尝试创建第 8 级店铺，验证返回 CodeShopLevelExceeded 错误

关键代码：

// 计算新店铺的层级
level = parent.Level + 1

// 校验层级不超过最大值
if level > constants.MaxShopLevel {
    return nil, errors.New(errors.CodeShopLevelExceeded, "店铺层级不能超过 7 级")
}

4.3 唯一性约束测试

店铺编号唯一性：

1. 创建第一个店铺（编号 CODE_001）
2. 尝试创建第二个相同编号的店铺
3. 验证返回 CodeShopCodeExists 错误

更新时唯一性检查：

1. 创建两个不同编号的店铺（CODE_001、CODE_002）
2. 尝试将 CODE_002 更新为 CODE_001
3. 验证返回 CodeShopCodeExists 错误

4.4 授权检查测试

所有需要授权的方法都测试了未授权访问场景：

• Create
• Update
• Disable
• Enable

使用不带用户 ID 的 context.Background() 模拟未授权访问，验证返回 CodeUnauthorized 错误。

4.5 错误码验证

所有错误测试都验证了具体的错误码：

// 验证错误码
appErr, ok := err.(*errors.AppError)
require.True(t, ok, "错误应该是 AppError 类型")
assert.Equal(t, errors.CodeShopLevelExceeded, appErr.Code)
assert.Contains(t, appErr.Message, "不能超过 7 级")

---

五、测试覆盖的业务逻辑

5.1 Create 方法

✅ 用户授权检查 ✅ 店铺编号唯一性检查 ✅ 上级店铺存在性验证 ✅ 层级计算（level = parent.Level + 1） ✅ 层级校验（最多 7 级） ✅ 默认状态设置（StatusEnabled） ✅ Creator/Updater 字段设置

5.2 Update 方法

✅ 用户授权检查 ✅ 店铺存在性验证 ✅ 店铺编号唯一性检查（如果修改了编号） ✅ 部分字段更新（使用指针判断是否更新） ✅ Updater 字段更新

5.3 Disable/Enable 方法

✅ 用户授权检查 ✅ 店铺存在性验证 ✅ 状态更新 ✅ Updater 字段更新

5.4 GetByID 方法

✅ 店铺存在性验证 ✅ 错误处理（店铺不存在）

5.5 List 方法

✅ 列表查询功能 ✅ 分页支持

5.6 GetSubordinateShopIDs 方法

✅ 递归查询下级店铺 ✅ 包含自己（用于数据权限过滤）

---

六、测试技巧和最佳实践

6.1 Table-Driven Tests

虽然本次测试主要使用 t.Run() 子测试，但在 Create 测试中展示了适合多用例的场景。

6.2 辅助函数

func createContextWithUserID(userID uint) context.Context {
    return context.WithValue(context.Background(), constants.ContextKeyUserID, userID)
}

封装常用操作，提高测试代码的可读性和可维护性。

6.3 错误验证模式

// 1. 验证有错误
assert.Error(t, err)
assert.Nil(t, result)

// 2. 验证错误类型
appErr, ok := err.(*errors.AppError)
require.True(t, ok)

// 3. 验证错误码
assert.Equal(t, errors.CodeXxx, appErr.Code)

// 4. 验证错误消息
assert.Contains(t, appErr.Message, "关键词")

6.4 数据准备和清理

使用 testutils.SetupTestDB() 和 defer testutils.TeardownTestDB() 确保测试隔离：

db, redisClient := testutils.SetupTestDB(t)
defer testutils.TeardownTestDB(t, db, redisClient)

---

七、遗留问题和改进建议

7.1 已解决的问题

问题: GORM 零值处理 现象: 创建 Status=0（StatusDisabled）的店铺时，GORM 忽略零值，使用数据库默认值 1 解决: 先创建启用状态的店铺，再通过 Update 禁用

改进建议: 在 Shop model 中使用 *int 指针类型存储 Status，或使用 gorm:"default:0" 显式指定默认值

7.2 未来优化方向

1. 性能测试: 测试 7 级递归查询的性能
2. 并发测试: 测试并发创建相同编号的店铺
3. 集成测试: 测试 Service 层与 Handler 层的集成
4. 边界测试: 测试极端场景（如超长字符串、特殊字符）

---

八、总结

完成度

✅ 100% 完成 - 所有计划的测试用例都已实现并通过

测试质量

• ✅ 覆盖所有公开方法
• ✅ 重点测试核心业务逻辑（层级校验）
• ✅ 完整的错误处理验证
• ✅ 授权检查覆盖
• ✅ 边界条件测试

核心成果

最重要的测试：层级校验测试（创建第8级店铺应失败）

这个测试验证了系统的核心业务规则：

• 店铺层级最多 7 级
• 超过限制时正确返回错误码
• 错误消息清晰明确

这确保了系统在生产环境中不会出现超过 7 级的店铺层级，符合业务需求。

---

测试完成时间: 2026-01-09 测试通过率: 100% (20/20) 总耗时: 64.887s