go标准库函数本身无坑，坑在于调用时的假设偏差；time.parse会panic而非返回error，strings.replaceall容错而bytes.replaceall对nil切片panic，http.newrequest默认不设host导致网关400，json.unmarshal对大整数静默截断。
标准库函数本身没坑，坑在你调用它时的假设和上下文。 Go 标准库设计克制、行为明确，但很多 runtime panic 或静默失败，都源于开发者对函数契约（contract）理解偏差或忽略文档细节。
time.Parse 会 panic，而不是返回 error
很多人以为 time.Parse 和大多数 I/O 函数一样，出错返回 error；实际上它在格式不匹配、时间字符串非法时直接 panic —— 这不是 bug，是设计选择。
- 常见错误现象：
panic: parsing time "2023-13-01": month out of range，而调用处没 recover - 使用场景：用户输入、日志解析、API 参数解析等不可信输入源
- 正确做法：必须用
recover()包裹，或改用time.ParseInLocation+ 显式判断 err（它也 panic，同理） - 替代方案更安全：先用
time.TryParse？—— Go 没这个函数。只能自己封装：func safeParse(layout, value string) (time.Time, error) {<br> defer func() {<br> if r := recover(); r != nil {<br> if _, ok := r.(string); ok {<br> return time.Time{}, fmt.Errorf("time parse panic: %v", r)<br> }<br> }<br> }()<br> return time.Parse(layout, value)<br>}
strings.ReplaceAll 不处理 nil 字符串，但 bytes.ReplaceAll 会 panic
看似对称的两个函数，行为不一致：前者接受 nil 输入并返回空字符串；后者传入 nil 的 []byte 会直接 panic。
- 常见错误现象：
panic: runtime error: slice bounds out of range [:0] with capacity 0（实际是 nil 切片解引用） - 使用场景：从 map 或 JSON 解析中取值后直接传给
bytes.ReplaceAll，未判空 - 参数差异：
strings.ReplaceAll(string, string, string)入参是值类型，nil字符串在 Go 中不存在（空字符串 "" 是合法值）；而[]byte是切片，可为 nil - 建议：统一做非空检查，或封装一层：
if b == nil { b = []byte{} }，别依赖函数容错
http.NewRequest 默认不设置 Host，导致某些代理/网关拒绝请求
http.NewRequest 构造的请求对象，req.Host 字段默认为空，而 RFC 7230 要求 HTTP/1.1 请求必须含 Host header。多数服务端容忍，但 Envoy、Nginx（严格模式）、部分云网关会直接 400。
- 常见错误现象：本地调试通，上生产 400 Bad Request，抓包发现 Host 缺失
- 使用场景：HTTP 客户端直连后端、调用第三方 API、单元测试 mock server
- 修复方式：显式设置
req.Host = "example.com"，或更稳妥地用http.NewRequestWithContext+req.Header.Set("Host", ...) - 注意：
http.DefaultClient.Do(req)不会自动补 Host；http.Get(url)内部会设，但封装自定义 req 时必须手动补
json.Unmarshal 对 int64 等大整数可能静默截断
Go 的 json.Unmarshal 默认把 JSON number 解析成 float64，再转成目标类型。当 JSON 中数字超过 float64 精度（约 2^53），转 int64 时会丢失低位，且不报错。
- 常见错误现象：ID 字段（如 Twitter snowflake）从 JSON 解析后值错误，但程序无 panic、无 error
- 使用场景：对接外部 API、处理带大整数 ID 的 JSON 日志、微服务间数据交换
- 根本原因：
json.Number类型存在但需主动启用；默认路径跳过了精度校验 - 解决办法：
- 方案一：用json.Decoder.UseNumber()+ 手动转int64（捕获strconv.ParseInterror）
- 方案二：定义字段为json.RawMessage，按需解析
- 方案三：用第三方库如go-json或easyjson（它们默认更严格）
最麻烦的不是 panic，而是那些不报错却悄悄改数据的函数 —— 它们不会打断 CI，也不会触发监控，只在某个特定用户、某条特定订单、某个时间点爆发。写标准库调用时，别信“应该没问题”，翻一遍 godoc 的 “Panics” 和 “Errors” 小节，比写十行业务逻辑还重要。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
