Meteor应用部署Docker容器失败：node-pre-gyp依赖（fabric js）问题

我有一个仅含带canvas单页面的简单Meteor项目，该canvas使用fabric js，通过命令meteor npm install --save fabric安装。项目在Windows本地运行正常（fabric js可正常工作，能在canvas上绘图），但部署到Ubuntu+Docker环境时，在node-pre-gyp安装阶段失败，报错信息如下：

node-pre-gyp install --fallback-to-build --update-binary

(node:98) Warning: Setting the NODE_TLS_REJECT_UNAUTHORIZED environment variable to '0' makes TLS connections and HTTPS requests insecure by disabling certificate verification.
(Use `node --trace-warnings ...` to show where the warning was created)
/bin/sh: pkg-config: not found
gyp: Call to 'pkg-config pixman-1 --libs' returned exit status 127 while in binding.gyp. while trying to load binding.gyp
gyp ERR! configure error
gyp ERR! stack Error: `gyp` failed with exit code: 1
gyp ERR! stack     at ChildProcess.onCpExit (/usr/local/lib/node_modules/npm/node_modules/node-gyp/lib/configure.js:351:16)
gyp ERR! stack     at ChildProcess.emit (events.js:400:28)
gyp ERR! stack     at Process.ChildProcess._handle.onexit (internal/child_process.js:285:12)
gyp ERR! System Linux 5.4.0-137-generic
gyp ERR! command "\"/usr/local/bin/node\" \"/usr/local/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js\" \"configure\" \"--fallback-to-build\" \"--update-binary\" \"--module=/opt/bundle/bundle/programs/server/npm/node_modules/canvas/build/Release/canvas.node\" \"--module_name=canvas\" \"--module_path=/opt/bundle/bundle/programs/server/npm/node_modules/canvas/build/Release\" \"--napi_version=8\" \"--node_abi_napi=napi\" \"--napi_build_version=0\" \"--node_napi_label=node-v83\""
gyp ERR! cwd /opt/bundle/bundle/programs/server/npm/node_modules/canvas
gyp ERR! node -v v14.19.3
gyp ERR! node-gyp -v v5.1.0
gyp ERR! not ok here

使用的Docker环境版本：

• Meteor版本 = 2.10.0
• Docker容器 = geoffreybooth/meteor-base:2.10.0
• Node版本 = node:14.19.3-alpine

移除fabric js包后即可正常部署，请问该如何解决这个问题？

核心问题是Docker容器中缺少fabric依赖的canvas模块编译所需的系统依赖包，以下是具体解决步骤：

1. 安装系统编译依赖 #

根据你使用的镜像基础系统类型，在Dockerfile中添加依赖安装命令：

• 如果是Alpine镜像（对应你用的node:14.19.3-alpine）：

# 在执行npm install前安装依赖
RUN apk add --no-cache \
    pkgconfig \
    pixman-dev \
    cairo-dev \
    pango-dev \
    libjpeg-turbo-dev \
    giflib-dev \
    build-base

• 如果是Debian/Ubuntu基础镜像（对应geoffreybooth/meteor-base:2.10.0）：

# 在执行npm install前安装依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    pkg-config \
    libpixman-1-dev \
    libcairo2-dev \
    libpango1.0-dev \
    libjpeg-dev \
    libgif-dev \
    build-essential && \
    apt-get clean && rm -rf /var/lib/apt/lists/*

2. 调整Dockerfile执行顺序 #

确保先完成系统依赖安装，再执行项目的依赖安装命令（如meteor npm install或meteor build），避免因依赖缺失导致编译中断。

3. 可选：跳过编译直接使用预编译包 #

若不想在容器内编译，可尝试设置环境变量让node-pre-gyp直接下载对应平台的预编译二进制包（Alpine平台预编译包支持有限，优先推荐安装编译依赖）：

ENV npm_config_build_from_source=false

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