使用Fork的Go仓库遇未知版本修订及模块路径错误

问题场景 #

我Fork了github.com/crewjam/saml到自己的仓库github.com/chrisrollins65/saml，给仓库打了v1.0.0标签后，在项目go.mod里加了replace指令：

replace github.com/crewjam/saml => github.com/chrisrollins65/saml v1.0.0

执行go tidy时遇到两个问题：

• 提示未知版本修订v1.0.0的404错误（明明已经打了对应标签）
• 后续模块能被找到，但又报错模块声明路径为github.com/crewjam/saml，但被要求为github.com/chrisrollins65/saml
  即使已经用了replace指令，问题依然存在，最后通过修正Fork仓库的模块声明解决了问题。

解决步骤 #

1. 修改Fork仓库的模块路径
   打开你Fork后的仓库根目录下的go.mod文件，把第一行的module github.com/crewjam/saml修改为：

   module github.com/chrisrollins65/saml
   

   提交并推送这个修改到你的GitHub仓库。如果之前的v1.0.0标签是基于未修改的提交，建议删除旧标签（本地+远程），重新打一个新标签比如v1.0.1，确保标签对应的提交包含修改后的模块路径。

2. 更新项目的replace指令
   在你的项目go.mod里，把replace指令更新为新的版本标签：

   replace github.com/crewjam/saml => github.com/chrisrollins65/saml v1.0.1
   

3. 清理缓存并重新执行go tidy
   先清理本地模块缓存，避免旧数据干扰：

   go clean -modcache
   

   然后执行go tidy，此时就能正常拉取你的Fork仓库模块了。

原因说明 #

• Go模块系统会校验拉取到的模块的声明路径是否与你指定的路径一致，即使使用了replace指令，这个校验逻辑依然生效。Fork仓库默认保留原作者的模块路径，导致校验失败，出现路径不匹配的错误。
• 之前的404错误大概率是因为标签对应的提交里模块路径未修改，或者本地缓存了旧的模块数据，清理缓存+修正模块路径后就能彻底解决问题。

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