Python实现Outlook特定发件人邮件转发：查询结果为0问题排查

一、初始代码的AttributeError: <unknown>.Sender错误解决 #

初始代码遍历收件箱所有项目时，会遇到非邮件类型的对象（比如会议邀请、任务通知等），这些对象没有Sender属性，因此触发属性错误。

解决方案： #

遍历前先筛选出仅邮件类型的项目，Outlook中MailItem的类编号为43，或通过MessageClass指定仅处理普通邮件：

import win32com.client

outlook = win32com.client.Dispatch("Outlook.Application").GetNamespace("MAPI")
inbox = outlook.GetDefaultFolder(6) # "6" 对应收件箱
messages = inbox.Items

sender_email = "TDC@AE.Roco.COM"
recipient_email = "simple.invoice@net"

# 仅筛选普通邮件类型
messages = messages.Restrict("[MessageClass] = 'IPM.Note'")

for message in messages:
    try:
        # 部分特殊邮件可能无法获取Sender，添加异常捕获
        if message.Sender.Address == sender_email:
            new_mail = message.Forward()
            new_mail.Recipients.Add(recipient_email)
            # 邮件转发会自动携带原附件，无需手动添加
            new_mail.Save()
    except Exception as e:
        print(f"处理邮件时出错: {e}")

二、Restrict查询无结果的问题解决 #

修改后的代码查询无结果，核心原因是查询字段选择错误和查询逻辑不规范：

1. urn:schemas:httpmail:from存储的是"发件人名称 <邮箱地址>"的完整格式，直接匹配纯邮箱会失败；
2. 需要使用专门存储发件人邮箱的MAPI属性，比如PR_SENDER_EMAIL_ADDRESS（对应标签0x0C1F001E）；
3. Restrict查询前必须对Items集合排序，否则筛选逻辑可能失效；
4. hasattachment的取值应为整数0或1，而非字符串。

修正后的查询代码： #

import win32com.client

outlook = win32com.client.Dispatch("Outlook.Application")
mapi = outlook.GetNamespace("MAPI")
inbox = mapi.GetDefaultFolder(6)

sender_email = "TDC@AE.Roco.COM"
# 使用可靠的发件人邮箱字段，hasattachment用整数取值
query = f'@SQL="http://schemas.microsoft.com/mapi/proptag/0x0C1F001E" = \'{sender_email}\' AND "urn:schemas:httpmail:hasattachment" = 1'

print(query)

try:
    items = inbox.Items
    # Restrict前必须排序，否则筛选可能不生效
    items.Sort("[ReceivedTime]", True)
    filtered_items = items.Restrict(query)
    print(f'收件箱中找到符合条件的邮件数: {filtered_items.Count}')

    # 递归检查子文件夹
    def check_subfolders(folder):
        folder_items = folder.Items
        folder_items.Sort("[ReceivedTime]", True)
        filtered_folder_items = folder_items.Restrict(query)
        if filtered_folder_items.Count > 0:
            print(f'{folder.name} 中找到 {filtered_folder_items.Count} 封符合条件的邮件')
        for subfolder in folder.Folders:
            check_subfolders(subfolder)

    check_subfolders(inbox)

    # 处理筛选出的邮件
    for item in filtered_items:
        mail = item.Forward()
        mail.Recipients.Add("simple.invoice@net")
        mail.Subject = f"Fwd: {item.Subject}"
        mail.Body = "请查收转发的带附件邮件：\n\n" + item.Body
        mail.Save()
except Exception as e:
    print(f'发生错误: {e}')

关键说明： #

• 强制排序：Outlook的Restrict方法依赖Items集合的排序规则，未排序时筛选结果可能为空；
• 字段可靠性：PR_SENDER_EMAIL_ADDRESS是直接存储发件人邮箱的底层属性，比httpmail系列字段更稳定；
• 语法规范：SQL查询语句中注意引号转义，避免语法错误。

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