含Kids段的FDF无法填充PDF字段：FPDM库问题排查

一、先确认传入数据是否正确 #

• 执行 pdftk test.pdf dump_data_fields 导出完整字段列表，精准核对层级字段的实际FieldName：
  带Kids结构的字段在PDF内部的命名可能并非Text36.0，比如可能是Text36[0]或嵌套别名，必须确保传入的字段名和dump结果里的完全一致。
• 做极简FDF测试：
  生成只包含Text36.0字段的FDF文件，用 pdftk test.pdf fill_form test.fdf output filled.pdf 验证填充效果。如果pdftk能成功，说明数据格式没问题；如果pdftk也失败，那就是字段名或FDF结构错误。
• 检查FDF的Kids段落格式：
  确认FDF中字段的Parent/Kids关联是否符合PDF规范，有没有拼写或格式错误。

二、排查FPDM库的局限性 #

• 检查FPDM的字段解析能力：
  如果FPDM支持导出字段列表，执行导出操作看是否能列出Text36.0。如果列表里没有这个字段，说明FPDM无法解析带Kids结构的嵌套字段。
• 对比pdftk的表现：
  pdftk能识别全部402个字段包括层级字段，说明PDF结构合规。如果FPDM仅能处理平级字段，那就是库本身的局限性导致的。
• 测试字段名格式变体：
  若PDF实际是嵌套结构（比如Text36下的子字段0），尝试用Text36[0]等其他格式传入，看是否能被FPDM识别。
• 查看FPDM源码/文档：
  确认官方是否明确说明不支持嵌套字段，或者有没有已知的相关issue。

三、验证性测试 #

• 用pdftk成功填充后，对比填充前后的PDF元数据，再和FPDM填充失败的PDF对比，确认FPDM是否正确处理了字段的写入逻辑。
• 若FPDM是开源的，可尝试修改源码，添加对Kids结构字段的解析逻辑（比如处理Parent属性，正确拼接子字段名称）。

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