iText 7 .NET：扁平化表单时触发'System.NullReferenceException'异常

从你贴的代码片段来看，触发空引用异常大概率是因为表单对象未正确初始化或判空，结合iText 7的VB.NET使用场景，我整理了几个核心问题点和修复方案：

常见触发原因 #

1. PdfAcroForm对象未赋值或为null：你代码里只声明了form变量，但没有通过PdfAcroForm.GetAcroForm()完成初始化。如果源PDF本身没有AcroForm表单，这个方法会返回null，后续调用form.FlattenFields()就会直接触发空引用。
2. 资源未正确释放：循环里的pdfDocumentR如果不手动关闭，会导致对象状态异常，也可能间接引发空引用。
3. 字段集合未做判空：即使拿到了form，如果fields为null或空集合，后续操作也可能出问题。

修正后的完整代码示例 #

' 替换成你的目标文件路径
Dim destPath As String = "C:\Output\merged_flattened.pdf"

' 使用Using语句自动管理IO资源，避免泄漏
Using writer As New PdfWriter(destPath)
    writer.SetSmartMode(True)
    Using pdfDocumentW As New PdfDocument(writer)
        For Each documento As Documento In documentos
            ' 替换成你的源PDF路径（比如documento对应的文件路径）
            Using pdfReader As New PdfReader(documento.FilePath)
                Using pdfDocumentR As New PdfDocument(pdfReader)
                    ' 获取源文档的AcroForm：第二个参数为False，无表单则返回null（不自动创建）
                    Dim form As PdfAcroForm = PdfAcroForm.GetAcroForm(pdfDocumentR, False)
                    
                    ' 关键：先判空再操作
                    If form IsNot Nothing Then
                        Dim fields As IDictionary(Of String, PdfFormField) = form.GetFormFields()
                        
                        ' 如果需要复制字段到目标文档，先确保目标文档有AcroForm
                        Dim targetForm As PdfAcroForm = PdfAcroForm.GetAcroForm(pdfDocumentW, True)
                        
                        ' 复制字段逻辑（如果你的需求是这个）
                        For Each kvp As KeyValuePair(Of String, PdfFormField) In fields
                            ' 克隆字段到目标文档
                            Dim clonedField = kvp.Value.Clone(pdfDocumentW)
                            targetForm.AddField(clonedField, pdfDocumentW.AddNewPage())
                        Next
                        
                        ' 执行扁平化，此时form肯定不为null
                        form.FlattenFields()
                    Else
                        ' 友好提示，避免静默出错
                        Console.WriteLine($"警告：文档 {documento.Name} 不包含可编辑表单，跳过扁平化")
                    End If

                    ' 将源文档页面复制到目标文档（如果需要合并）
                    pdfDocumentR.CopyPagesTo(1, pdfDocumentR.GetNumberOfPages(), pdfDocumentW)
                End Using
            End Using
        Next
    End Using
End Using

核心修复点说明 #

• 强制资源管理：用Using包裹所有实现了IDisposable的对象（PdfReader、PdfDocument等），确保执行完自动关闭，避免对象状态异常。
• 严格判空：对form、fields都做IsNot Nothing判断，从根源避免空引用。
• 目标表单初始化：如果需要复制字段到目标文档，要用PdfAcroForm.GetAcroForm(pdfDocumentW, True)创建目标表单（第二个参数为True表示无表单时自动创建）。

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