GoLand调试HTTP接口前必须确认三件事：服务以可调试方式启动、监听本地地址（如127.0.0.1:8080而非localhost或0.0.0.0）、断点设在实际被调用的handler函数内。
GoLand 调试 HTTP 接口前必须确认的三件事
不能直接“调试接口”，GoLand 调试的是 main 函数启动的进程，HTTP 接口只是它暴露的服务端点。所以第一步不是点 Run → Debug，而是确认：你的 HTTP 服务是否以可调试方式启动？是否监听了本地地址？是否有断点落在实际被调用的 handler 里？
-
http.ListenAndServe必须绑定"127.0.0.1:8080"或，不能是 <code>"0.0.0.0:8080"（某些 macOS 环境下会触发调试器连接异常） - 确保
main函数入口存在且能正常启动服务，GoLand 的 Debug 模式只 attach 到这个进程，不支持对任意 HTTP 请求做“单次快照调试” - 断点要打在 handler 函数内部，比如
func handler(w http.ResponseWriter, r *http.Request)里，而不是路由注册行或http.HandleFunc调用处
在 GoLand 中设置断点并启动调试的具体步骤
GoLand 不需要额外插件，但默认配置容易漏掉关键项。最常踩的坑是：点了 Debug 却没进断点，或者进了断点但 r.FormValue、r.Body 显示为空。
- 右键点击
main.go文件 → Debug 'main'（不是 Run），确保右上角运行配置是Go Application类型，且Run kind是Package或File，不是Test - 在 handler 函数第一行设断点，比如
log.Println("got request")所在行；不要设在http.HandleFunc("/api/user", handler)这类注册语句上——那只是注册，不执行 - 用
curl或 Postman 发起请求：curl "http://127.0.0.1:8080/api/user?id=123"；注意：必须等 GoLand 控制台显示Server is running on :8080后再发请求，否则请求会失败且不会触发断点
为什么断点进了，但 r.Body 读出来是空的？
Go 的 http.Request.Body 是一次性读取流，GoLand 调试器在变量视图里预读一次，就会把 body buffer 消耗掉，导致你代码里再调用 io.ReadAll(r.Body) 得到空字节。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 临时解决：在断点处手动执行
r.Body = ioutil.NopCloser(bytes.NewBuffer(r.Body.Bytes()))（Go 1.16+ 改用io.NopCloser），但仅限调试时手动修复 - 长期写法：在 handler 开头就用
body, _ := io.ReadAll(r.Body)保存原始内容，后续都从body变量读，别反复读r.Body - 更稳妥的方式：用
r.ParseForm()或json.NewDecoder(r.Body).Decode(&v)直接解析，避免手动读流；调试时在解析前设断点，就能看到原始 payload
调试 POST JSON 接口时容易忽略的 Content-Type
GoLand 不干预 HTTP 请求头，但 handler 是否能正确解析 JSON，取决于你是否显式检查了 r.Header.Get("Content-Type")，而不仅是靠 json.Decode 抛错。
- 如果 Postman 发送 JSON 但没设
Content-Type: application/json，r.Header.Get("Content-Type")返回空字符串，json.Decode仍可能成功（只要 body 格式对），但业务逻辑可能依赖 header 做鉴权或路由 - 调试时在断点处直接看 Variables 面板里的
r.Headermap，展开后找Content-Type键；不要只看 Network 面板的请求头——那是客户端发的，不一定被服务端接收或识别 - 常见误操作：用浏览器地址栏直接访问
/api/user（GET），却在 handler 里写json.NewDecoder(r.Body).Decode(...)—— GET 请求没有 body，r.Body是http.NoBody，解码必然失败
真正卡住人的往往不是怎么点 Debug，而是请求没发对、断点没打在执行路径上、或者 body 被调试器提前消费了。留心这三点，比翻十遍官方文档管用。
