使用iText7合并可填写PDF后部分交互控件消失问题求助

嘿，我之前帮不少开发者解决过类似的PDF表单合并问题，你碰到的控件消失情况，核心原因是直接复制页面没有处理PDF表单域的文档级合并逻辑——毕竟PDF里的交互控件（比如文本框、按钮这些表单域）是属于整个文档的资源，不是单纯依附在页面上的，直接复制页面只会把可视化内容搬过去，表单域的配置信息没被正确合并到目标文档里。

问题出在哪？ #

你原来的代码应该是打算手动复制页面，但这种方式不会自动处理源文档的AcroForm字典（PDF存储表单域的核心结构），导致第二个文档的表单域要么被覆盖，要么根本没被添加到目标文档的表单体系里，自然就看不到了。

正确的解决方案：用PdfMerger类 #

iText7专门提供了PdfMerger来处理文档合并，它会自动处理表单域、书签、注释等文档级资源的合并，完美解决控件消失的问题。给你修改后的代码示例：

// 用using包裹所有文档对象，确保资源自动释放
using (PdfDocument destPdfDocument = new PdfDocument(new PdfWriter(Server.MapPath("~/Template/cmp_job_application_new_mrg.pdf"))))
{
    // 初始化PdfMerger
    PdfMerger merger = new PdfMerger(destPdfDocument);

    // 合并第一个源PDF
    using (PdfDocument source1 = new PdfDocument(new PdfReader(Server.MapPath("~/Template/cmp_job_application1.pdf"))))
    {
        // 合并源文档的所有页面（参数：源文档，起始页，结束页）
        merger.Merge(source1, 1, source1.GetNumberOfPages());
    }

    // 合并第二个源PDF
    using (PdfDocument source2 = new PdfDocument(new PdfReader(Server.MapPath("~/Template/cmp_job_application2.pdf"))))
    {
        merger.Merge(source2, 1, source2.GetNumberOfPages());
    }

    // 可选：处理表单域名称冲突
    // 如果两个源文档有同名表单域，可以设置合并模式：
    // 1. MERGE_FORM_FIELDS：合并同名域的值（适合同一字段在不同页面的情况）
    // merger.SetMergeMode(PdfMerger.MergeMode.MERGE_FORM_FIELDS);
    // 2. KEEP_EXISTING_FORM_FIELDS：保留第一个文档的域，忽略第二个的同名域
    // merger.SetMergeMode(PdfMerger.MergeMode.KEEP_EXISTING_FORM_FIELDS);
}

关键细节说明 #

1. 必须用using语句：确保所有PdfDocument和PdfMerger对象在使用后被正确释放，避免内存泄漏和文件锁问题。
2. 表单域冲突处理：如果两个源PDF里有名称相同的表单域，默认会保留第一个文档的域，第二个的会被忽略。根据你的需求选择合适的MergeMode来调整行为。
3. 不要手动复制页面：除非你完全清楚PDF的底层结构，否则别用CopyPagesTo这类方法来合并带表单的PDF，很容易丢资源。

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