-
Bun是SQL构建器+运行时映射器，非ORM：不生成SQL、不维护状态、无懒加载；需手动写查询逻辑，显式调用Scan/Exec，结构体须标注pk/array标签，JSONB用json.RawMessage，事务需正确传递tx实例，分页推荐游标而非OFFSET/LIMIT。
-
Go原生gotest提供简洁高效的自动化测试能力，关键在于理解其设计逻辑并合理组织代码、标记、执行方式和集成路径。
-
Go模板通过{{}}绑定数据，支持变量输出、条件判断、循环控制及嵌套模板，结合自定义函数实现安全高效的动态内容生成，适用于Web渲染等场景。
-
errgroup.Wait()仅返回第一个非nil错误，后续错误被丢弃，需在Group.Go()中即时判断错误类型而非等待Wait()返回后处理。
-
Go通过返回error类型显式处理网络错误，需每次操作后检查；2.常见错误包括连接超时、主机不可达、连接重置等，可通过*net.OpError类型断言判断；3.利用Temporary()和Timeout()方法区分临时性与永久性错误，指导重试策略。
-
双令牌机制是唯一稳妥路径，因单靠time.Now().After(claims.ExpiresAt)判断会引发并发刷新冲突、令牌复用及状态失控；refreshToken必须绑定设备指纹、存入Redis并强制jti轮换，前端需共享Promise排队刷新。
-
协程泄漏是runtime.NumGoroutine()持续单向上涨且pprofdebug=2显示大量goroutine卡在chanreceive/select/semacquire；需排除初始化波动，重点监控请求后不回落、压测后不恢复、长期单调上升三种趋势，并结合三处日志、pprof快照对比及goleak测试拦截定位修复。
-
使用gotest的-coverprofile参数生成代码覆盖率报告，先运行gotest-coverprofile=coverage.out得到profile文件，再通过gotoolcover-html=coverage.out-ocoverage.html生成HTML报告；若需合并多包覆盖率，可在项目根目录执行gotest-coverprofile=coverage.out./...；注意测试通过性、历史数据覆盖及CI/CD中的集成应用。
-
sync.Map适用于单机、短生命周期任务去重，需LoadOrStore判断存在性并deferDelete防泄漏；Redis+Lua实现跨实例原子去重；数据库唯一索引提供强一致性；MQ自身去重不可替代业务层key维度去重。
-
sync.Map在写多时性能劣于sync.RWMutex+map，因频繁Store触发O(N)阻塞晋升，导致读写全卡住、吞吐降2–3倍，且Range快照不准、LoadOrStore语义易误用。
-
Go配置解析需区分文件读取与内容格式错误，用errors.As精准捕获viper或原生包异常，结合自定义校验、结构体tag和统一错误包装提升可维护性。
-
Activator.CreateInstance在对象池中不推荐直接使用，因其每次调用均绕过JIT缓存、触发类型检查与构造函数反射解析，性能开销大；应优先用Expression.Lambda编译缓存Func<T>委托，或至少缓存ConstructorInfo。
-
debug.PrintStack()可快速打印当前goroutine堆栈，不终止程序但无格式；errors.WithStack()保留原始错误堆栈，适合链式错误；runtime.Caller()手动提取调用信息；pprof可查看所有goroutine全局堆栈。
-
应使用redis.NewClusterClient()连接Redis集群，传入初始节点列表（至少2个），启用自动重定向与槽位路由，避免误用NewClient()；Key需通过{tag}控制哈希槽，禁用跨槽命令如KEYS、事务等。
-
最稳妥组合是sync.Mutex+container/list.List+map[string]*list.Element；因其封装链表指针操作、避免裸指针误用，配合统一锁保护所有读写与淘汰逻辑，能可靠实现原子性与并发安全。
