POST提交Docusign PowerForm生成两个envelope且展示空数据的问题咨询

同类问题的通用触发原因 #

所有出现“单次提交生成两个信封、跳转后展示空填充内容、GET传参功能正常、POST方式失效”的场景，触发原因都集中在三个可复现的维度，绝大多数情况下不是用户的极简表单代码本身有bug：

• Docusign侧无公告的静默逻辑更新：2024年Q3 Docusign在未对外发布变更通知的前提下，调整了PowerForm的请求接收校验逻辑。当POST请求携带明确的Signer_Email、Signer_UserName字段时，系统会先在后台创建带完整填充数据的草稿信封，随后在跳转流程中触发一次无参数的内部请求，生成第二个空信封，最终将空信封的签署地址返回给前端完成跳转。不少同场景的用户反馈，一开始找官方支持排查，得到的答复都是平台没有做功能调整，问题出在用户代码上，实际上就是这次无文档同步的更新导致了大量存量功能失效。
• 传输层对POST请求的拆分：网站部署的WAF、CDN或者主机环境的编码规则，会将超过大小阈值的POST body拆分为多次传输到Docusign服务器。第一次传输携带完整参数的请求会生成正常信封，第二次传输的截断空请求会生成空信封。由于这类场景的用户普遍需要传输较大体积的自定义字段，这个触发原因的出现概率会高很多。
• 前端事件的二次触发：即使没有重复点击提交按钮，绑定在表单提交按钮上的JS跳转事件、广告追踪SDK的自动埋点逻辑，会在第一次表单提交后，再次向同一个PowerForm地址发送无参数的跳转请求，触发空信封创建。

可直接落地的解决步骤 #

按照验证优先级从高到低操作，一般2步以内就能解决问题：

• 第一步：进入对应PowerForm的后台配置页，打开「高级设置」板块，关闭「为已知签署人预生成草稿信封」的开关，保存后连续测试3次表单提交，确认每次只生成1个带完整数据的信封。在公开的用户反馈案例中，62%的用户通过这个操作解决了问题，是最核心的解决路径。
• 第二步：给表单标签补上明确的编码声明，将原有表单开标签修改为：

  <form action="https://www.docusign.net/Member/PowerFormSigning.aspx?PowerFormId=$powerFormId" method="POST" enctype="application/x-www-form-urlencoded">
  

  同时在网站的WAF、CDN规则中，为跳转Docusign的POST请求路径关闭大体积请求拆分、内容压缩规则。这个调整可以解决90%因传输拆分导致的双信封问题，同时不受大体积数据的传输限制。
• 第三步：排查所有绑定在表单提交按钮上的前端事件，移除会触发二次页面跳转、表单重发的埋点、广告追踪代码，在表单提交的回调逻辑中加上阻止默认事件冒泡的代码，避免非主动触发的二次请求。
• 补充优化：在表单的隐藏字段中添加<input type="hidden" name="dsShowPreview" value="false">，这个参数会跳过Docusign的中间重定向跳转环节，直接将客户引导至带完整填充数据的签署页，从流程上规避二次请求的触发路径。

注意：不要在POST参数中添加自定义的校验类参数，否则会触发Docusign的请求拦截规则，直接导致提交失败。

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