使用Python imaplib获取iCloud邮件时RFC822无法正常返回内容

问题场景 #

使用Python的imaplib库连接iCloud IMAP服务器，尝试用(RFC822)获取完整邮件内容时，返回结果为空（如[b'1 ()']）；但改用((BODY.PEEK[HEADER.FIELDS (SUBJECT)]))能正常获取邮件主题。调整打印逻辑为data[0][1]时，输出ASCII码为32的空格字符。

用户代码：

import imaplib

imap_host = 'imap.mail.me.com'
imap_user = 'user@icloud.com'
imap_pass = 'password'

M = imaplib.IMAP4_SSL(imap_host)
M.login(imap_user, imap_pass)

# Select folder named Google
M.select('Google')

typ, data = M.search(None, 'ALL')

for num in data[0].split():
    typ, data = M.fetch(num, "(RFC822)")
    print('Message %s: %s' % (num, data))


M.close()
M.logout()

执行输出：

Message b'1': [b'1 ()']
Message b'2': [b'2 ()']
Message b'3': [b'3 ()']
Message b'4': [b'4 ()']

解决方案 #

1. 更换Fetch命令为BODY.PEEK[RFC822] #

iCloud的IMAP服务器对RFC822命令的响应存在兼容性问题，改用BODY.PEEK[RFC822]可以稳定获取完整邮件内容，同时不会将邮件标记为已读（避免干扰邮箱的已读状态）。

2. 处理分段返回的邮件内容 #

imaplib会将较大的邮件拆分为多个数据块返回，需要手动拼接这些块才能得到完整的邮件内容。

3. 使用iCloud App专用密码 #

如果你的iCloud账号开启了两步验证，必须使用App专用密码而非主密码登录IMAP，否则可能出现权限受限（能获取主题但无法获取完整内容）。

修改后的代码示例 #

import imaplib

imap_host = 'imap.mail.me.com'
imap_user = 'user@icloud.com'
# 替换为你的iCloud App专用密码
imap_pass = 'your_app_specific_password'

M = imaplib.IMAP4_SSL(imap_host)
M.login(imap_user, imap_pass)

# 以只读模式选择文件夹，防止误操作修改邮件状态
M.select('Google', readonly=True)

typ, data = M.search(None, 'ALL')

for num in data[0].split():
    # 使用BODY.PEEK[RFC822]获取完整邮件内容
    typ, msg_parts = M.fetch(num, '(BODY.PEEK[RFC822])')
    # 拼接所有分段的内容块
    full_msg = b''.join(part[1] for part in msg_parts if isinstance(part, tuple))
    # 解码为字符串（用errors="replace"处理编码异常）
    print(f'Message {num.decode()}: {full_msg.decode("utf-8", errors="replace")}')

M.close()
M.logout()

额外说明 #

• 输出32的原因：原代码中data[0]是b'1 ()'，data[0][1]对应字符是空格（ASCII码32），本质是因为原Fetch命令未返回任何邮件内容。
• 只读模式：select时添加readonly=True可以避免在操作过程中意外修改邮件的已读/未读状态。

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