使用iText7在PDF绘制线条，外部接收方无法看到线条如何解决

问题根因 #

默认直接追加到页面新内容流的线条，容易被第三方PDF处理工具识别为水印、批注等冗余附加内容，或是被归类到可选内容组（OCG）被批量清理。你原有代码中使用的ClosePathStroke会强制闭合所有线条路径，也会提升被误判的概率。

修复方案 #

1. 核心代码修改 #

修改PdfCanvas初始化逻辑，将线条直接写入页面主内容流，同时优化路径描边逻辑，绘制完成后显式释放资源确保内容写入：

private void DrawLines(PdfDocument document, int pageIndex, IEnumerable<Line> lines)
{
    var page = document.GetPage(pageIndex + 1);
    // 重载构造函数第二个参数设为true：直接写入页面主内容流，与原有内容合并，不生成独立附加内容块
    var canvas = new PdfCanvas(page, true);

    if (canvas == null)
    {
        throw new Exception($"Could not create PdfCanvas for page: {pageIndex}");
    }

    if (!lines.Any())
    {
        canvas.Release();
        return;
    }

    // 可选：标记内容为正文附属内容，适配PDF/A等合规校验场景，避免被识别为非正文内容
    canvas.BeginMarkedContent(CanvasConstants.ARTIFACT);
    foreach (var line in lines)
    {
        line.Scale(page);
        DrawLine(canvas, line);
    }
    canvas.EndMarkedContent();

    // 显式释放画布，提交所有写入的内容到页面对象
    canvas.Release();
}

private void DrawLine(PdfCanvas canvas, Line line)
{
    canvas.SetLineWidth(line.BrushSize);
    canvas.SetStrokeColor(ColorConstants.BLACK);
    canvas.MoveTo(line.StartX, line.StartY);
    canvas.LineTo(line.EndX, line.EndY);
    // 开放式线条无需闭合路径，直接描边即可，避免生成多余闭合路径被误判为标注
    canvas.Stroke();
}

2. 保存逻辑优化 #

如果原代码使用了增量保存模式，修改为全量重写PDF，避免新增内容被识别为增量附加块：

// 保存时指定全量重写，禁用增量保存
document.Save("output.pdf", new WriterProperties()
    .SetFullCompressionMode(true)
    .UseAppendMode(false));

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