使用Datalogics.PDFL保存部分PDF时遇CMap编码缺失错误（错误码537067605）

我之前处理过不少Datalogics.PDFL相关的字体编码问题，这个错误（错误代码537067605）的核心原因很明确：你要处理的这部分PDF里，某个字体引用了系统或Datalogics资源目录中不存在的CMap（字符映射表）。这里要划重点：安装字体文件≠安装对应的CMap，很多小众编码、CJK字体的CMap是独立于字体文件的映射规则文件，这也是你装了字体却没用的原因。

下面是我亲测有效的几个解决步骤，按优先级尝试：

• 第一步：精准定位缺失的CMap名称
  盲目找CMap效率太低，先通过代码捕获更详细的错误信息，锁定具体缺失的CMap：

  try
  {
      // 这里放你原本的PDF加载、保存代码
      Document doc = new Document("your-input.pdf");
      doc.Save("your-output.pdf", new SaveParams());
  }
  catch (PDFLException ex)
  {
      Console.WriteLine($"完整错误详情: {ex.Message}");
      // 很多时候InnerException会包含具体的CMap名称
      if (ex.InnerException != null)
          Console.WriteLine($"缺失的CMap: {ex.InnerException.Message}");
  }
  

  拿到具体的CMap名称后，就能针对性地找文件了。

• 第二步：把缺失的CMap放到Datalogics的资源目录
  Datalogics.PDFL会优先读取自身安装目录下的Resource/CMap文件夹，而不是系统字体目录。你可以：

  1. 从Adobe Acrobat的安装目录（比如C:\Program Files (x86)\Adobe\Acrobat DC\Resource\CMap）或者其他成熟PDF工具的CMap目录里，找到对应的.cmap文件
  2. 将这个文件复制到你的Datalogics.PDFL安装路径下的Resource/CMap文件夹中
  3. 重启你的应用程序，再尝试保存PDF

• 第三步：开启CMap缺失时的字体替换
  如果实在找不到对应的CMap，或者替换CMap后还是有问题，可以强制让Datalogics在遇到缺失CMap时，用系统兼容字体替换：

  // 配置字体替换参数
  FontSubstitutionParams subsParams = new FontSubstitutionParams();
  // 可以换成你系统中有的其他字体，比如宋体、微软雅黑
  subsParams.SubstituteFont = Font.CreateStandardFont(StandardFontName.Helvetica);
  subsParams.SubstituteOnMissingFont = true;
  subsParams.SubstituteOnMissingCMap = true; // 关键：开启CMap缺失时的替换
  
  // 应用到保存参数
  SaveParams saveParams = new SaveParams();
  saveParams.FontSubstitutionParams = subsParams;
  
  // 执行保存
  Document doc = new Document("your-input.pdf");
  doc.Save("your-output.pdf", saveParams);
  

  这种方法可能会让部分特殊字符的排版有轻微变化，但能确保PDF正常保存。

• 第四步：修复PDF本身的隐性损坏
  有些PDF的字体字典本身存在损坏（比如CMap路径引用错误），你可以先用Adobe Acrobat打开这个PDF，执行「文件→另存为」，生成一个重新编码的干净PDF，再用Datalogics.PDFL处理这个新文件，很多隐性问题都会被Acrobat自动修复。

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