Go Alpine镜像集成wkhtmltopdf编译报错求助

问题根源 #

你遇到的编译错误是因为github.com/adrg/go-wkhtmltopdf基于CGO开发，编译时需要wkhtmltopdf的头文件和开发库文件，但你的Dockerfile仅复制了二进制执行文件和运行库，没有复制编译必需的头文件，导致编译器找不到wkhtmltox/pdf.h。

解决方案 #

修改Dockerfile，在builder阶段复制wkhtmltopdf的头文件、开发库，并配置CGO环境变量；同时在最终镜像中确保运行时依赖的库齐全。

修改后的完整Dockerfile #

FROM surnet/alpine-wkhtmltopdf:3.16.2-0.12.6-full as wkhtmltopdf
FROM golang:1.19-alpine3.17 as builder

# 安装编译依赖
RUN apk update && \
    apk add --no-cache libc-dev gcc make tzdata && \
    mkdir /src

# 复制wkhtmltopdf的头文件、开发库和二进制文件到系统标准路径
COPY --from=wkhtmltopdf /usr/include/wkhtmltox /usr/include/wkhtmltox
COPY --from=wkhtmltopdf /usr/lib/libwkhtmltox* /usr/lib/
COPY --from=wkhtmltopdf /bin/wkhtmltopdf /bin/wkhtmltopdf
COPY --from=wkhtmltopdf /bin/wkhtmltoimage /bin/wkhtmltoimage

# 配置CGO环境变量，指定头文件目录和库链接参数
ENV CGO_CFLAGS="-I/usr/include/wkhtmltox"
ENV CGO_LDFLAGS="-L/usr/lib -lwkhtmltox"

WORKDIR /src
COPY ./../ ./

RUN go mod vendor && go mod verify
RUN go build -o /app-bin /src/app/api/main.go

# 构建最终运行镜像
FROM alpine:3.17
# 安装wkhtmltopdf运行必需的系统依赖库
RUN apk --update add --no-cache tzdata libstdc++ libx11 libxrender libxext libssl1.1 ca-certificates

WORKDIR /srv
COPY --from=builder /app-bin .
# 复制运行时需要的wkhtmltopdf库和二进制文件
COPY --from=wkhtmltopdf /usr/lib/libwkhtmltox* /usr/lib/
COPY --from=wkhtmltopdf /bin/wkhtmltopdf /bin/wkhtmltopdf
COPY --from=wkhtmltopdf /bin/wkhtmltoimage /bin/wkhtmltoimage

EXPOSE 8080
CMD ["/srv/app-bin"]

关键改动说明 #

• 复制头文件：从wkhtmltopdf镜像的/usr/include/wkhtmltox目录复制头文件到builder阶段的系统头文件路径，解决编译时找不到pdf.h的问题。
• 复制开发库：/usr/lib/libwkhtmltox*包含编译时需要的静态/动态库，确保CGO能正确链接。
• CGO环境变量：显式指定头文件目录和库链接参数，避免编译器路径查找问题。
• 运行时依赖：最终镜像安装wkhtmltopdf运行必需的系统库（如libstdc++、X11相关库），防止运行时出现库缺失错误。

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