使用exchangelib listener获取最新邮件时的代码执行异常问题

问题场景 #

使用exchangelib的Listener监听新邮件时，触发NewMailEvent后，事件处理函数中无法打印收件箱最新计数，也无法获取到刚收到的邮件主题。原代码及运行结果如下：

原代码

creds = Credentials(
    username="domaine\user", 
    password="password"
)
def main():
    print("started !")
    config = Configuration(server='server', credentials=creds)

    account = Account(
        primary_smtp_address="mail",
        autodiscover=False, 
        config=config,
        access_type=DELEGATE,
        default_timezone=UTC
    )

    listener = Listener(account)

    print(account.inbox.all().count())

    def new_messaged_received():
        print("---------------------------------new mail arrived----------------------------------------------");
        for item in account.inbox.all().only('subject').order_by('-datetime_received')[:1]:
            print(item.subject) 

    listener.streaming_event_received += new_messaged_received
    listener.listen(NewMailEvent)

运行结果

7503
---------------------------------new mail arrived----------------------------------------------

问题原因 #

Exchange的NewMailEvent触发时机是邮件进入收件箱的通知，但此时邮件可能尚未完全写入Exchange数据库，直接查询收件箱会出现同步延迟，导致无法获取到刚触发通知的邮件。

解决方案 #

方案1：添加延迟确保邮件写入

在事件处理函数中添加短暂延迟，等待Exchange完成邮件存储后再执行查询：

import time

def new_messaged_received():
    print("---------------------------------new mail arrived----------------------------------------------")
    # 等待2秒让Exchange完成邮件持久化
    time.sleep(2)
    # 打印最新收件箱计数
    print(account.inbox.all().count())
    # 获取并打印最新邮件主题
    for item in account.inbox.all().only('subject').order_by('-datetime_received')[:1]:
        print(item.subject)

方案2：通过事件对象直接获取邮件（推荐）

streaming_event_received的回调函数可以接收事件参数，通过事件携带的item_id直接定位到目标邮件，完全避免查询延迟问题：

def new_messaged_received(event):
    print("---------------------------------new mail arrived----------------------------------------------")
    # 打印最新收件箱计数
    print(account.inbox.all().count())
    # 通过事件中的item_id直接获取邮件
    if hasattr(event, 'item_id'):
        mail = account.inbox.get(id=event.item_id)
        print(mail.subject)

注意：绑定回调时无需修改，exchangelib会自动传递事件参数到回调函数中。

额外提示 #

• 确保使用最新版本的exchangelib，旧版本可能存在事件与数据同步的兼容性问题。
• 检查账号权限，确保拥有收件箱的读取权限。

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