diff --git a/scripts/docker/install-build-deps.sh b/scripts/docker/install-build-deps.sh
index a179366..9a27d33 100644
--- a/scripts/docker/install-build-deps.sh
+++ b/scripts/docker/install-build-deps.sh
@@ -43,6 +43,15 @@ apt-get install -y --no-install-recommends \
   libwebkit2gtk-4.1-dev libjavascriptcoregtk-4.1-dev \
   libayatana-appindicator3-dev librsvg2-dev libssl-dev
 
+# 构建阶段自检：避免缓存/半装镜像拖到 run 时才在 build-linux-deb-all.sh 里失败
+for f in glib-2.0.pc gdk-3.0.pc webkit2gtk-4.1.pc; do
+  if [[ ! -f "/usr/lib/x86_64-linux-gnu/pkgconfig/${f}" ]]; then
+    echo "ERROR: amd64 缺少 pkg-config: /usr/lib/x86_64-linux-gnu/pkgconfig/${f}" >&2
+    echo "请检查 libwebkit2gtk-4.1-dev 等是否已正确安装。" >&2
+    exit 1
+  fi
+done
+
 # 交叉 arm64（勿装 systemd-sysv:arm64；用 --no-install-recommends）
 if ! apt-get install -y --no-install-recommends \
   -o Dpkg::Options::="--force-overwrite" \
@@ -63,6 +72,13 @@ if ! apt-get install -y --no-install-recommends \
     libssl-dev:arm64 libayatana-appindicator3-dev:arm64 librsvg2-dev:arm64
 fi
 
+for f in glib-2.0.pc gdk-3.0.pc webkit2gtk-4.1.pc; do
+  if [[ ! -f "/usr/lib/aarch64-linux-gnu/pkgconfig/${f}" ]]; then
+    echo "ERROR: arm64 缺少 pkg-config: /usr/lib/aarch64-linux-gnu/pkgconfig/${f}" >&2
+    exit 1
+  fi
+done
+
 # Node.js 22（不走 NodeSource apt，避免 multiarch 下 python 依赖冲突）
 NODE_VERSION="v22.16.0"
 curl -fsSL "https://nodejs.org/dist/${NODE_VERSION}/node-${NODE_VERSION}-linux-x64.tar.xz" -o /tmp/node.tar.xz