本文详解 go 项目在 docker 构建时出现 “import path does not begin with hostname” 错误的根本原因，并提供可直接使用的多阶段构建方案，确保本地包路径被 go 工具链正确识别与编译。
该错误本质上源于 Go 的导入路径规则：自 Go 1.0 起，go build 和 go get 要求所有非标准库的导入路径（如 git-go-websiteskeleton/app/common）必须包含有效的主机名（例如 github.com/jadekler/git-go-websiteskeleton），以支持模块发现与依赖解析。而原始 Dockerfile 使用已弃用的 golang:onbuild 镜像（该镜像在 Go 1.9+ 后已被移除），其隐式逻辑仅适用于 GOPATH 下具备规范远程路径的项目，无法处理无域名前缀的本地相对导入路径。
✅ 正确做法是显式控制构建流程，并确保源码结构与 Go 导入路径严格匹配。以下是推荐的现代 Dockerfile（兼容 Go 1.16+ 及 Go Modules）：
# 使用多阶段构建，减小最终镜像体积 FROM golang:1.22-alpine AS builder # 设置工作目录并启用 Go Modules（推荐显式启用） WORKDIR /app ENV GOPROXY=https://proxy.golang.org,direct # 复制 go.mod 和 go.sum 先于源码，利用 Docker 缓存加速依赖下载 COPY go.mod go.sum ./ RUN go mod download # 复制全部源码（注意：需确保 import 路径与实际目录结构一致） COPY . . # 构建二进制（假设主程序入口为 ./cmd/server/main.go） RUN CGO_ENABLED=0 go build -a -ldflags '-extldflags "-static"' -o /usr/local/bin/myapp ./cmd/server # 运行时镜像（极简、安全） FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /usr/local/bin/myapp . EXPOSE 8080 CMD ["./myapp"]
? 关键注意事项：
-
导入路径必须可解析：若代码中使用 import "git-go-websiteskeleton/app/common"，则必须确保该路径对应 github.com/jadekler/git-go-websiteskeleton 的克隆路径，或更推荐的方式——在项目根目录初始化 Go Module：
go mod init github.com/jadekler/git-go-websiteskeleton
并将所有内部导入改为 github.com/jadekler/git-go-websiteskeleton/app/common。这是 Go Modules 的强制约定。
避免 onbuild 镜像：golang:onbuild 已废弃多年，其行为不可控且不兼容 Modules；务必使用明确版本的基础镜像（如 golang:1.22）并手动编写构建步骤。
目录结构即路径：Docker 内 /go/src/ 不再是必需路径（Modules 模式下 GOPATH 影响减弱），但 go build 仍依赖当前工作目录下的 go.mod 及导入路径的物理存在性。因此 COPY . . 必须在 go mod download 之后执行，且项目结构需完整。
总结：该错误不是 Docker 问题，而是 Go 构建系统对导入路径合法性的校验。解决核心在于——统一使用 Go Modules、设置合规的 module path、并通过显式 Dockerfile 控制源码布局与构建顺序。遵循上述方案，即可稳定构建含本地子模块的 Go 应用容器。
