部署Go/Gin应用至Koyeb时遭遇bash: bin/v2: No such file or directory错误

核心错误信息 #

部署日志报错：

Instance is starting
Instance is unhealthy
bash: bin/v2: No such file or directory
Instance is unhealthy
bash: bin/v2: No such file or directory
Instance is unhealthy
Instance terminated in nomad

这个错误和你的模块名称...2023.com/v2并非巧合，Go语义化v2+模块的规则会影响编译输出与部署配置，以下是具体排查方向：

排查步骤 #

• 检查Koyeb启动命令：登录Koyeb控制台查看服务配置的「启动命令」字段，确认是否错误指定了./bin/v2作为执行文件。如果是，替换为本地编译生成的实际二进制文件名（比如guitarkeegan-2023）。
• 核对编译配置：检查项目的Makefile、Dockerfile或构建脚本，确认是否存在go build -o bin/v2 ./...这类错误编译指令，将输出路径改为明确的文件名，比如go build -o bin/app ./cmd/main.go。
• 规范模块声明：确保go.mod中module行正确为module your-domain.com/v2，且代码内部的导入路径都带上/v2后缀（比如import "your-domain.com/v2/pkg/xxx"），避免构建环境因模块版本解析逻辑误解输出路径。
• 显式指定编译输出：在Koyeb的构建命令中直接指定二进制文件路径，比如：

go build -o bin/portfolio ./cmd/main.go

同时将启动命令改为./bin/portfolio，彻底避开模块版本号带来的路径歧义。

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