向DocuSign API传递含非拉丁UTF-8字符的HTML时的乱码问题

针对你遇到的俄语等多字节UTF-8字符在HTML转PDF后显示为乱码（如банан变成банан）的问题，可尝试以下几个关键修复方案：

1. 在HTML文档头部添加UTF-8编码声明 #

即使请求头已指定charset=utf-8，DocuSign的HTML渲染引擎仍可能优先读取HTML内部的编码声明。确保你的HTML开头包含：

<meta charset="UTF-8">

这是解决此类乱码问题的核心操作，不少场景下引擎会忽略请求头编码，转而依赖文档内的meta标签。

2. 明确指定支持多语言字符的字体 #

DocuSign转PDF时默认使用的字体可能不支持西里尔字母等非拉丁字符，导致字符无法正确渲染。在HTML的<style>中全局指定支持UTF-8的字体：

body {
    font-family: "Arial", "Helvetica Neue", Helvetica, sans-serif;
    /* 也可使用系统自带多语言字体：Windows用Segoe UI，Mac用San Francisco */
    /* font-family: "Segoe UI", "San Francisco", sans-serif; */
}

确保字体覆盖所有需要显示特殊字符的文本元素，避免局部未指定字体引发的乱码。

3. 验证请求内容的编码一致性 #

虽然服务器日志显示传入字符串正常，仍需确认发送请求时：

• 代码将HTML内容以UTF-8编码的字节流发送，而非默认使用ISO-8859-1等其他编码（部分框架需手动指定UTF-8）。
• 多部分表单中text/html部分的charset=utf-8参数未被框架或代理意外修改。

4. 尝试用Base64编码传递HTML文档 #

若以上步骤无效，可将HTML内容转为Base64编码后，通过DocuSign API的documentBase64字段传递（替代multipart/form-data方式），避免传输过程中编码被篡改：

• 将HTML内容转为UTF-8字节数组，再进行Base64编码。
• 在API请求的documents数组中配置：

{
    "documentId": "1",
    "name": "foo.html",
    "documentBase64": "这里是Base64编码后的UTF-8 HTML内容",
    "fileExtension": "html"
}

关于DocuSign的转换限制 #

目前DocuSign的HTML转PDF引擎对UTF-8的支持是完善的，乱码问题大多源于编码声明缺失、字体不支持或传输过程中的编码不一致，而非平台本身限制。你提到text tabs能正常显示，也说明平台对UTF-8字符的处理无问题，问题集中在HTML转PDF的渲染环节。

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