发送多文档时触发DocuSign ANCHOR_TAG_PROCESSING_FAILURE错误排查求助

错误现象 #

发送单份文档时信封可正常创建，添加多份文档后触发以下错误：

DocuSign error: ANCHOR_TAG_PROCESSING_FAILURE

关联代码片段 #

for (let i = 1; i <= envelopeArgs.docPaths.length; i++) {
  // console.log("envelopeArgs.docPaths[i]", envelopeArgs.docPaths[i]);
  let index = i - 1;
  const docPath = envelopeArgs.docPaths[index];
  console.log("docPath", docPath);
  let docFullName = path.basename(docPath);
  let docName = path.parse(docFullName).name;
  let docExtension = path.extname(docFullName);
  docExtension = docExtension.slice(1);
  let docBytes = fs.readFileSync(docPath);
  let docB64 = Buffer.from(docBytes).toString("base64");
  let doc = new docuSign.Document.constructFromObject({
    documentBase64: docB64,
    name: docName, //"fileToSign",
    fileExtension: docExtension, //"pdf",
    documentId: i.toString(),
  });
  env.documents.push(doc);
}
console.log("env.documents", env.documents);

可能的原因及解决方案 #

• 锚点标签未在所有文档中匹配：DocuSign会按锚点规则扫描所有文档，若某锚点仅存在于部分文档，就会触发错误。检查签名/审批字段的锚点设置，要么确保所有文档都有对应锚点文本，要么为不同文档单独配置字段并指定对应documentId。
• 字段未绑定具体文档：代码中已为每份文档分配唯一documentId，但需确认后续添加的签名字段是否正确关联了对应文档的documentId。若字段未指定文档，DocuSign会默认在所有文档中查找锚点，某份文档找不到就会报错。
• 锚点文本格式不一致：不同文档中锚点的大小写、空格、特殊字符等格式不统一，导致识别失败。统一所有文档的锚点文本格式，确保完全匹配。
• 文档本身解析异常：部分文档可能损坏或格式异常，导致DocuSign无法解析锚点。单独测试每一份文档，排查是否存在文档本身的问题。

内容的提问来源于stack exchange，提问作者Ngọc Trung Nguyễn