-
TLS是微服务通信安全基础，Golang原生支持；HTTP可单向认证（ListenAndServeTLS），gRPC天然支持；mTLS需双向证书校验，须注意证书有效期、域名匹配与私钥保护。
-
Go语言通过error接口和errors包实现错误处理，使用errors.New创建基本错误，fmt.Errorf生成带格式的错误信息，并通过errors.Is判断特定错误类型以进行相应处理。
-
应定义统一的SearchRequest和SearchResult契约，字段仅含通用部分（Query/Offset/Limit/Total），引擎特有逻辑由具体策略内部处理；分页与过滤映射也下放至各策略，避免跨引擎语义耦合。
-
Wire是编译前代码生成器，通过wirebuild生成inject.go中的手动初始化代码，不参与运行时注入；provider函数需满足签名可推导、无副作用，inject.go必须提交至Git且CI中需前置执行wirebuild。
-
Pebble数据库需用pebble.Open()初始化并检查err，Close()必须调用以防止数据丢失；路径须可写，Options至少设BytesPerSync和FS；Get/Put要求[]byte且key不可为nil；批量写需防超长key；Pebble适用于高吞吐OLTP场景，无SQL、事务隔离或二级索引。
-
gomodtidy升级不该升级的依赖是因MVS全局计算最小版本集合，某间接依赖被其他模块的高版本要求拉高；应显式require所需版本并用exclude控制高版本。
-
gRPCServer无法直接热更新listener的根本原因是Go的net.Listener为阻塞接口，Serve()卡在Accept()中，Close()会中断请求；正确做法是双listener并行，旧listener用GracefulStop()等待RPC完结，新listener接管新连接，并需复用端口、超时控制与连接数监控。
-
Go反射通过reflect包实现，核心是Type和Value；第一律：接口可转反射对象；第二律：反射对象可还原为接口；第三律：修改需可设置；常用于序列化、ORM、配置绑定等场景，但性能开销大，应避免在热路径使用。
-
Go接口通过隐式实现方法提供多态性，无需显式声明；只要类型实现接口所有方法即可赋值使用，支持值或指针接收者，结合空接口与类型断言可处理任意类型。
-
指针存储变量内存地址，使用&获取地址，*解引用访问值，Go中指针支持基础类型到复杂结构的操作。
-
选用miniredis是因为单元测试需快速、可重复且不依赖外部服务；它是纯Go实现的内存版Redis，兼容主流命令协议，启动零延迟并支持直接嵌入测试进程。
-
Go通过接口和组合实现模板方法模式，定义DataProcessor接口封装可变步骤，Execute函数作为模板方法固定算法流程：加载→验证→处理→保存。不同业务如用户输入、文件处理通过实现接口定制行为，调用时传入具体处理器实例，复用执行逻辑，提升代码可维护性与扩展性。
-
log.Printf无法支撑微服务链路追踪，因其缺乏全局唯一且透传的trace_id，导致跨服务请求日志上下文丢失；需结合context.Context与zap自动注入trace_id，并统一用OpenTelemetrypropagator处理HTTP/gRPC协议透传，采样应基于trace_id哈希而非随机。
-
数据库驱动加载失败时sql.Open不报错，但db.Ping()才暴露问题Go的sql.Open只校验连接字符串格式，不真正连接数据库，也不检查驱动是否注册。常见现象是：代码编译通过、sql.Open返回非nil的*sql.DB，但后续调用db.Query或db.Ping()时才爆出sql:unknowndriver"mysql"(forgottenimport?)。根本原因是驱动没被匿名导入（即没触发其init()函数），导致sql.Register
-
container/ring不适合滑动窗口因其非连续内存、无容量限制、不支持O(1)头尾操作及随机访问，导致性能差且易漏清理；高效实现应使用切片+head/tail游标，配合2的幂容量与位运算绕回。
