Repository接口应按业务语义命名（如FindRecentActiveUsers），返回DTO而非实体，SQL逻辑封装在实现中，避免泛型抽象陷阱，测试用SQLite内存模式验证真实查询行为。
Repository接口定义要和业务语义对齐，别照搬数据库表名
很多人一写 Repository 就直接按 User 表定义 FindById(id int) (*User, error)，结果业务里要查“最近3天注册的活跃用户”，要么硬塞进 FindById，要么加一堆带条件的查找方法，接口迅速膨胀。真正该做的是面向用例设计方法名：FindRecentActiveUsers(days int)、FindUsersByStatusAndRole(status string, role string)。接口返回类型也别暴露底层结构，比如用 UserInfo 而非 User，避免业务层意外依赖数据库字段。
SQL查询逻辑必须收在Repository实现里，不能泄露到Service
常见错误是 Service 层拼 SQL 或调用 db.Where(...).Select(...) —— 这等于把数据访问细节和业务逻辑耦合死了。正确做法是：所有 SQL、JOIN、分页、缓存策略都封装在 Repository 的具体实现（如 userRepoDB）中。比如分页，不要让 Service 传 offset 和 limit，而是传 PageRequest{Page: 1, Size: 20}，由 Repository 决定用 LIMIT/OFFSET 还是游标分页。如果后续换 Redis 缓存实现，Service 完全不用改。
Go里用泛型写BaseRepository容易踩坑
有人想抽象出 type BaseRepo[T any] interface { Save(*T) error }，但实际会遇到三个问题：
• T 无法约束有 ID 字段，导致通用 FindById 实现困难
• 泛型接口无法被不同实体共用（UserRepo 和 OrderRepo 仍是独立接口）
• ORM 如 GORM 的 First() 返回值类型依赖具体 struct，泛型擦除后难适配
更务实的做法是：按领域边界定义接口（如 UserRepository），复用逻辑用组合而非继承——比如单独写 func Paginate(db *gorm.DB, pageReq PageRequest, out interface{}) error 工具函数。
测试Repository时别 mock 数据库连接，用Sqlite内存模式
用 mock 模拟 db.QueryRow() 看似快，但掩盖了 SQL 语法错误、字段类型不匹配、NULL 处理异常等真实问题。GORM 或 sqlx 都支持内存 SQLite：gorm.Open(sqlite.Open(":memory:"), ...)。这样可以：
• 在测试里完整走一遍建表、插入、查询流程
• 验证 JOIN 结果结构、COUNT 是否准确、时间字段是否自动扫描
• 不依赖 Docker 或外部 DB 服务，CI 里也能跑
注意提前 AutoMigrate 表结构，且记得每个 test case 用新 DB 实例或事务回滚，避免测试间污染。
立即学习“go语言免费学习笔记（深入）”；
Repository 模式在 Go 里最易被忽略的点，是没把「查询意图」和「存储实现」真正分开——接口名还在写 GetByID，实现却悄悄加了 Redis 缓存穿透校验；或者为了性能在 Service 层绕过 Repository 直连 DB。这些都会让模式变成假抽象。关键不是接口多规范，而是每次新增一个方法前，先问：这个查询在当前业务上下文里叫什么？它是否可能被另一种存储（比如 Elasticsearch 或本地 map）实现？
