测试 http handler 应直接调用函数并伪造请求响应，用 httptest.newrequest 和 httptest.newrecorder 验证结果；需手动补全 net/http、net/http/httptest 等 import；并发测试须加 -race；外部 http 调用必须 mock。
测试 HTTP handler 时别直接跑 main 函数
网络逻辑（比如 http.HandlerFunc）通常不依赖完整服务启动，硬起一个 http.ListenAndServe 再发请求，既慢又难断点调试。GoLand 的单元测试支持能直接调用 handler 函数，传入伪造的 *http.Request 和 http.ResponseWriter，验证响应状态、头、正文即可。
- 用
httptest.NewRequest构造请求，支持任意 method、path、body、header - 用
httptest.NewRecorder捕获响应，之后可检查rec.Code、rec.Body.String()、rec.Header() - 避免在测试里写
log.Fatal或panic，否则测试进程会退出，GoLand 显示 “test finished with error” 但不报具体行
右键生成 test 文件后要手动补 import
GoLand 2023.2+ 能自动识别函数签名并生成 TestXxx 框架，但对网络相关类型（如 http.Request、httptest）不会自动加 net/http 和 net/http/httptest 导入——这是高频遗漏点。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 生成后立刻检查顶部 import 列表，缺就补：
"net/http"、"net/http/httptest" - 如果用了 JSON 解析，还得加
"encoding/json"；用了 URL 查询参数，可能需要"net/url" - GoLand 不会为
httptest类型自动补 import，哪怕你代码里写了httptest.NewRecorder()，它也只提示“unresolved reference”，得手动加
测试并发 handler 要开 -race 标志
网络 handler 经常读写共享变量（如计数器、缓存 map），但单元测试默认不开启竞态检测，等上线才暴露问题。
- 在 GoLand 的测试配置里，找到 “Go tool arguments”，填入
-race - 或者直接在测试函数上右键 → “Run ‘TestXxx’ with -race”（GoLand 2024.1+ 支持快捷开关）
- 注意：启用
-race后测试变慢，不要长期开着跑全部测试；只对疑似有并发读写的 handler 单独加 - 典型报错是
WARNING: DATA RACE，后面跟着读/写 goroutine 的栈，定位比日志埋点快得多
Mock 外部 HTTP 调用必须用 http.Client 替换
handler 里如果调用了第三方 API（比如用 http.DefaultClient.Do(req)），测试时不能真发请求——超时、不可控、破坏隔离性。
- 把 client 提成函数参数或结构体字段，测试时传入自定义
&http.Client{Transport: &mockRoundTripper{}} - 更轻量的做法：用
httptest.Server启一个本地 mock server，把 handler 里的 target URL 指向它 - 别用
os.Setenv临时改环境变量来切 mock 开关——GoLand 测试运行在独立进程，环境变量改动不生效 - 常见坑：忘记在测试末尾调用
mockServer.Close()，导致端口被占，下次测试失败
