本文介绍如何解决 Go 构建时因 pkg/ 目录中存在不匹配平台的预编译 .a 文件（如 darwin 二进制误存于 linux 环境），导致 go-sql-driver/mysql 导入失败的问题。核心方法是清理缓存并重新构建。
本文介绍如何解决 go 构建时因 `pkg/` 目录中存在不匹配平台的预编译 `.a` 文件（如 darwin 二进制误存于 linux 环境），导致 `go-sql-driver/mysql` 导入失败的问题。核心方法是清理缓存并重新构建。
在 Go 项目中使用 github.com/go-sql-driver/mysql 时，若在 CentOS 6.6（Linux amd64）环境下执行 go build index.go 报出如下错误：
import /usr/local/go/pkg/linux_amd64/github.com/go-sql-driver/mysql.a: object is [darwin amd64 go1.4.2 X:precisestack] expected [linux amd64 go1.4 X:precisestack]
该错误明确指出：Go 工具链尝试加载位于 pkg/linux_amd64/.../mysql.a 的归档文件，但该文件实际是为 macOS（darwin）平台 编译生成的（含 darwin amd64 标识），与当前运行环境（linux amd64）严重不兼容。此类问题通常源于以下任一场景：
- 在 macOS 上执行过 go install 或 go build，随后将整个 $GOROOT 或 $GOPATH/pkg 目录复制/同步到了 Linux 服务器；
- 使用了共享或挂载的 GOPATH，导致多平台构建产物混杂；
- Go 版本升级后未清理旧缓存（尤其 go1.4 → go1.4.2 等小版本差异也可能触发校验失败）。
✅ 推荐解决方案：彻底清理 Go 编译缓存
执行以下命令，删除所有预编译的 .a 归档和中间对象（注意：此操作不会影响源码或依赖下载，仅清除本地构建产物）：
# 清理 GOROOT 下的 pkg（即 Go 安装目录的缓存） rm -rf /usr/local/go/pkg/* # 若使用 GOPATH 模式，也建议清理 GOPATH/pkg（如有多个 GOPATH，请逐个清理） rm -rf $GOPATH/pkg/*
⚠️ 注意事项：
- 不要手动删除 src/ 目录，否则需重新 go get 依赖；
- 清理后首次构建会稍慢（需重新编译所有依赖），属正常现象；
- 推荐始终在目标部署环境（如 CentOS）中执行 go get 和构建，避免跨平台复制 pkg/；
- Go 1.11+ 用户应优先使用 Go Modules（go mod init && go mod tidy），其缓存独立于 GOPATH/pkg，存放于 $GOCACHE（默认 ~/.cache/go-build），可安全执行 go clean -cache -modcache 替代上述操作。
清理完成后，重新构建即可成功：
go build index.go # ✅ 成功输出可执行文件
? 总结：该错误本质是 Go 构建系统的平台一致性保护机制在起作用——它拒绝加载“身份不符”的预编译包。与其逐个排查 .a 文件来源，最高效、最安全的做法是清空 pkg/ 目录并重建。这一原则同样适用于其他驱动（如 pq、sqlite3）或任何因环境迁移引发的 import ... object is [xxx] expected [yyy] 类错误。
