使用iTextSharp从HTML生成PDF/A-3时提示‘文档无页面’错误

问题背景 #

使用iTextSharp从HTML生成普通PDF功能正常，但生成PDF/A-3格式时始终抛出**“文档无页面”**错误，堆栈跟踪指向Document.Close()环节：

at iTextSharp.text.pdf.PdfPages.WritePageTree() at iTextSharp.text.pdf.PdfWriter.Close() at iTextSharp.text.pdf.PdfAWriter.Close() at iTextSharp.text.pdf.PdfDocument.Close() at iTextSharp.text.Document.Close() at Common.PDFHelper.GeneratePDF(String html, String fileName, Boolean isNormalPDF, String detailsJSON)

问题根源 #

PDF/A-3的规范比普通PDF严格很多，报错核心原因是内容未被正确渲染，具体可能的触发点：

• 字体未强制嵌入：PDF/A要求所有使用的字体必须嵌入文档，普通PDF允许未嵌入字体，但PDF/A会因字体缺失拒绝生成页面
• PDF/A配置顺序错误：iTextSharp对PDF/A的元数据、输出意图等配置时机有要求，错误顺序会导致渲染逻辑异常
• 异常被静默吞掉：代码中空catch块掩盖了XMLWorker解析HTML时的真实错误，无法定位内容渲染失败的具体原因

修复步骤 #

1. 移除静默捕获，暴露真实错误 #

先把空catch块替换为日志输出或直接抛出，获取XMLWorker解析时的具体报错：

catch (Exception ex)
{
    // 替换为实际的日志记录逻辑，比如写入日志文件或输出到响应
    HttpContext.Current.Response.Write($"生成PDF出错：{ex.Message}<br/>{ex.StackTrace}");
    HttpContext.Current.Response.End();
}

2. 强制字体嵌入 #

修改XMLWorkerFontProvider配置，确保所有字体被嵌入：

XMLWorkerFontProvider fontProvider = new XMLWorkerFontProvider(Environment.GetFolderPath(Environment.SpecialFolder.Fonts));
fontProvider.SetUseUnicode(true);
fontProvider.SetEmbedding(true); // 关键：开启强制字体嵌入
fontProvider.AddFontSubstitute("lowagie", "Arial"); // 替换默认缺失字体

3. 调整PDF/A配置顺序 #

将PDF/A核心配置（元数据、输出意图等）移到pdfDoc.Open()之前，符合iTextSharp的处理逻辑：

else //Create PDF/A-3
{
    Document pdfDoc = new Document(PageSize.A4);
    PdfAWriter writer = PdfAWriter.GetInstance(pdfDoc, memoryStream, PdfAConformanceLevel.PDF_A_3A);

    // 先完成PDF/A配置，再打开文档
    writer.CreateXmpMetadata();

    // 读取并设置颜色配置文件，使用using自动释放流
    string sRGBCSprofile = HttpContext.Current.Server.MapPath("~/Resources/Color/sRGB_CS_profile.icm");
    using (FileStream sRGBCSproFileStream = new FileStream(sRGBCSprofile, FileMode.Open, FileAccess.Read))
    {
        var sRGBCSproFileByte = new byte[sRGBCSproFileStream.Length];
        sRGBCSproFileStream.Read(sRGBCSproFileByte, 0, sRGBCSproFileByte.Length);
        ICC_Profile iccProfile = ICC_Profile.GetInstance(sRGBCSproFileByte);
        writer.SetOutputIntents("Custom", "", "http://www.color.org", "sRGB IEC61966-2.1", iccProfile);
    }

    // 设置文档标记信息，布尔值直接传bool类型而非字符串
    PdfDictionary markInfo = new PdfDictionary(PdfName.MARKINFO);
    markInfo.Put(PdfName.MARKED, new PdfBoolean(true));
    writer.ExtraCatalog.Put(PdfName.MARKINFO, markInfo);

    // 配置字体嵌入
    XMLWorkerFontProvider fontProvider = new XMLWorkerFontProvider(Environment.GetFolderPath(Environment.SpecialFolder.Fonts));
    fontProvider.SetUseUnicode(true);
    fontProvider.SetEmbedding(true);

    pdfDoc.Open();

    // 使用using自动释放HTML内容流
    using (MemoryStream htmlContent = new MemoryStream(Encoding.UTF8.GetBytes(html)))
    {
        XMLWorkerHelper.GetInstance().ParseXHtml(writer, pdfDoc, htmlContent, null, Encoding.UTF8, fontProvider);
    }

    pdfDoc.Close();
}

4. 验证HTML兼容性 #

先使用极简HTML测试（避免动态脚本、未编码特殊字符等PDF/A不支持的元素）：

<html>
<body>
    <h1>PDF/A-3测试内容</h1>
    <p>这是一段用于验证的普通文本。</p>
</body>
</html>

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