Python解码Gmail API消息时出现binascii.Error: Incorrect padding问题

问题原因 #

Gmail API返回的Base64数据是URL安全变体，和标准Base64存在两处差异：

• 将标准Base64中的+替换为-，/替换为_
• 可能省略了末尾用于长度对齐的填充字符=

直接用base64.b64decode解码这种非标准格式时，就会触发binascii.Error: Incorrect padding异常。部分消息片段能成功解码，只是因为它们的长度刚好是4的整数倍，或者未包含需要替换的特殊字符。

解决方案 #

先将URL安全Base64转换为标准Base64格式，再执行解码操作：

具体步骤 #

1. 替换特殊字符：把-换回+，_换回/
2. 补充填充字符：计算需补充的=数量，确保字符串长度为4的整数倍
3. 执行解码：用标准Base64解码方法处理转换后的字符串

完整代码示例 #

import base64

def decode_gmail_base64(encoded_data):
    # 转换为标准Base64格式
    standard_b64 = encoded_data.replace('-', '+').replace('_', '/')
    # 计算并补充必要的填充字符
    padding_count = (4 - len(standard_b64) % 4) % 4
    standard_b64 += '=' * padding_count
    # 执行解码
    return base64.b64decode(standard_b64)

# 原业务代码改造后
message = self.service.users().messages().get(
    userId=user_id,
    id=message_id,
    format=message_format,
).execute()

# 解码之前报错的消息部分
decoded_content = decode_gmail_base64(message["payload"]["parts"][0]["body"]["data"])

验证说明 #

该方法兼容所有Gmail API返回的Base64数据，无论是消息主体还是附件内容，都能避免padding异常，完成正确解码。

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