Go中go.mod递归replace用法及子模块依赖报错排查

项目结构 #

我需要搭建如下多子模块项目结构，用于开发Telegram的MTProto库（通过TL schema自动生成Go代码）：

src/github.com/myname/myproject/
- tl:
    - constructor
        - something.go
        - go.mod:
            module github.com/myname/myproject/tl/constructor

            require github.com/myname/myproject v0.0.0
            require github.com/myname/myproject/tl/types v0.0.0
            require github.com/myname/myproject/tl/types/account v0.0.0
            require github.com/myname/myproject/tl/types/auth v0.0.0
            require github.com/myname/myproject/tl/types/bots v0.0.0

            replace github.com/myname/myproject v0.0.0 => ./../..
            replace github.com/myname/myproject/tl/types v0.0.0 => ./../types
            replace github.com/myname/myproject/tl/types/account v0.0.0 => ./../types/account
            replace github.com/myname/myproject/tl/types/auth v0.0.0 => ./../types/auth
            replace github.com/myname/myproject/tl/types/channels v0.0.0 => ./../types/channels
    - crcs
        - something.go
        - go.mod:
            module github.com/myname/myproject/tl/crcs

    - functions
        - account
            - something.go
            - go.mod:
                module github.com/myname/myproject/tl/functions/account

                require github.com/myname/myproject/tl/crcs v0.0.0
                require github.com/myname/myproject v0.0.0
                require github.com/myname/myproject/tl/types v0.0.0

                replace github.com/myname/myproject/tl/crcs v0.0.0 => ./../../crcs
                replace github.com/myname/myproject v0.0.0 => ./../../..
                replace github.com/myname/myproject/tl/types v0.0.0 => ./../../types
        - auth
            - something.go
            - go.mod:
                module github.com/myname/myproject/tl/functions/auth

                require github.com/myname/myproject/tl/crcs v0.0.0
                require github.com/myname/myproject v0.0.0
                require github.com/myname/myproject/tl/types v0.0.0

                replace github.com/myname/myproject/tl/crcs v0.0.0 => ./../../crcs
                replace github.com/myname/myproject v0.0.0 => ./../../..
                replace github.com/myname/myproject/tl/types v0.0.0 => ./../../types
        - bots
            - something.go
            - go.mod:
                module github.com/myname/myproject/tl/functions/bots

                require github.com/myname/myproject/tl/crcs v0.0.0
                require github.com/myname/myproject v0.0.0
                require github.com/myname/myproject/tl/types v0.0.0

                replace github.com/myname/myproject/tl/crcs v0.0.0 => ./../../crcs
                replace github.com/myname/myproject v0.0.0 => ./../../..
                replace github.com/myname/myproject/tl/types v0.0.0 => ./../../types
        - something.go
        - go.mod:
            module github.com/myname/myproject/tl/functions

            require github.com/myname/myproject/tl/crcs v0.0.0
            require github.com/myname/myproject v0.0.0
            require github.com/myname/myproject/tl/types v0.0.0

            replace github.com/myname/myproject/tl/crcs v0.0.0 => ./../crcs
            replace github.com/myname/myproject v0.0.0 => ./../..
            replace github.com/myname/myproject/tl/types v0.0.0 => ./../types
    - types
        - account
            - something.go
            - go.mod:
                module github.com/myname/myproject/tl/types/account

                require github.com/myname/myproject/tl/crcs v0.0.0
                require github.com/myname/myproject v0.0.0
                require github.com/myname/myproject/tl/types v0.0.0

                replace github.com/myname/myproject/tl/crcs v0.0.0 => ./../../crcs
                replace github.com/myname/myproject v0.0.0 => ./../../..
                replace github.com/myname/myproject/tl/types v0.0.0 => ./..

        - auth
            - something.go
            - go.mod:
                module github.com/myname/myproject/tl/types/auth

                require github.com/myname/myproject/tl/crcs v0.0.0
                require github.com/myname/myproject v0.0.0
                require github.com/myname/myproject/tl/types v0.0.0

                replace github.com/myname/myproject/tl/crcs v0.0.0 => ./../../crcs
                replace github.com/myname/myproject v0.0.0 => ./../../..
                replace github.com/myname/myproject/tl/types v0.0.0 => ./..
        - channels
            - something.go
            - go.mod:
                module github.com/myname/myproject/tl/types/channels

                require github.com/myname/myproject/tl/crcs v0.0.0
                require github.com/myname/myproject v0.0.0
                require github.com/myname/myproject/tl/types v0.0.0

                replace github.com/myname/myproject/tl/crcs v0.0.0 => ./../../crcs
                replace github.com/myname/myproject v0.0.0 => ./../../..
                replace github.com/myname/myproject/tl/types v0.0.0 => ./..
        - something.go
        - go.mod:
            module github.com/myname/myproject/tl/types

            require github.com/myname/myproject/tl/crcs v0.0.0
            require github.com/myname/myproject v0.0.0

            replace github.com/myname/myproject/tl/crcs v0.0.0 => ./../crcs
            replace github.com/myname/myproject v0.0.0 => ./../..
- something.go
- go.mod:
    module github.com/myname/myproject

    [some external dependencies]
    require github.com/myname/myproject/tl/types v0.0.0
    replace github.com/myname/myproject/l/types v0.0.0 => ./tl/types

报错信息 #

使用JetBrains IDE执行go list扫描所有子模块时，出现以下错误：

go: github.com/myname/myproject/tl/types@v0.0.0 requires
    github.com/myname/myproject/tl/crcs@v0.0.0: reading github.com/myname/myproject/tl/crcs/go.mod at revision tl/crcs/v0.0.0: unknown revision tl/crcs/v0.0.0

明明已配置本地replace，但Go仍尝试从远程仓库拉取模块。我不能修改项目结构，因为需要使用account.SomeType这类命名空间式引用，单模块结构会过于繁琐。

问题原因 #

1. 根模块go.mod笔误：根模块中的replace指令写错了路径，把tl/types写成了l/types，导致根模块无法正确映射tl/types到本地路径。
2. Replace指令的作用范围限制：Go的replace指令仅在当前模块的依赖解析中生效，不会被上级模块或依赖它的模块继承。当IDE从根模块出发扫描所有子模块时，根模块解析tl/types的依赖（比如tl/crcs）时，不会使用tl/types自身go.mod中的replace规则，而是尝试从远程仓库拉取不存在的tl/crcs@v0.0.0版本。
3. 子模块版本未标记：所有子模块使用v0.0.0版本，且未在远程仓库打对应tag，Go默认会尝试查找该版本的仓库提交记录，导致解析失败。

解决方案 #

1. 修复根模块go.mod的笔误 #

将根模块go.mod中的错误replace指令：

replace github.com/myname/myproject/l/types v0.0.0 => ./tl/types

修改为：

replace github.com/myname/myproject/tl/types v0.0.0 => ./tl/types

2. 在根模块go.mod中添加所有子模块的replace规则 #

在根模块的go.mod中，为所有子模块添加本地路径映射，这样IDE从根模块扫描时，会直接使用本地路径解析所有子模块依赖，无需访问远程仓库：

// 根模块go.mod中新增以下replace规则
replace github.com/myname/myproject/tl/crcs v0.0.0 => ./tl/crcs
replace github.com/myname/myproject/tl/types v0.0.0 => ./tl/types
replace github.com/myname/myproject/tl/types/account v0.0.0 => ./tl/types/account
replace github.com/myname/myproject/tl/types/auth v0.0.0 => ./tl/types/auth
replace github.com/myname/myproject/tl/types/channels v0.0.0 => ./tl/types/channels
replace github.com/myname/myproject/tl/functions v0.0.0 => ./tl/functions
replace github.com/myname/myproject/tl/functions/account v0.0.0 => ./tl/functions/account
replace github.com/myname/myproject/tl/functions/auth v0.0.0 => ./tl/functions/auth
replace github.com/myname/myproject/tl/functions/bots v0.0.0 => ./tl/functions/bots
replace github.com/myname/myproject/tl/constructor v0.0.0 => ./tl/constructor

3. 验证子模块的replace路径正确性 #

确保所有子模块go.mod中的replace相对路径正确，比如tl/types/account中的./../../crcs确实指向tl/crcs目录，避免因路径错误导致的映射失效。

4. （可选）使用go work管理多模块项目 #

如果Go版本≥1.18，可以使用Go工作区来管理多模块项目，避免手动维护大量replace规则：

1. 在项目根目录执行go work init
2. 添加所有子模块到工作区：

go work use ./tl/constructor ./tl/crcs ./tl/functions ./tl/functions/account ./tl/functions/auth ./tl/functions/bots ./tl/types ./tl/types/account ./tl/types/auth ./tl/types/channels

工作区会自动处理本地模块的依赖解析，无需在每个模块中添加replace规则。

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