-
Go配置解析需区分文件读取与内容格式错误，用errors.As精准捕获viper或原生包异常，结合自定义校验、结构体tag和统一错误包装提升可维护性。
-
使用zap实现结构化日志，支持多通道输出至控制台、文件及远程服务，结合lumberjack实现日志轮转，通过request_id实现上下文追踪，提升系统可观测性。
-
本文讲解使用stacktic/dropbox客户端库时，如何正确处理ClientMtime字段——它本质是封装了time.Time的自定义类型，应直接调用String()或Format()方法获取可读日期，而非错误地调用UnmarshalJSON。
-
readinessProbe必须在SIGTERM后立即失败：Go应用需收到信号后立即将/readyz返回503，配合failureThreshold:1和periodSeconds:5实现秒级摘流，并同步执行连接排空（如GracefulStop或Shutdown），确保长连接请求处理完毕。
-
Go HTTP 请求断开后，r.Context() 会收到取消信号，但服务端慢任务不会凭空停止。只有把 context 继续传给数据库、下游 HTTP 调用、消息消费和 goroutine，取消与超时才会真正变成资源释放动作。
-
最稳妥方式是os.LookupEnv：返回value和ok两个值，可明确判断环境变量是否存在；os.Getenv仅返回字符串，查不到时静默返回空串，易导致后续panic。
-
Go文件上传必须先调ParseMultipartForm，否则r.FormFile和r.MultipartForm.File均失效；常见错误是未调用或调用过晚（如在FormValue后），导致返回http.ErrNotMultipart。
-
真正的优雅关闭是等待HTTP请求完成、后台goroutine收尾、数据库连接池清空后再退出；需用context统一驱动server.Shutdown()、db.Close()及自定义goroutine退出，并为DB操作设超时避免卡死。
-
使用fmt.Errorf配合%w可包装错误并保留原始信息，通过errors.Unwrap、Is和As能提取或判断错误链中的具体错误，支持多层上下文添加与精准处理。
-
GORM软删除本质是更新DeletedAt字段而非物理删除，需用*time.Time类型并嵌入gorm.Model；Delete()默认软删，Unscoped().Delete()才硬删；查询默认过滤软删数据，关联预加载不自动过滤。
-
Go中exec.Command不支持shell管道语法，需显式调用sh：exec.Command("/bin/sh","-c","ls|grepmain")；StdoutPipe()须在Start()前调用，且cmd1与cmd2均需Wait()并正确关闭管道。
-
因为Scan要求参数为字段地址且顺序类型严格匹配，而结构体字段命名、大小写、跳过标记等与SQL列名不一致；需用反射结合dbtag实现列名到导出字段的自动映射，并注意NULL处理、缓存优化及类型兼容。
-
Go 服务突然报 too many open files 时，先用 /proc/fd 和 lsof 判断文件描述符消耗，再检查 HTTP 响应体关闭、连接复用和 ulimit 配置，最后用指标与回滚手段确认修复有效。
-
net.DialTimeout是Go检测端口开放最直接可靠方式，一行代码conn,err:=net.DialTimeout("tcp","127.0.0.1:22",2*time.Second)即可：err为nil表示端口开放；超时多为过滤，connectionrefused为关闭，noroutetohost为主机不可达；并发需控速，内网50–100、公网10–30，用带缓冲channel限流。
-
Go单元测试应优先使用标准testing包，测试函数须以Test开头、接收*testing.T参数并置于同包的_test.go文件中；推荐用t.Run组织子测试、t.Parallel加速并发、避免t.Fatal滥用，并通过接口抽象解耦依赖。
