Golang mockgen生成的MockClient未实现Client接口问题

核心原因 #

报错中have和want的方法归属包不一致，结合Go的语言规则，问题出在两点：

• 包路径不匹配：生成的MockClient属于mock_myservice包，而原Client接口在myservice包，Go会将不同包下的同名方法视为不同方法，即使签名完全一致。
• 私有方法限制：原接口中的getBytes是小写开头（Go私有方法），只有同包内的类型才能实现该接口方法，跨包的MockClient无法实现私有方法。

修复方案 #

方案一：修改接口方法为公开访问（推荐） #

将原接口中的私有方法改为大写开头（Go公开方法），这样跨包的Mock类可以正常实现接口：

// 修正后的Client接口
type Client interface {
    GetBytes(ctx context.Context, token, url string) ([]byte, error) // 改为大写GetBytes
    SendRequest(ctx context.Context, token, id string) (Response, error)
}

修改后重新执行mockgen生成Mock类即可。

方案二：让Mock类与原接口同包生成 #

若必须保留私有方法，执行mockgen时指定输出包为原接口所在包：

mockgen -source=./myservice/client.go -destination=./myservice/mock_client.go -package=myservice

生成的MockClient与原Client同属myservice包，就能实现私有方法getBytes。

方案三：检查mockgen命令参数 #

确保生成命令的-package参数与原接口的包名完全一致，避免指定为mock_myservice这类不同包名，导致方法归属不匹配。

注意：Go的接口实现依赖方法的完整签名+包归属，即使方法名、参数、返回值完全相同，不同包下的方法会被Go判定为不同方法，这是触发该报错的底层逻辑。

内容的提问来源于stack exchange，提问作者Mingzhu Liu