Docker Compose启动rest_api报错：app可执行文件未在$PATH中找到

这个exec: "app": executable file not found in $PATH报错不是字面意义上的PATH路径找不到文件，90%以上的同类问题都是Go多阶段构建搭配alpine镜像时的CGO配置问题：
golang:alpine构建镜像默认开启CGO，编译出的二进制是动态链接版本，依赖系统C库。你用的第二阶段运行镜像是纯净版alpine，即使和构建阶段的alpine版本一致，只要编译时没装全C编译依赖，生成的二进制就会因为缺少动态链接依赖无法被系统识别为可执行程序，最终抛出找不到可执行文件的错误。
剩下小部分情况是docker-compose复用了旧的构建缓存，旧镜像层里根本没把编译好的app二进制复制进运行镜像，启动时自然找不到文件。

1. 修正Dockerfile编译配置（优先推荐静态编译方案） #

显式关闭CGO编译纯静态可执行文件，不依赖任何系统动态库，复制到任意alpine环境都可以直接运行，同时用绝对路径执行二进制彻底规避PATH问题，修正后的Dockerfile如下：

FROM golang:1.18.3-alpine3.16 AS builder

WORKDIR /usr/src/app

# 预复制依赖清单缓存依赖层，只有依赖变更时才重新下载
COPY go.mod go.sum ./
RUN go mod download && go mod verify

COPY . .
# 显式关闭CGO，编译静态二进制文件
RUN CGO_ENABLED=0 go build -v -o /usr/local/bin/app .

FROM alpine:3.16

WORKDIR /app
# 复制编译好的二进制到独立工作目录
COPY --from=builder /usr/local/bin/app /app/app
# 用绝对路径启动，完全规避PATH环境变量影响
CMD ["/app/app"]

2. 强制清理旧缓存后重新构建启动 #

修改完Dockerfile后不要直接启动，先清理旧的构建缓存和残留容器，避免复用无效的旧镜像层：

# 停止并删除关联的容器、匿名卷
docker-compose down -v
# 强制不使用缓存重新构建镜像并启动
docker-compose up --build --no-cache

如果业务必须开启CGO（比如依赖了SQLite这类需要C绑定的第三方库），需要同时在构建阶段安装编译依赖、运行阶段安装C库运行依赖，对应Dockerfile参考：

FROM golang:1.18.3-alpine3.16 AS builder
# 安装CGO编译依赖
RUN apk add --no-cache gcc musl-dev
WORKDIR /usr/src/app
COPY go.mod go.sum ./
RUN go mod download && go mod verify
COPY . .
RUN CGO_ENABLED=1 go build -v -o /usr/local/bin/app .

FROM alpine:3.16
# 安装CGO运行时依赖
RUN apk add --no-cache musl
WORKDIR /app
COPY --from=builder /usr/local/bin/app /app/app
CMD ["/app/app"]

构建完成后可以先单独执行命令验证镜像内文件状态，不用等compose启动才发现问题：

# 构建镜像
docker build -t test-api .
# 启动临时容器查看二进制文件是否存在、权限是否正常
docker run --rm test-api ls -l /app/app

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