如何使用Python imaplib筛选含自定义头字段的邮件？

你的问题出在IMAP SEARCH命令的语法使用上，直接传入自定义头字段名和值不符合IMAP协议规范，正确的做法是使用HEADER关键字来指定头部搜索。

正确的服务器端筛选方法 #

IMAP协议中，搜索特定头部字段需要遵循SEARCH HEADER <header-name> <header-value>的格式，对应到imaplib的调用方式如下：

rv, data = mailbox.search(None, 'HEADER', 'X-my-header-field', 'my-header-value')

关键注意事项 #

• 语法要求：必须用HEADER作为搜索关键字，后续依次跟头部字段名和对应的值，这是IMAP协议规定的标准写法，之前的写法缺少HEADER关键字，所以无法被服务器识别。
• 大小写敏感性：部分IMAP服务器对头部字段名的大小写严格敏感，确保你传入的字段名和邮件实际携带的完全一致（比如X-My-Header-Field和x-my-header-field可能被视为不同字段）。
• 特殊值处理：如果头部值包含空格、引号等特殊字符，需要用双引号包裹值，例如：

  rv, data = mailbox.search(None, 'HEADER', 'X-my-header-field', '"my value with spaces"')
  

备选方案：服务器不支持自定义头搜索时的处理 #

有些IMAP服务器可能不支持对非标准自定义头的服务器端搜索，此时可以先获取邮件的目标头部字段内容，再在本地完成筛选（这会下载头部数据，但不会下载完整邮件内容，比下载全邮件高效）：

# 先获取所有邮件ID
rv, all_data = mailbox.search(None, 'ALL')
if rv == 'OK':
    for num in all_data[0].split():
        # 仅获取指定的自定义头字段
        rv, header_data = mailbox.fetch(num, '(BODY[HEADER.FIELDS (X-my-header-field)])')
        if rv == 'OK':
            # 解析头部内容
            header_content = header_data[0][1].decode('utf-8', errors='ignore')
            if 'X-my-header-field: my-header-value' in header_content:
                print(f"匹配到邮件ID: {num.decode()}")

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