Go项目导入非主分支依赖时遭遇版本无效错误

我有一个服务托管在github.com/me/service，并在github.com/me/worker项目中导入该服务。我向服务仓库推送了dev_branch分支，在worker项目中执行go get github.com/me/service@commit_sha（或@dev_branch，两种方式都尝试过）时，出现报错：

go: github.com/me/service@commit_sha (v1.127.1-0.20240329155249-788847162b0f) requires github.com/me/service/gen-go/models@v0.0.0-00010101000000-000000000000: 
github.com/me/service/gen-go/models@v0.0.0-00010101000000-000000000000: invalid version: unknown revision 000000000000

目前服务主分支版本为v1.127.0，服务的go.mod文件中一直存在github.com/me/service/gen-go/models@v0.0.0-00010101000000-000000000000的依赖声明且此前运行正常，请问问题出在哪里？

核心原因 #

v0.0.0-00010101000000-000000000000是Go模块系统生成的无效伪版本占位符，通常出现在以下场景：

1. 本地开发时，模块依赖了同一仓库下的子目录，但未正确处理模块结构，Go自动生成了这个无效占位符；
2. gen-go/models被当作独立模块（有自己的go.mod），但服务的go.mod里引用的版本对应的commit哈希无效（000000000000是不存在的Git提交）。

之前主分支正常的原因是：主分支可能已发布正式版本v1.127.0，或者本地构建时Go能通过本地目录直接加载gen-go/models的代码，无需远程拉取这个无效伪版本。但拉取dev_branch的远程commit时，Go需要解析完整的依赖链，这个无效伪版本无法在远程仓库找到对应commit，因此报错。

具体解决步骤 #

情况1：gen-go/models不是独立模块（无自身go.mod） #

• 直接删除服务仓库go.mod中github.com/me/service/gen-go/models的依赖声明。因为子目录属于同一模块的一部分，不需要单独在go.mod里声明依赖，Go会自动识别同一仓库下的子目录代码。
• 提交修改后的go.mod到dev_branch并推送，然后在worker项目重新执行go get github.com/me/service@dev_branch。

情况2：gen-go/models是独立模块（有自身go.mod） #

• 确保gen-go/models目录的go.mod中模块路径正确（应为github.com/me/service/gen-go/models），且该目录已被提交到服务仓库的dev_branch；
• 在服务的go.mod中，将github.com/me/service/gen-go/models的依赖版本替换为dev_branch中对应子模块的有效commit哈希，或者如果已发布版本则使用正式版本号；
• 提交修改并推送dev_branch，之后在worker项目重新执行go get命令。

临时 workaround（无法立即修改服务仓库时） #

在worker项目的go.mod中添加replace指令，将无效依赖指向服务仓库的正确路径：

replace github.com/me/service/gen-go/models => github.com/me/service@dev_branch gen-go/models

或者指向本地服务目录（仅本地开发用）：

replace github.com/me/service/gen-go/models => ../service/gen-go/models

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