本文详解解决 go docker 构建时出现 “import path does not begin with hostname” 错误的方法，核心在于正确配置 gopath、源码路径与依赖导入路径，避免使用已弃用的 `onbuild` 镜像，并通过显式 `add` + `go install` 流程实现可靠构建。
Go 语言要求所有 import 路径必须符合“以域名开头”的规范（如 github.com/user/repo），这是 go build 和 go get 进行模块解析与依赖管理的基础。而错误中出现的 git-go-websiteskeleton/app/common 这类无主机名的路径，会被 Go 工具链直接拒绝——它既不是标准库，也不属于合法的远程导入路径，因此报错 import path does not begin with hostname。
根本原因在于：你使用的 golang:onbuild 镜像是早期（Go 1.5–1.6 时代）为简化构建设计的自动化镜像，它仅对标准结构（如 src/ 下按域名组织的包）生效，且不支持本地相对路径导入或自定义模块根路径。更关键的是，该镜像已在 Go 1.7+ 中被官方弃用并最终移除，不再维护，也不兼容现代 Go 工作区（尤其是 Go Modules）。
✅ 正确做法是手动编写清晰、可维护的 Dockerfile，显式控制源码位置、依赖安装和编译流程。假设你的项目目录结构如下（与 git-go-websiteskeleton 一致）：
./ ├── main.go ├── app/ │ ├── common/ │ ├── home/ │ └── user/
且 main.go 中 imports 类似：
import (
"git-go-websiteskeleton/app/common"
"git-go-websiteskeleton/app/home"
)你需要确保该导入路径在容器内能被 Go 工具链识别为有效路径。推荐方案（兼容 GOPATH 模式）如下：
# 使用明确版本的 golang 基础镜像（避免 onbuild）
FROM golang:1.19-alpine
# 设置工作目录（推荐使用 /app 便于区分 GOPATH）
WORKDIR /app
# 将当前目录全部复制进容器（注意：.dockerignore 可优化体积）
COPY . .
# 方案一：若项目仍使用 GOPATH 模式（无 go.mod），需将代码放入 GOPATH/src 对应路径
# 例如：导入路径为 "git-go-websiteskeleton/app/common"，则应置于 /go/src/git-go-websiteskeleton/app/common
RUN mkdir -p /go/src/git-go-websiteskeleton && \
cp -r . /go/src/git-go-websiteskeleton/
# 切换到 GOPATH 下的源码路径并构建
WORKDIR /go/src/git-go-websiteskeleton
RUN go install -v ./...
# 设置运行时入口
ENTRYPOINT ["/go/bin/git-go-websiteskeleton"]
EXPOSE 8080⚠️ 注意事项：
不要依赖 go get 安装本地路径：go get git-go-websiteskeleton/... 在无远程仓库上下文时会失败；它只适用于可解析的 URL（如 github.com/...）。
-
优先迁移到 Go Modules：现代最佳实践是为项目初始化 go mod init git-go-websiteskeleton，并在 main.go 同级生成 go.mod。此时 Dockerfile 可大幅简化：
FROM golang:1.19-alpine WORKDIR /app COPY go.mod go.sum ./ RUN go mod download # 预下载依赖，提升缓存效率 COPY . . RUN go build -o server . CMD ["./server"] EXPOSE 8080
务必使用 .dockerignore：排除 node_modules、vendor（若非必需）、.git 等，避免无效文件污染构建上下文和缓存。
-
多阶段构建更优：生产镜像建议分离构建与运行阶段，减小最终镜像体积：
# 构建阶段 FROM golang:1.19-alpine AS builder WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN go build -o server . # 运行阶段 FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /app/server . EXPOSE 8080 CMD ["./server"]
总结：该错误本质是 Go 导入路径语义与 Docker 构建上下文不匹配所致。摒弃过时的 onbuild，采用显式路径管理 + Go Modules（推荐）或规范 GOPATH 结构，即可彻底解决。构建稳定、可复现、易调试的 Go 容器化应用，始于一份语义清晰的 Dockerfile。
