-
健康检查端点必须暴露/health且返回标准结构：{"status":"up","timestamp":"2024-05-22T10:32:15Z","service":"user-service","version":"v1.2.0"}，status仅限"up"/"down"，禁用嵌套、耗时操作和中间件，/health/live与/health/ready需分离实现。
-
在Go中，context是控制协程（goroutine）生命周期最标准、最推荐的方式。它不直接“杀死”协程，而是通过传递信号（如取消、超时）让协程主动退出，避免资源泄漏和竞态问题。用context.WithCancel主动取消协程当你需要在外部手动触发停止时，context.WithCancel是最基础的选择。它返回一个可取消的context和一个cancel函数。调用cancel()后，该context的Done()通道会立即关闭，监听它的goroutine可以感知并
-
gorilla/websocket.Upgrader.Upgrade()返回http.ErrUpgradeRequired是因客户端未发送正确的升级请求头，必须包含Upgrade:websocket和Connection:Upgrade。
-
测试工具函数应放在同包的helper_test.go中，使用与被测包一致的package名；需加t.Helper()，参数精简，失败用t.Fatal；外部依赖通过结构体封装状态；仅复用语义稳定、调用频繁、副作用可控的逻辑。
-
Go中无装饰器语法，需用高阶函数模拟：定义HandlerFunc类型，通过闭包包装实现前置/后置逻辑；装饰器组合为从外到内执行，如WithTimeout(WithRecovery(WithLogging(handler)))；HTTP场景需适配器转换签名，注意ctx传递、响应写入限制及panic捕获顺序。
-
使用NewRequest可自定义Header，通过Set设置单值、Add添加多值，注意避免修改受限制字段，并用Client发送请求。
-
swaginit生成的docs文件里没有接口，根本原因是handler函数缺少正确格式的Swagger注释或函数未导出；Gin路由参数需手动用@Param声明；SwaggerUI需通过gin-swagger包注册路由；struct字段必须导出并正确打tag才能显示在响应模型中。
-
Go通过os.Getenv读取环境变量并设默认值（如"development"），封装为Env()函数统一处理；测试用TestMain显式设置/清理环境变量，依赖抽象为接口注入mock；禁用init中初始化全局客户端，CI中单行透传变量。
-
Go的map并发读写会panic，因其非并发安全；sync.Map适用于读多写少场景，但有len不支持、迭代受限等限制；手动加锁更可控。
-
测试带context.Context的Go函数需主动构造可控上下文（如WithCancel/WithTimeout），手动触发取消或超时，精确断言errors.Is(err,context.Canceled)等，覆盖依赖响应与value边界场景。
-
Go1.11后模块缓存（$GOPATH/pkg/mod）取代GOPATH/src管理依赖，GOPATH仅用于存放工具（bin）和旧式构建产物（pkg），src不再存第三方包；模块缓存由Go自动维护，不可手动修改，路径通过GOPATH间接控制。
-
Go热重载不能直接反复gorun，因每次启动新进程而旧进程未清理导致端口占用，且gorun无文件监听能力；需借助air或fresh等工具实现构建、优雅重启与信号转发。
-
Go标准库未提供sync.Barrier，推荐用sync.WaitGroup加channel实现可重用屏障：每个goroutine到达时Add(1)并等待channel，最后一个到达者关闭旧channel、重置计数并创建新channel。
-
Go处理外部API错误的核心是主动检查error、区分网络层与业务层错误并设计对应策略：http.Client.Do不因HTTP状态码非2xx返回error，需手动检查StatusCode；网络错误属net.Error需类型断言判断Temporary/Timeout；JSON解析失败应校验Content-Type并记录原始响应；禁用DefaultClient，为各服务配置独立client及Transport参数。
-
最直接的方法是使用grafana-cli重置密码，需先停止Grafana服务，执行grafana-cliadminreset-admin-passwordnew_secure_password，再启动服务即可登录。
