-
Timer.Stop()返回false仅表示定时器已触发或已被停止，并非失败；正确做法是先Stop()再立即从t.C读一次（用select+default避免阻塞），确认无待处理时间后才Reset()。
-
用Outbox模式保障Publisher不丢数据：先写outbox表再发消息，与业务事务一致；Subscriber需按中间件特性配Ack、timeout；Router统一分发多topic；SSE需SSERouter+手动管理连接生命周期。
-
使用httptest可创建模拟HTTP服务器进行Go语言测试，避免依赖真实网络。1.通过httptest.NewServer启动本地服务器，返回自定义响应，验证客户端处理逻辑；2.可模拟不同状态码如404、500及超时情况，确保错误处理正确；3.结合依赖注入将baseURL作为参数传入，便于测试时替换为模拟服务器地址；4.复杂场景可选gock等库，但多数情况httptest已足够。合理使用能提升测试稳定性与速度。
-
MakeFunc生成的函数必须严格匹配目标签名，否则panic；需用reflect.TypeOf((*T)(nil)).Elem()获取原始类型，in/out切片须与参数/返回值数量类型完全对齐，闭包中调用原函数要注意reflect.Call性能开销和panic传播问题。
-
Go中无enum关键字，仅能通过const块+iota实现编译期整数常量枚举；iota在同const块中从0自动递增，支持跳过、偏移、位运算等变形用法。
-
本文介绍使用Go的map[string]interface{}动态解析JSON，快速提取嵌套字段（如Solr响应中的"response"），避免繁琐的struct定义，兼顾灵活性与开发效率。
-
推荐使用bufio.Writer批量缓冲写入——它默认维护4KB缓冲区，仅在满、显式Flush()或关闭时触发系统调用，显著减少系统调用次数并提升大文件写入效率。
-
database/sql自带连接池，需全局单次sql.Open并调用db.Ping()；SetMaxOpenConns与SetMaxIdleConns需满足前者≥后者，建议按峰值QPS×平均耗时×1.5估算并取数据库max_connections的70%为上限，Idle设为Open的1/2～2/3；SetConnMaxLifetime应略小于数据库wait_timeout（如MySQL300s设240s），避免stale连接。
-
sync.Map不适合多级缓存，因其仅为单层线程安全哈希表，缺乏过期、驱逐、穿透保护及层级联动能力，无法满足“本地快+远程稳+自动降级”核心诉求。
-
Go实现SSE推送核心是设对响应头、每次写完立刻flush、禁用超时；漏任一环节，EventSource即卡在connecting状态。
-
WebSocket连接建立后立刻断开，是因为Upgrade()前调用了WriteHeader()或Write()导致响应头已发送；广播时goroutine泄漏源于读循环无退出条件或同步广播；多客户端收不到消息因map并发读写未加锁；部署后连不上常因反向代理未透传Upgrade和Connection头。
-
sync.Map不适合高频配置读取，因Load需原子操作和指针跳转，比RWMutex读慢2–3倍；它不支持可靠遍历，Store可能触发dirty提升引发毛刺；纯读多场景应选RWMutex+带版本号map。
-
必须调用prometheus.MustRegister()注册指标，否则promhttp.Handler()返回空；需确认Prometheustargets为UP、Grafana数据源配置正确、模板指标名与代码一致。
-
从使用标准库log输出带时间戳的日志并重定向到文件开始，逐步引入logrus等第三方库实现结构化日志与多级别控制，结合环境变量区分开发与生产日志级别，通过日志分级、字段附加和定期轮转，提升Go项目的可观测性与维护效率。
-
必须手动设置QT_DIR指向具体Qt版本路径，如C:\Qt\5.15.2\mingw81_64，并确保qmake-v输出的版本号与QT_VERSION_MAJOR完全匹配；qtdeploy构建失败主因是CGO环境未对齐、平台插件缺失或动态库路径未嵌入。
