使用exchangelib发送邮件遇认证参数错误及服务器兼容问题

问题背景 #

使用exchangelib编写邮件脚本时，调用Credentials传入auth_method='ntlm'触发TypeError；替换为auth_type='ntlm'仍报错；移除参数则提示"Exchange服务器授权错误：服务器未报告兼容的认证类型"。

解决方案 #

1. 修正认证参数并匹配exchangelib版本 #

exchangelib v3.0+版本中，Credentials类的认证方式参数已从auth_method改为auth_type，正确参数值为'ntlm'。但仅修改参数不足以解决问题，需配合服务器手动配置。

2. 关闭自动发现，手动指定Exchange服务器 #

政府类Exchange服务器通常禁用autodiscover服务，需手动指定服务器地址及对应版本：

• 从配置文件读取服务器地址，提取基础服务器域名（去除OWA后缀）
• 初始化Account时关闭autodiscover，指定server和version参数

3. 补充NTLM认证所需域名前缀 #

NTLM认证通常要求用户名包含域名前缀（格式为DOMAIN\username），需确认你的Exchange账号是否需要添加域名。

修正后的完整代码 #

主文件代码：

import config
from exchangelib import Credentials, Account, DELEGATE, Exchange2016
from exchangelib.errors import UnauthorizedError, TransportError

# 若账号属于域环境，修改username为 'DOMAIN\Asdfgh' 格式
credentials = Credentials(
    username=config.exchange_username,
    password=config.exchange_password,
    auth_type='ntlm',  # 新版本exchangelib使用auth_type指定认证类型
)

# 手动配置Account，关闭自动发现
account = Account(
    primary_smtp_address=config.exchange_email,
    credentials=credentials,
    autodiscover=False,
    # 提取基础服务器地址（去除/owa/后缀）
    server=config.exchange_server.split('/owa/')[0],
    access_type=DELEGATE,
    version=Exchange2016,  # 根据实际服务器版本调整，如Exchange2019等
)

关键说明 #

• 服务器地址处理：配置文件中的exchange_server是OWA访问地址，需提取基础服务器域名（如https://some.mail.gov）
• Exchange版本：需根据服务器实际版本调整，常见可选值包括Exchange2013、Exchange2016、Exchange2019
• 域名前缀：域环境下必须添加域名前缀，否则NTLM认证会直接失败

测试验证 #

1. 确认服务器地址、用户名（含域名）、密码均正确
2. 运行代码尝试连接，若仍报错，检查服务器是否允许外部IP访问，或是否需要配置代理

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