修復IronPDF在Google Cloud Run上部署問題

Curtis Chau

Updated: 2026年6月10日

IronPDF在部署到Google Cloud Run第一代時無法生成PDF或會崩潰。常見的三種故障模式如下：

在生成PDF期間應用程式崩潰或產生分段錯誤
由於缺少圖形庫（如libgtk2.0-0）而導致的依賴性故障
環境缺乏圖形加速支持時的GPU或渲染錯誤

Google Cloud Run第一代使用Linux內核4.4.0，不支持IronPDF的Chrome基渲染器所需的支持。第二代環境使用內核6.4.10，解決了這些相容性問題。

解決方案

步驟1：切換到第二代執行環境

在您的部署命令中新增--execution-environment gen2：

gcloud run deploy my-ironpdf-service \
    --image gcr.io/my-project/my-ironpdf-app \
    --platform managed \
    --region us-central1 \
    --execution-environment gen2 \
    --allow-unauthenticated

gcloud run deploy my-ironpdf-service \
    --image gcr.io/my-project/my-ironpdf-app \
    --platform managed \
    --region us-central1 \
    --execution-environment gen2 \
    --allow-unauthenticated

SHELL

步驟2：更新您的Dockerfile以包含所需的依賴項

FROM --platform=linux/amd64 mcr.microsoft.com/dotnet/aspnet:8.0 AS base
USER root
WORKDIR /app
EXPOSE 8080

RUN apt update && apt install -y \
    sudo libglib2.0-0 libxkbcommon-x11-0 libc6 libc6-dev \
    libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 \
    libxcb-dri3-0 libdrm-common libgbm1 libasound2 \
    libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev \
    libstdc++6 libxcomposite1 \
    && rm -rf /var/lib/apt/lists/*

COPY . .
RUN dotnet publish -c Release -o /app/publish

CMD ["dotnet", "/app/publish/myapp.dll"]

FROM --platform=linux/amd64 mcr.microsoft.com/dotnet/aspnet:8.0 AS base
USER root
WORKDIR /app
EXPOSE 8080

RUN apt update && apt install -y \
    sudo libglib2.0-0 libxkbcommon-x11-0 libc6 libc6-dev \
    libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 \
    libxcb-dri3-0 libdrm-common libgbm1 libasound2 \
    libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev \
    libstdc++6 libxcomposite1 \
    && rm -rf /var/lib/apt/lists/*

COPY . .
RUN dotnet publish -c Release -o /app/publish

CMD ["dotnet", "/app/publish/myapp.dll"]

Text

有關Linux發行版所需封裝的完整列表，請參閱Linux部署指南。