执行mockgen生成MongoDB接口Mock时遇包加载失败错误

问题描述 #

执行以下mockgen命令生成MongoDB连接接口的Mock：

mockgen --build_flags=--mod=mod -source pkg/database/db-conn.go -destination pkg/database/mocks/database.go -package database

目标文件定义了DB接口及实现，执行命令后出现一系列Go标准库内部编译错误，核心错误示例：

/usr/local/go/src/internal/abi/unsafestring_go120.go:17:16: Slice not declared by package unsafe
/usr/local/go/src/internal/abi/abi.go:91:24: invalid operation: shift count (i % 8) (value of type int) must be unsigned integer
/usr/local/go/src/runtime/internal/atomic/types.go:518:16: expected ']', found any

最终报错：2023/12/08 01:33:06 Loading input failed: loading package failed

问题根源 #

这类错误本质是mockgen版本与当前使用的Go版本不兼容，mockgen的编译逻辑没有适配你当前Go版本的标准库语法变化（比如Go 1.20+对unsafe包、原子操作类型的语法调整）。

解决方案 #

1. 升级mockgen到最新版本 #

用Go模块方式重新安装最新版mockgen：

go install github.com/golang/mock/mockgen@latest

安装完成后，确认版本：

mockgen -version

2. 更换mockgen调用方式（避免--source参数） #

改用包路径的方式生成Mock，替换成你的项目实际模块路径：

mockgen --build_flags=--mod=mod [你的项目模块名]/pkg/database DB -destination pkg/database/mocks/database.go -package database

比如你的项目模块是github.com/xxx/yyy，则命令为：

mockgen --build_flags=--mod=mod github.com/xxx/yyy/pkg/database DB -destination pkg/database/mocks/database.go -package database

3. 校验Go环境与依赖 #

• 确认GOROOT环境变量指向正确的Go版本，避免混用多个Go版本：

  go version
  echo $GOROOT
  

• 执行go mod tidy清理并同步项目依赖，确保所有依赖适配当前Go版本。

内容的提问来源于stack exchange，提问作者Ashish Mittal