使用poplib调用LIST/STAT命令遇GMAIL POP3服务器报错的问题求助

使用Python的poplib库连接Gmail POP3服务器时，发送LIST/STAT命令会收到-ERR Command not understood错误，但同一邮箱通过TELNET执行这些命令却能正常运行。最初怀疑是Gmail端的问题，但手动通过TELNET登录并检索消息后，确认问题出在代码或库的实现层面。已在多个平台求助多日未得到有效解决方案。

失败的可复现代码 #

import poplib
mail_box = poplib.POP3_SSL(SERVER, PORT)
mail_box.set_debuglevel(2)
mail_box.user(USER)
mail_box.pass_(PASSWORD)
mail_box.list()[1]

相关截图 #

• 失败代码输出截图：
• 成功手动TELNET测试截图：

关联cpython GitHub Issue（编号94019）内容翻译 #

该Issue中用户反馈了完全相同的问题：使用poplib.POP3_SSL连接Gmail POP3服务器时，LIST、STAT等命令返回-ERR Command not understood错误，但TELNET操作一切正常。经初步排查发现，问题根源可能是poplib库发送命令的格式不符合Gmail POP3服务器的预期——Gmail对命令的换行符格式或发送机制有特殊要求，而poplib的默认实现未满足这一要求。

排查与解决方向 #

1. 修改命令换行格式
   Gmail POP3服务器可能仅接受以LF结尾的命令，而poplib默认使用CRLF作为换行符。可以通过继承POP3_SSL类重写命令发送逻辑：

import poplib

class CustomPOP3_SSL(poplib.POP3_SSL):
    def _putline(self, line):
        # 将默认的CRLF替换为LF
        line = line.rstrip(b'\r\n') + b'\n'
        self.sock.sendall(line)

# 使用自定义类建立连接
mail_box = CustomPOP3_SSL(SERVER, PORT)
mail_box.set_debuglevel(2)
mail_box.user(USER)
mail_box.pass_(PASSWORD)
mail_box.list()[1]

2. 检查Gmail账户设置
   确保Gmail账户已正确开启POP3服务，并且在设置中选择了“对所有邮件启用POP（包括已下载的邮件）”选项，避免因服务器端配置导致命令被拒绝。

3. 切换至IMAP协议
   如果POP3问题无法快速解决，可考虑使用Gmail支持的IMAP协议，通过Python的imaplib库实现邮件检索，IMAP功能更完善且兼容性更好。

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