使用MailKit认证时抛出ImapProtocolException: 'invalid digest response'的原因？

问题复现 #

使用MailKit的ImapClient连接并认证用户时，执行以下代码抛出MailKit.Net.Imap.ImapProtocolException: 'invalid digest response'异常：

client.Connect(host, port, useSsl); 
client.Authenticate(username, password);

旧版本（如2.0.1）可正常完成认证，IsAuthenticated属性为true，但4.0.1版本的认证流程会因该异常中断。

解决办法 #

1. 强制指定兼容的认证机制 #

新版本MailKit默认优先尝试的认证机制可能与你的邮件服务器不兼容，可手动指定服务器支持的认证方式（比如PLAIN或LOGIN）：

client.Connect(host, port, useSsl);
// 强制使用PLAIN认证
client.Authenticate(new SaslMechanismPlain(username, password));
// 或者使用LOGIN认证
// client.Authenticate(new SaslMechanismLogin(username, password));

2. 先查看服务器支持的认证机制 #

可以先获取服务器支持的所有认证方式，再选择匹配的机制：

client.Connect(host, port, useSsl);
// 打印服务器支持的认证机制列表
foreach (var mechanism in client.AuthenticationMechanisms)
    Console.WriteLine(mechanism);
// 根据输出结果选择对应的SaslMechanism实现进行认证

3. 临时回退到旧版本（应急方案） #

如果上述方法无法快速解决问题，可暂时回退到2.0.1版本维持业务运行，同时排查邮件服务器的认证配置，或向MailKit官方提交问题反馈。

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