Go单仓库CI环境出现vendoring不一致问题求助

本地运行正常的Go单仓库（monorepo），在CI环境执行测试时抛出如下错误：

go: inconsistent vendoring in /__w/x/apps/foo-agent:
github.com/go-faker/faker/v4@v4.4.1: is explicitly required in go.mod, but not marked as explicit in vendor/modules.txt

已做排查：

• 执行 go mod why github.com/go-faker/faker/v4，输出显示主模块不需要该包
• 检查go.mod和源码树，无任何导入github.com/go-faker/faker/v4的代码
• 执行go get ./...、go mod tidy、go mod vendor后，源码树无变化

当前CI执行的测试命令：

CGO_ENABLED=1 go test -v -race -coverprofile=./coverage.out `go list ./... | grep "foo-agent" | grep -v /test | tr "\n" " "`

1. 对齐CI与本地的Go版本 #

Go的模块和vendoring行为在不同版本间存在差异，确认CI使用的Go版本和本地开发环境完全一致（比如均为1.21.x）。版本同步后重新执行go mod vendor。

2. 清理CI环境的缓存与旧文件 #

CI环境可能残留历史缓存或旧vendor文件导致冲突，在CI脚本中添加清理步骤：

rm -rf vendor/
rm -f go.sum

之后重新生成依赖：

go mod tidy
go mod vendor

3. 检查Monorepo内其他模块的依赖 #

作为单仓库，可能其他子模块（如apps/xxx）导入了github.com/go-faker/faker/v4，间接导致根目录go.mod更新，但vendor目录未同步标记。执行全局搜索确认：

grep -r "github.com/go-faker/faker/v4" ./ --include="*.go"

若发现其他模块使用该依赖，在仓库根目录执行go mod tidy和go mod vendor，确保所有依赖同步到vendor目录。

4. 强制移除无用依赖 #

若确认该依赖完全无用，直接从go.mod中移除：

go mod edit -droprequire=github.com/go-faker/faker/v4
go mod tidy
go mod vendor

检查go.mod确认依赖已删除后，提交变更到仓库。

5. 调整CI脚本的执行路径 #

若CI测试命令是在apps/foo-agent子目录执行，可能未正确读取根目录的go.mod和vendor。调整脚本先在根目录处理依赖，再切换到子目录执行测试：

# 切换到仓库根目录
cd /__w/x
go mod tidy
go mod vendor

# 进入foo-agent目录执行测试
cd apps/foo-agent
CGO_ENABLED=1 go test -v -race -coverprofile=./coverage.out `go list ./... | grep "foo-agent" | grep -v /test | tr "\n" " "`

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