使用iTextSharp添加PDF水印后PAC工具提示可访问性相关警告

嘿，我来帮你搞定这两个PAC工具的警告问题，逐个分析给你听：

一、iText 7相关警告 #

虽然你用的是iTextSharp（也就是iText 5.x系列），但PAC跳出iText 7相关警告，大概率是因为iTextSharp生成的PDF里带了一些和iText 7兼容的结构元数据，或者是PAC工具的小误报。不过咱们可以做这些操作来规避：

• 把你的iTextSharp更到最新的稳定版（虽然iTextSharp已经停更了，但最新版能减少不少兼容性坑）
• 生成PDF时明确开启可访问性配置：给PdfWriter加上SetAccessible(true)，同时指定PDF版本为1.7：writer.SetPdfVersion(PdfWriter.PDF_VERSION_1_7)

二、"Possibly Inappropriate use of Span structure element"警告 #

这个警告的核心问题是：你的水印文本没被标记成装饰性内容，PAC工具把它当成了需要结构化的正文内容，结果错误地用了Span元素来包裹，就触发了警告。解决的关键是把水印标记为Artifact（PDF里的"工件"，也就是纯装饰、不属于核心内容的元素），这样辅助工具（比如屏幕阅读器）会自动忽略它，结构警告也会消失。

调整后的水印代码 #

我给你改了OnEndPage方法，重点就是加上Artifact标记：

public override void OnEndPage(PdfWriter writer, Document document)
{
    float fontSize = 80;
    float xPosition = 300;
    float yPosition = 400;
    float angle = 45;

    PdfContentByte under = writer.DirectContentUnder;
    BaseFont baseFont = BaseFont.CreateFont(BaseFont.HELVETICA, BaseFont.WINANSI, BaseFont.EMBEDDED); // 改成嵌入字体，符合可访问性要求

    // 标记这段内容为装饰性Artifact
    under.BeginMarkedContentSequence(PdfName.Artifact, new PdfDictionary());
    
    under.SaveState();
    under.SetColorFill(BaseColor.LIGHT_GRAY);
    under.BeginText();
    under.SetFontAndSize(baseFont, fontSize);
    under.ShowTextAligned(PdfContentByte.ALIGN_CENTER, "YOUR WATERMARK TEXT", xPosition, yPosition, angle);
    under.EndText();
    under.RestoreState();
    
    // 结束Artifact标记
    under.EndMarkedContentSequence();
}

关键说明 #

• 用BeginMarkedContentSequence和EndMarkedContentSequence把水印代码包起来，并且指定PdfName.Artifact，相当于告诉PAC和所有辅助工具："这玩意儿就是个装饰，不用把它当正经内容处理"。
• 另外把字体改成嵌入的（BaseFont.EMBEDDED），这也是PDF可访问性的基本要求，避免屏幕阅读器识别不了字体。

额外小建议 #

如果你的水印是有实际含义的提示（比如"机密文档"），那别标记成Artifact，反而要给它加合适的结构标签和替代文本，但这种情况很少见，大部分水印都是纯装饰的。另外，如果长期做PDF可访问性的话，建议尽早迁移到iText 7，它对PDF/UA的支持比iTextSharp完善太多，能从根源减少这类麻烦。

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