QuestPDF本地正常，部署至IIS服务器后生成PDF报500错误

问题现象 #

本地环境下使用QuestPDF生成动态PDF，点击按钮触发下载功能完全正常；部署至IIS服务器后该功能触发HTTP 500错误，页面提示无法处理请求，浏览器控制台仅返回500状态码。增删改等其他业务功能正常，已为IIS_IUSRS配置MIME类型完全控制权限，且存在application/pdf类型配置。

排查与解决步骤 #

1. 检查QuestPDF依赖的原生库是否缺失 #

QuestPDF依赖SkiaSharp渲染引擎，部署到IIS时可能缺少对应系统的原生库文件：

• 安装对应平台的SkiaSharp原生资产包，Windows服务器可安装SkiaSharp.NativeAssets.Win32，在项目文件中添加：

<ItemGroup>
  <PackageReference Include="SkiaSharp.NativeAssets.Win32" Version="2.88.6" />
</ItemGroup>

• 发布项目时选择自包含模式，确保依赖的原生库被复制到服务器部署目录。

2. 验证服务器权限配置 #

QuestPDF生成PDF过程中可能需要访问临时目录或系统资源，IIS应用池身份权限不足会导致异常：

• 检查应用程序池的运行身份，确保其拥有服务器临时目录（如%TEMP%）的读写权限；
• 临时给应用程序池身份分配本地管理员权限测试，确认问题后再调整为最小必要权限。

3. 修正返回的文件名格式 #

原代码中返回的文件名为.pdf，无实际名称可能导致IIS处理异常：
修改返回语句，指定合法的文件名：

return File(stream, "application/pdf", $"ProyectoOverhead_{id}.pdf");

4. 检查ASP.NET Core IIS配置 #

• 确认服务器已安装对应版本的.NET Core Hosting Bundle；
• 确保应用程序池的**.NET CLR版本设置为无托管代码**（ASP.NET Core为自托管架构）。

5. 开启详细日志定位异常 #

通过日志获取500错误的具体原因：

• 在appsettings.json中配置日志级别：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "QuestPDF": "Debug"
    }
  }
}

• 查看服务器事件查看器（Windows日志 -> 应用程序）或ASP.NET Core日志文件，提取具体异常栈信息。

用户原代码（标注问题点） #

public IActionResult ImprimirProyectoPartidaOVERHEAD(int id)
{
    var data = Document.Create(document =>
    {
        document.Page(page =>
        {
            var pageSize = new PageSize(612f, 840f);
            page.Size(pageSize);
            page.MarginLeft(60);
            page.MarginRight(60);
            page.MarginTop(30);
            page.MarginBottom(30);
            page.Background()
            .AlignBottom()
            .ExtendHorizontal()
            .Height(115)
            .Background("#000000");

            page.Header().Height(240).Row(row =>
            {
                
            });

            page.Content().PaddingVertical(10).Column(col1 =>
            {
                
            });

            page.Footer()
            .Column(txt =>
            {
               
            });
        });
    }).GeneratePdf();

    MemoryStream stream = new MemoryStream(data);
    return File(stream, "application/pdf", ".pdf"); // 问题点：文件名格式不合法
}

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