如何在Golang中测试跨模块代码_Golang多模块测试技巧_技术教程

跨模块测试需用完整模块路径导入并正确配置replace，启动HTTP服务时应轮询检测端口就绪，覆盖率合并须跳过profile头行且路径匹配要精确。

跨模块测试时 import 路径写错导致 “cannot find package”

Go 的模块路径不是文件路径，而是 go.mod 中定义的 module path。如果测试代码在 module-a 里想调用 module-b 的函数，但直接写 import "./../module-b" 或 import "module-b"，就会报错。

正确做法是：确保两个模块都已发布（或通过 replace 指向本地路径），并在 module-a/go.mod 中显式添加依赖：

go mod edit -require=example.com/module-b@v0.1.0
go mod edit -replace=example.com/module-b=../module-b

然后在测试文件中用完整模块路径导入：

import (
    "example.com/module-b/client"
)

别用相对路径 import —— Go 不支持
replace 必须在被测模块的 go.mod 中声明，不是测试模块的
运行 go test 前先执行 go mod tidy，否则依赖可能未解析

测试中启动真实 HTTP 服务并等待端口就绪

跨模块集成测试常需启动一个模块暴露的 HTTP handler（比如 module-api 提供 REST 接口），再由另一个模块（如 module-client）发起请求。但直接 http.ListenAndSe

rve(":8080", ...) 后立刻发请求，大概率失败——服务还没真正 bind 成功。

可靠做法是用 net.Listen 占用端口 + 显式启动 goroutine，再轮询检测可连通性：

func startTestServer() (*httptest.Server, error) {
    l, err := net.Listen("tcp", "127.0.0.1:0")
    if err != nil {
        return nil, err
    }
    srv := &http.Server{Handler: yourHandler}
    go srv.Serve(l)
    // 等待端口可 dial
    for i := 0; i < 50; i++ {
        conn, _ := net.Dial("tcp", l.Addr().String())
        if conn != nil {
            conn.Close()
            return httptest.NewUnstartedServer(yourHandler), nil
        }
        time.Sleep(10 * time.Millisecond)
    }
    return nil, errors.New("server did not start")
}

别用固定端口（如 :8080）—— CI 环境可能被占
用 httptest.NewUnstartedServer + Start() 更轻量，无需真实网络栈
真实端口测试必须加超时和重试，TCP 握手有延迟

gomock 生成的 mock 无法跨模块使用

如果 module-core 定义了接口 UserService，而 module-api 想为它生成 mock 用于测试，直接在 module-api 下运行 mockgen 会失败：找不到 module-core 的源码或类型定义。

根本原因是 mockgen 默认只扫描当前模块路径。解决方式有两种：

把 mock 文件放在 module-core 内（推荐）：在 module-core/mocks/ 下生成，导出为公开包，module-api 直接 import "example.com/module-core/mocks"

若必须本地生成，需指定 -source 为绝对路径或 go list 输出：

mockgen -source=$(go list -f '{{.Dir}}' -m example.com/module-core)/user_service.go -destination=mocks/mock_user.go

确保 go.mod 中 module-core 版本已更新，且 go list 能解析到该模块

测试覆盖率统计遗漏跨模块依赖代码

执行 go test -coverprofile=coverage.out ./... 时，默认只覆盖当前模块下的 .go 文件。即使测试调用了 module-db 的函数，它的代码行也不会出现在覆盖率报告中。

要合并多模块覆盖率，必须手动收集每个模块的 profile 并用 go tool cover 合并：

go test -coverprofile=core.coverprofile ./module-core/...
go test -coverprofile=api.coverprofile ./module-api/...
echo "mode: count" > coverage.out
tail -n +2 core.coverprofile >> coverage.out
tail -n +2 api.coverprofile >> coverage.out
go tool cover -html=coverage.out -o coverage.html