如何通过Python Gmail API在现有邮件中添加可正常显示的超链接？

问题根源 #

你遇到的核心问题是quoted-printable编码的HTML邮件处理逻辑错误。那些异常邮件的Content-Transfer-Encoding为quoted-printable，这种编码会把等号这类特殊字符转成=3D形式。你之前直接用part.get_payload()拿到的是编码后的文本，修改后直接存回，没有重新做quoted-printable编码，导致Gmail解析时格式混乱，等号丢失，最终链接被过滤。

修复步骤 #

修改HTML内容处理逻辑，严格遵循「解码→修改→重新编码」的流程：

1. 获取HTML内容时，用get_payload(decode=True)自动解码quoted-printable编码的内容
2. 用BeautifulSoup完成超链接添加后，将新HTML重新编码为quoted-printable格式
3. 确保邮件部分的Content-Transfer-Encoding头保持正确

修改后的代码片段 #

# 替换原有的HTML处理循环
for part in mmsg.walk():
    if part.get_content_type() == 'text/html':
        # 解码quoted-printable内容为UTF-8字符串
        decoded_html = part.get_payload(decode=True).decode('utf-8')
        soup = BeautifulSoup(decoded_html, features='lxml')
        
        # 添加目标超链接
        linkTag = soup.new_tag('a', href='http://testurl.com')
        linkTag.append("testurl text")
        soup.body.insert(0, linkTag)
        
        # 重新编码为quoted-printable格式
        from email.utils import quote
        encoded_html = quote(str(soup), charset='utf-8')
        part.set_payload(encoded_html)
        # 强制设置编码头，避免格式混乱
        part.set('Content-Transfer-Encoding', 'quoted-printable')

额外注意事项 #

• 若需兼容多种编码的邮件（如base64），可先通过part.get('Content-Transfer-Encoding')判断编码类型，再选择对应解码/编码方式
• 使用email.utils.quote做quoted-printable编码比手动处理更可靠，能自动处理所有特殊字符转义
• 插入新邮件时尽量保留原邮件的所有头部信息，减少Gmail因格式异常过滤内容的概率

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