IMAP连接报错Address not supported by protocol 如何排查解决？

• 最常见诱因是远程主机禁用了IPv6协议栈，但imap-mail.outlook.com的DNS解析结果优先返回IPv6地址，系统尝试使用IPv6建立连接时触发协议不支持报错
• 远程主机的安全组、防火墙规则封禁了*993端口（IMAP SSL默认端口）*的出站连接，或系统配置的代理规则不兼容SSL加密的IMAP连接
• 远程主机的Python版本、系统底层libc库存在兼容性BUG，对双栈域名的地址处理逻辑异常
• 远程主机的hosts文件存在imap-mail.outlook.com的错误映射，指向了格式非法的IP地址

• 强制指定连接使用IPv4，修改连接代码指定IPv4的源地址参数即可：

import imaplib
# 0.0.0.0 代表强制使用IPv4地址建立连接
imap = imaplib.IMAP4_SSL("imap-mail.outlook.com", port=993, source_address=("0.0.0.0", 0))
imap.login(username, password)
imap.select("INBOX")

也可以提前在远程主机执行nslookup imap-mail.outlook.com获取解析到的IPv4地址，直接把域名替换为IPv4地址使用。

• 先验证网络连通性，在远程主机执行命令nc -zv imap-mail.outlook.com 993，如果返回连接失败，联系运维开通993端口的出站访问权限，检查系统代理配置是否需要同步给Python运行环境。
• 升级远程主机的Python版本到3.8及以上的稳定版，更新系统底层依赖库修复兼容问题。
• 检查远程主机的hosts配置，删除imap-mail.outlook.com的错误映射条目，也可以手动添加一条正确的IPv4映射记录。

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