使用Golang官方API构建Docker镜像时COPY指令执行失败

这个问题我之前帮别人排查过，核心原因其实是Docker API构建时的上下文路径和直接用docker build的默认行为不一样，咱们一步步拆解：

为什么直接docker build能成功，API构建不行？ #

当你在终端执行docker build .时，.代表的是构建上下文（Build Context）——Docker会把这个目录下的所有文件打包发送给Docker daemon，COPY指令就是从这个打包的上下文里读取文件的。而你用Golang API构建时，很可能没有正确把包含packages文件夹的目录设置为构建上下文，导致daemon找不到这个文件夹。

另外你提到的WORKDIR，它是设置容器内部的工作目录，和本地构建上下文完全没关系，所以加了它也解决不了本地文件找不到的问题。

解决方法 #

1. 正确设置构建上下文（关键！） #

在使用Golang的Docker API时，必须把包含Dockerfile和packages的整个目录打包作为构建上下文传入ImageBuild方法。示例代码如下：

package main

import (
    "context"
    "github.com/docker/docker/api/types"
    "github.com/docker/docker/api/types/archive"
    "github.com/docker/docker/client"
)

func main() {
    ctx := context.Background()
    cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
    if err != nil {
        panic(err)
    }
    defer cli.Close()

    // 将Dockerfile所在的当前目录（包含packages）打包为tar流
    tarStream, err := archive.TarWithOptions(".", &archive.TarOptions{})
    if err != nil {
        panic(err)
    }
    defer tarStream.Close()

    // 执行镜像构建
    buildResponse, err := cli.ImageBuild(ctx, tarStream, types.ImageBuildOptions{
        Dockerfile: "Dockerfile", // 如果Dockerfile在上下文根目录，这里指定文件名即可
        Tags:       []string{"my-golang-app:latest"},
    })
    if err != nil {
        panic(err)
    }
    defer buildResponse.Body.Close()

    // 这里可以处理构建响应的输出...
}

这段代码的核心是用archive.TarWithOptions把当前目录打包，确保packages文件夹被包含在上下文里，这样Docker daemon就能找到它了。

2. 验证上下文内容 #

如果还是有问题，可以先手动执行tar -cvf context.tar .把当前目录打包，然后解压看看里面有没有packages文件夹，确认上下文确实包含了需要的文件。

3. 检查Dockerfile的COPY路径 #

确保COPY packages /tmp/packages里的packages是相对于构建上下文的路径——如果你的Dockerfile在子目录里，那上下文路径要调整，但根据你的描述，Dockerfile和packages在同一目录，所以这个路径是没问题的。

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