Docusign问题：Base64文档中Auto-Place tabs无法显示

核心问题分析 #

你当前的代码仅定义了单条锚点规则，但DocuSign默认只会匹配第一个符合条件的锚点字符串。要实现多标签自动生成，需配置锚点的重复匹配属性，同时还要确保文档内的Signature关键词能被正确识别。

修复步骤 #

1. 开启锚点全局匹配 #

在SignHere对象中补充锚点匹配规则，让系统识别所有出现的Signature关键词：

SignHere().apply {
    anchorString = "Signature"
    name = "signature-$id"
    tabLabel = "sign-here-$id"
    // 设置锚点单位与偏移，避免标签覆盖原文字
    anchorUnits = "pixels"
    anchorXOffset = "20"
    anchorYOffset = "-10"
    // 精准匹配完整单词，避免误匹配含Signature的长单词
    anchorMatchWholeWord = true
    // 强制要求找到锚点才创建标签（调试阶段开启，方便排查问题）
    anchorIgnoreIfNotPresent = false
    // 可选：限制最大匹配数量，比如最多生成5个标签
    // anchorMaxMatches = 5
}

2. 验证文档内的锚点字符串 #

• 确认PDF里的Signature是可搜索的文本，而非图片、矢量图形（DocuSign锚点仅能识别文本内容）
• 检查大小写一致性：若文档内是全小写的signature，需将代码中的anchorString改为小写，或添加anchorCaseSensitive = false关闭大小写校验
• 排查空格干扰：如果Signature前后存在多余空格，需同步调整anchorString内容，或关闭全词匹配

3. 确认文档与收件人关联正确 #

确保代码中documentId = "1"与SignHere标签的默认关联文档ID一致（若未显式指定标签的documentId，系统会默认绑定到documentId=1的文档，当前代码逻辑是正确的，多文档场景需显式指定）

4. 调试技巧 #

• 调用API后获取信封详情，查看tabs节点是否返回已创建的标签，若未返回则说明锚点匹配失败
• 将PDF上传至DocuSign控制台手动测试锚点，验证系统能否识别Signature关键词，排除文档本身的问题

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