本文详解解决 go 项目 docker 构建时出现 “import path does not begin with hostname” 错误的根本原因与标准实践，涵盖 gopath 结构规范、dockerfile 正确写法及现代多阶段构建推荐方案。
该错误本质上源于 Go 的导入路径（import path）语义规则：Go 要求所有合法的 import 路径必须以域名（如 github.com、git-go-websiteskeleton）或至少包含点号的主机名形式开头，以确保模块可寻址和可复现。而像 git-go-websiteskeleton/app/common 这样的路径虽在本地文件系统中存在，但因缺少有效主机名前缀（如未配置 GO111MODULE=off 下的 GOPATH 约束），Go 编译器无法将其识别为合法包路径，从而报错。
根本原因在于你使用了已废弃的 golang:onbuild 镜像。该镜像依赖 ONBUILD 指令自动执行 go get 和 go install，但它不会自动将当前源码挂载到正确的 GOPATH 目录下，也无法解析无域名前缀的本地导入路径。尤其对于 git-go-websiteskeleton 这类未托管于标准代码托管平台（如 github）的本地仓库结构，必须显式建立符合 Go 工作区规范的目录布局。
✅ 正确做法是手动构建符合 Go 约定的 Docker 环境。以下是推荐的 Dockerfile（兼容 Go 1.11+ 模块模式与传统 GOPATH 模式）：
# 使用明确版本的基础镜像（避免 onbuild 废弃风险） FROM golang:1.21-alpine # 设置工作目录并创建标准 GOPATH 结构 WORKDIR /app COPY . . # 方案一：启用 Go Modules（推荐，无需 GOPATH） ENV GO111MODULE=on ENV CGO_ENABLED=0 # 复制 go.mod/go.sum 并预下载依赖（利用 Docker layer 缓存） COPY go.mod go.sum ./ RUN go mod download # 复制源码并构建二进制（静态链接，便于 Alpine 运行） COPY . . RUN go build -a -ldflags '-extldflags "-static"' -o /usr/local/bin/myapp . # 使用轻量运行时镜像（最佳实践） FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=0 /usr/local/bin/myapp . EXPOSE 8080 CMD ["./myapp"]⚠️ 关键注意事项：
- 勿再使用 golang:onbuild：该镜像自 Go 1.9 起已被标记为 deprecated，Docker 官方文档已移除相关说明；
- 导入路径需可寻址：若坚持使用 GOPATH 模式（不推荐），必须将代码置于 /go/src/
/ 下（如 /go/src/git-go-websiteskeleton/），并通过 go install git-go-websiteskeleton 构建； - 优先启用 Go Modules：在项目根目录运行 go mod init git-go-websiteskeleton 初始化模块，将所有 import “git-go-websiteskeleton/…” 转为模块感知路径，并通过 go mod tidy 自动修正依赖；
- 多阶段构建是标配：第一阶段编译，第二阶段仅含运行时依赖，显著减小镜像体积（通常从 800MB+ 降至 ~15MB）。
总结：该错误不是 Docker 问题，而是 Go 构建模型与容器化工作流不匹配所致。通过显式管理模块、遵循标准目录结构、采用多阶段构建，即可彻底规避路径解析失败，实现可复现、轻量、生产就绪的 Go 应用容器化部署。