Go项目Docker构建失败：本地包导入错误求助排查

错误信息 #

=> ERROR [backend-builder 5/5] RUN --mount=type=cache,mode=0777,target=/go/pkg/mod \
--mount=type=cache,mode=0777,target=/.cache/go-build \
CGO_ENABLED=0 GOOS=linux go build -o serve ./backend/cmd/main.go: \
#17 0.343 backend/cmd/main.go:10:2: no required module provides package \
github.com/LarsDepuydt/peno-entrepreneurship-3d-oclusion/backend/cmd/serve; \
to add it: \
#17 0.343 go get github.com/LarsDepuydt/peno-entrepreneurship-3d-oclusion/backend/cmd/serve \
------
executor failed running [/bin/sh -c CGO_ENABLED=0 GOOS=linux go build -o serve ./backend/cmd/main.go]: exit code: 1

项目结构 #

peno-entrepreneurship-3d-oclusion/
│
├── backend/
│   ├── cmd/
│   │   ├── main.go
│   │   └── serve/
│   │       └── serve.go
│   ├── go.mod
│   └── go.sum
│
├── Dockerfile
│
└── ... (other frontend files and directories)

main.go导入语句 #

import (
    "database/sql"
    "fmt"
    "log"
    "net/http"
    "os"

    "github.com/LarsDepuydt/peno-entrepreneurship-3d-oclusion/backend/cmd/serve"
)

Dockerfile内容 #

################################
# Build backend
################################

FROM dev AS backend-builder

# Change the WORKDIR in the backend-builder stage
WORKDIR /usr/src/app

# pre-copy/cache go.mod for pre-downloading dependencies and only redownloading them in subsequent builds if they change
COPY ./backend/go.mod ./backend/go.sum ./
RUN --mount=type=cache,mode=0777,target=/go/pkg/mod go mod download
#RUN go get github.com/LarsDepuydt/peno-entrepreneurship-3d-oclusion/backend/cmd/serve

COPY . .

# Use native go packages (CGO_ENABLED)
RUN --mount=type=cache,mode=0777,target=/go/pkg/mod \
    --mount=type=cache,mode=0777,target=/.cache/go-build \
    CGO_ENABLED=0 GOOS=linux go build -o serve ./backend/cmd/main.go

问题根源 #

核心问题是Docker构建时的工作目录与Go模块根目录不匹配：

• Go模块的根目录是backend/（因为go.mod存放在此），但Docker设置的WORKDIR是/usr/src/app
• 执行go build时，Go会以当前WORKDIR为基准解析模块路径，无法识别backend/下的本地包结构，因此报错找不到serve包

解决方案 #

方案1：调整Dockerfile的WORKDIR到模块根目录 #

修改Dockerfile，将工作目录切换到backend/，确保Go能正确识别模块路径：

################################
# Build backend
################################

FROM dev AS backend-builder

# 切换到Go模块根目录（backend）
WORKDIR /usr/src/app/backend

# 复制go.mod和go.sum到当前工作目录
COPY ./backend/go.mod ./backend/go.sum ./
RUN --mount=type=cache,mode=0777,target=/go/pkg/mod go mod download

# 复制整个项目到容器
COPY . .

# 执行构建，输出文件放到上级目录避免混淆
RUN --mount=type=cache,mode=0777,target=/go/pkg/mod \
    --mount=type=cache,mode=0777,target=/.cache/go-build \
    CGO_ENABLED=0 GOOS=linux go build -o ../serve ./cmd/main.go

方案2：构建时指定模块根目录（不修改WORKDIR） #

如果不想调整WORKDIR，可以用go build的-C参数切换到模块根目录执行构建：

# 替换原有的RUN构建命令
RUN --mount=type=cache,mode=0777,target=/go/pkg/mod \
    --mount=type=cache,mode=0777,target=/.cache/go-build \
    CGO_ENABLED=0 GOOS=linux go build -C ./backend -o ../serve ./cmd/main.go

额外说明：关于相对路径导入 #

你之前尝试的"./serve"导入是合法的（main.go在backend/cmd，serve包在backend/cmd/serve），但同样需要在模块根目录（backend/）下执行构建才能正确解析，配合上述两种方案均可生效。

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