.NET 6中为现有PDF加水印遇IronPdf无效，求替代方案

一、修复IronPdf当前问题 #

针对你代码中存在的问题，可按以下步骤调整：

1. 修正HTML标签错误：你写的<h1/>是无效闭合标签，需改为</h1>，错误标签会导致IronPdf无法正确渲染水印内容。
2. 调整引擎配置顺序：ChromeGpuMode需要在Installation.Initialize()之前设置，否则配置不会生效。
3. 指定水印位置与缩放：默认参数可能导致水印位置偏移或尺寸过小，建议使用带位置参数的重载确保水印可见。
4. Linux环境依赖检查：如果在Linux下运行，你关闭了自动依赖配置，需手动安装Chrome相关依赖（如libnss3、libatk1.0-0、libxss1等）。

修正后的代码示例 #

// 先配置引擎参数，再初始化IronPdf
IronPdf.Logging.Logger.EnableDebugging = true;
IronPdf.Logging.Logger.LogFilePath = "Default.log";
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;
Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
Installation.LinuxAndDockerDependenciesAutoConfig = false;
Installation.Initialize();

HttpResponseMessage stream = await this.httpClient.GetAsync("https://test2134.blob.core.windows.net/test34343/Form 343 - Blank.pdf");
using PdfDocument pdf = new PdfDocument(stream.Content.ReadAsStream());

// 修正HTML标签
string html = "<h1> Example Title </h1>";
int rotation = 0;
int watermarkOpacity = 30;

// 使用指定位置和缩放的重载，确保水印居中显示
pdf.ApplyWatermark(html, rotation, watermarkOpacity, 
    verticalAlignment: IronPdf.Editing.VerticalAlignment.Center,
    horizontalAlignment: IronPdf.Editing.HorizontalAlignment.Center,
    scale: 100);

pdf.SaveAs(Path.Combine(Directory.GetCurrentDirectory(), "test.pdf"));

二、替代PDF库推荐 #

如果IronPdf问题仍无法解决，可尝试以下成熟的PDF处理库：

1. iText 7 #

功能全面的PDF处理库，支持文本、HTML等多种水印类型。注意：开源版本采用AGPL协议，商业用途需购买商业许可证。

using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.Layout.Properties;

using var reader = new PdfReader("input.pdf");
using var writer = new PdfWriter("output.pdf");
using var pdfDoc = new PdfDocument(reader, writer);
Document doc = new Document(pdfDoc);

for (int i = 1; i <= pdfDoc.GetNumberOfPages(); i++)
{
    PageSize pageSize = pdfDoc.GetPage(i).GetPageSize();
    Paragraph watermark = new Paragraph("Example Title")
        .SetFontSize(40)
        .SetOpacity(0.3f)
        .SetTextAlignment(TextAlignment.CENTER)
        .SetVerticalAlignment(VerticalAlignment.MIDDLE);
    
    doc.ShowTextAligned(watermark, pageSize.GetWidth()/2, pageSize.GetHeight()/2, i, 
        TextAlignment.CENTER, VerticalAlignment.MIDDLE, 0);
}
doc.Close();

2. PdfSharp #

开源免费的轻量级PDF库，适合简单的水印添加需求，无需复杂配置。

using PdfSharp.Pdf;
using PdfSharp.Drawing;

PdfDocument document = PdfReader.Open("input.pdf", PdfDocumentOpenMode.Modify);
XFont font = new XFont("Arial", 40, XFontStyle.Bold);
// 30%透明度（76/255≈0.3）
XBrush brush = new XSolidBrush(XColor.FromArgb(76, 0, 0, 0));

foreach (PdfPage page in document.Pages)
{
    using (XGraphics gfx = XGraphics.FromPdfPage(page))
    {
        XSize size = gfx.MeasureString("Example Title", font);
        // 居中绘制水印
        gfx.DrawString("Example Title", font, brush,
            new XPoint((page.Width - size.Width) / 2, (page.Height - size.Height) / 2),
            XStringFormats.Center);
    }
}
document.Save("output.pdf");

3. QuestPDF #

主打声明式PDF生成，可将现有PDF转换为图像后叠加水印，再重新生成PDF，适合需要自定义水印样式的场景。

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