Go Buildpack无法找到本地模块，Fly.io部署Go应用失败求助

问题核心 #

在Fly.io上使用Paketo Buildpack构建Go多模块项目时，构建阶段执行go mod vendor后，仍然提示无法找到pkg/test和pkg/templates本地包，本地构建和远程构建均失败。

问题分析 #

1. 多模块项目的依赖引用路径错误，导致go mod vendor生成的vendor目录结构与构建时的包查找路径不匹配
2. Fly.io默认构建工作目录为项目根目录，但实际要构建的应用在cmd/web子目录，多模块结构下根目录的配置干扰了子模块的依赖解析
3. 本地模块的命名和replace指令配置存在偏差，导致构建时无法正确映射到本地包

解决步骤 #

1. 修正子模块的依赖引用配置 #

（1）统一模块命名

给各个子模块设置规范的模块名，例如：

• 根目录go.mod模块名：your-project.com/root
• pkg/test/go.mod模块名：your-project.com/root/pkg/test
• pkg/templates/go.mod模块名：your-project.com/root/pkg/templates
• cmd/web/go.mod模块名：your-project.com/root/cmd/web

（2）在cmd/web的go.mod中添加依赖与replace指令

打开cmd/web/go.mod，添加对本地pkg模块的依赖和路径映射：

require (
    your-project.com/root/pkg/test v0.0.0
    your-project.com/root/pkg/templates v0.0.0
)

replace (
    your-project.com/root/pkg/test => ../../pkg/test
    your-project.com/root/pkg/templates => ../../pkg/templates
)

（3）更新依赖并生成vendor

进入cmd/web目录执行：

go mod tidy
go mod vendor

检查cmd/web/vendor目录下是否存在your-project.com/root/pkg/test和your-project.com/root/pkg/templates目录，确认本地包已被正确纳入vendor。

2. 指定Fly.io构建的工作目录 #

修改cmd/web/fly.toml，指定构建时进入cmd/web目录，避免根目录多模块干扰：

[build]
  builder = "paketobuildpacks/builder:base"
  buildpacks = ["paketo-buildpacks/go"]
  working_dir = "cmd/web"

3. 验证本地构建可用性 #

在cmd/web目录执行本地构建命令，确认依赖无问题：

go build -o web-app

如果本地构建成功，说明依赖配置已正确，再推送代码到Fly.io执行远程构建。

4. 排除go.work的干扰（可选） #

如果项目根目录存在go.work文件，Paketo构建时可能会优先使用工作区配置，导致子模块依赖解析混乱。可以暂时移除根目录的go.work，或确保工作区配置正确包含所有子模块。

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