如何使用Python exchangelib v4.5.1通过类Django语法对author或sender字段进行筛选？

我之前也踩过这个坑！exchangelib的filter()虽然模仿了Django的语法，但它不支持像Django那样跨对象的双下划线字段查询——比如author__name这种写法，本质是因为Exchange的EWS API本身就不允许对嵌套对象（比如Mailbox类型的author/sender）的属性直接做服务器端筛选。下面给你具体的解决思路：

1. 直接筛选邮箱地址（推荐，服务器端筛选，效率高） #

EWS支持直接对发件人/作者的邮箱地址做筛选，exchangelib提供了对应的字段，不用绕弯子：

# 按发件人邮箱地址精确匹配
my_account.inbox.filter(sender_email_address="foo@example.com")

# 按作者邮箱地址模糊匹配（用__contains）
my_account.inbox.filter(author_email_address__contains="foo")

2. 按姓名筛选（只能本地过滤） #

如果一定要按姓名筛选，因为EWS不支持服务器端对Mailbox.name做查询，只能先拉取邮件，再在本地过滤：

# 筛选发件人姓名包含"Foo"的邮件（注意处理sender为None的情况）
matching_emails = [
    msg for msg in my_account.inbox.all()
    if msg.sender and msg.sender.name and "Foo" in msg.sender.name
]

# 或者用filter函数，适合处理大量数据时的惰性遍历
matching_emails = filter(
    lambda m: m.sender and m.sender.name and "Foo" in m.sender.name,
    my_account.inbox.all()
)

这里一定要判断msg.sender和msg.sender.name不为空，避免触发AttributeError。

3. 为什么直接用sender字段没结果？ #

你直接写my_account.inbox.filter(sender=...)的时候，exchangelib要求你传入一个完整的Mailbox对象，而不是字符串。比如：

from exchangelib import Mailbox

# 这种写法是有效的，但需要精确匹配Mailbox的属性
target_sender = Mailbox(email_address="foo@example.com", name="Foo Bar")
my_account.inbox.filter(sender=target_sender)

但这种方式实用性很低，因为你需要完全匹配Mailbox的所有属性，不如直接用邮箱地址字段方便。

关于报错的原因 #

你遇到的InvalidField: Unknown field path 'author__name'，是因为exchangelib的双下划线语法只用来表示字段的操作符（比如__contains、__eq），而不是像Django那样用来遍历对象关系。Exchange的EWS API根本没有提供查询author.name这种嵌套属性的接口，所以这种写法自然会报错。

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