Azure Linux App Service 部署故障排查

步骤1：识别缺失的依赖项

1. 从Visual Studio正常部署应用服务。
2. 打开Azure Linux App Service的SSH控制台。
3. 导航至wwwroot目录：

cd /home/site/wwwroot

4. 对本机二进制文件运行ldd以列出未解析的依赖项：

ldd IronInterop.so

5. 检查操作系统版本以确认适用的包名：

cat /etc/os-release

步骤2：安装缺失的库

对于大多数Linux发行版（基于Debian/Ubuntu的映像），使用以下命令安装所需的包：

apt-get update && apt-get install -y libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libxkbcommon0 libasound2 libatspi2.0-0

对于Ubuntu 24.04映像（与.NET 10一起使用），请改为使用以下Dockerfile指令，因为某些包名已更改：

RUN apt update \
    && apt install -y sudo libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2t64 libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev

步骤3：验证所有依赖项已解决

再次运行ldd以确认没有未解决的条目：

ldd IronInterop.so

所有条目都应显示已解析的路径，而不是not found。 一旦所有依赖项就位，通过Web应用程序的PDF渲染将正常工作。 有关各Linux发行版所需包的完整列表，请参阅Linux部署指南。