JavaScript调用Gmail API发送邮件时编解码导致URL乱码损坏

这个问题确实是编码环节操作错误导致的，核心错误是手动拼接quoted-printable转义内容时未遵守编码规则，引发内容截断、转义逻辑混乱。

• 你代码里手动写的=3D是quoted-printable（下简称QP）编码中代表等号=的转义序列，同时你还在邮件头里声明了Content-Transfer-Encoding: quoted-printable，但你完全没遵守QP编码的强制规则：QP编码要求单行字符长度不能超过76个，超出部分必须在行尾加=作为软换行标记，否则邮件客户端解码时会自动在76字符位置强制截断插入换行，直接破坏内容结构。
• 你看到的链接损坏完全符合这个规则触发的现象：
  • 原本的export被拆成e=xport，是因为强制断行位置刚好在e之后，断行位置被客户端错误识别为QP软换行标记，凭空多出来一个等号
  • 原本的&id=1a变成&id A9，是因为断行把等号和开头的1拆到了其他行，再叠加HTML实体转义规则，等号和字符1直接丢失
• 额外的逻辑冲突：你声明了QP传输编码，最终发送时又对整个邮件内容做了urlsafe base64编码，两层编码逻辑叠加，进一步放大了解码错误。

推荐直接用最稳妥的方案1，完全规避QP编码的坑：

方案1：移除手动QP转义，直接用原生HTML做base64发送 #

删掉所有手动写的=3D这类QP转义符，写标准的HTML标签，同时删掉QP传输编码声明，直接构造内容base64发送即可，修改后的代码如下：

// 直接写标准HTML，不要手动加QP转义
mailMessage += '<img src="https://drive.google.com/uc?export=view&id=1aA93WZJOhKMZ8JCmJ4u3ejfGVM_Qe2Uv" width="300" alt="Mountains Picture" style="width:100%; height:auto; display:block; border:none; text-decoration:none; color:#363636;">\n';

email += mailTo + "\r\n";
email += mailFrom + "\r\n";
email += mailSubject + "\r\n";

email += "Content-Type: text/html; charset=utf-8\r\n";      
// 删除Content-Transfer-Encoding: quoted-printable这行头声明
email += "\r\n" + mailMessage;

原有发送逻辑不需要修改，这种方式不会触发行长度截断问题，稳定性最高。

方案2：坚持使用QP编码 #

不要手动拼接=3D这类转义字符，引入成熟的QP编码库处理邮件正文，自动完成特殊字符转义、软换行插入，从根源上避免行超长截断的问题。

补充提示：Google Drive的uc链接默认会屏蔽邮件客户端的跨域访问请求，就算链接修复正确，图片也大概率无法正常加载，需要发内嵌图片建议将图片转成base64格式内嵌到邮件内容中，或使用支持邮件跨域引用的图床。

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