在Go语言的日常开发中，崩溃日志总让人头大，尤其是那些反复出现的经典错误。今天就把最常见的几个坑拎出来，挨个聊聊它们的表现、根因，以及怎么治。话不多说，直接从最要命的开始。

1. 空指针解引用
这是Go新手最容易撞上的鬼——日志里一行runtime error: invalid memory address or nil pointer dereference，程序直接挂掉。原因很简单：你试图解引用一个值为nil的指针，比如某个变量声明了但没赋初始值，一访问就炸。解决方法其实就一行：在解引用之前，先加个if ptr != nil的判断，确保指针有效。别嫌麻烦，这习惯能救你无数次。

2. 数组/切片越界
另一个高频崩溃原因：runtime error: index out of range [i] with length n。比如你有个长度为5的切片，却非要去访问索引10，那Go只能无情地让你体验panic。常见于循环变量算错，或者索引逻辑没覆盖边界。解法也很朴素：访问前检查索引是否在 0 <= index < len(slice) 范围内，别嫌啰嗦，安全第一。

3. 文件操作失败
日志里出现open /path/to/file: no such file or directory或permission denied，说明程序在读写文件时遇到了障碍。原因无非是路径敲错了、目录不存在、或者权限不够（比如试图写入系统目录却没提权）。解决方案分三步：先用os.Stat检查文件是否存在；如果目录缺失，用os.MkdirAll一把创建；权限问题就用os.Chmod改成0644之类的。别硬写，先确认文件能打开。

4. 并发安全问题
日志里出现fatal error: concurrent map reads and map writes，意味着你多个goroutine同时读写同一个map了。Go的map天生不是并发安全的，多线程抢着读写就会数据竞争，直接崩给你看。解法有两个：要么用sync.Mutex或sync.RWMutex把读写操作裹起来，要么换成sync.Map——后者在高并发场景下更省心。记住，map不是线程安全的，别指望它自己会加锁。

5. Context未正确使用
看到context deadline exceeded或context canceled，说明你的goroutine超时或被取消了，但没及时退出，导致资源泄漏。常见于没把context.Context传给支持超时的函数，比如HTTP请求或数据库查询，或者压根没设超时时间。最佳实践是：始终把context往下传，并用context.WithTimeout或context.WithDeadline设个合理的截止时间，别让goroutine无限等下去。

6. 日志配置不当
日志相关的坑很隐蔽，但后果很实在：比如日志没写到预期目录（/var/log/app.log不存在）、日志格式混乱（缺时间戳、文件名）、日志文件太大不轮换直接撑爆磁盘。原因通常是路径配置写死了（没用os.PathSeparator兼容不同系统）、没设日志格式（比如没调log.SetFlags）、没用轮换库。解决建议：先用os.MkdirAll确保目录存在且权限正确（比如0755）；然后用log.SetFlags(log.LstdFlags|log.Lshortfile)输出带时间戳和文件名的日志；最后，用第三方库（比如logrus+lfshook）实现自动轮换。别等磁盘满了才后悔。

7. 协程泄漏
日志里持续出现goroutine started but not stopped，或者程序内存蹭蹭上涨，十有八九是goroutine泄漏了。原因通常是创建的goroutine没正确退出——比如忘了调wg.Done()，或者没监听ctx.Done()信号。解决办法：用sync.WaitGroup管理所有goroutine（wg.Add(1)/wg.Done()/wg.Wait()），同时通过context.Context监听取消信号，在goroutine里用select判断ctx.Done()，及时退出。别让goroutine变成野生的。

8. 依赖包问题
编译时报cannot find package "xxx"或import cycle not allowed，说明依赖搞砸了。前者可能是go.mod文件缺失或包没安装，后者是出现了循环依赖（比如包A导包B，包B又导包A）。解决两步走：先跑go mod tidy自动整理依赖，下载缺失的包并移除无用的；如果还有循环依赖，就得重构代码，把公共逻辑抽到新包里。别硬怼，依赖管理讲究的是清晰。

以上就是Go开发中常见的八个日志陷阱，每个都踩过、修过、记过。下次再看到类似的报错，至少能知道问题出在哪，该怎么动手。祝你少踩坑、多写靠谱代码。

《夸克》非常好用的免费AI浏览器

下载APP查看