### 解决 Python IMAPLIB 163 邮箱错误 'command SEARCH illegal in state AUTH' 当尝试通过 `IMAP` 协议访问网易邮箱 (163.com) 并执行搜索命令时，可能会遇到如下异常： ```plaintext imaplib.error: command SEARCH illegal in state AUTH, only allowed in states SELECTED ``` 该错误表明当前连接状态不允许执行 `SEARCH` 命令。根据协议规定，在未进入 `SELECTED` 状态之前，无法执行某些特定操作。 为了成功检索邮件列表并避免上述错误，应当遵循以下流程来建立与服务器的安全会话，并切换到适当的工作模式[^1]。 #### 正确的 IMAP 连接过程 以下是修正后的代码片段用于安全地连接至 163 邮件服务并获取收件箱中的消息摘要: ```python import imaplib from typing import List def fetch_emails(username: str, password: str) -> List[str]: mailbox = imaplib.IMAP4_SSL('imap.163.com') try: rv, data = mailbox.login(username, password) if rv != 'OK': raise Exception(f"Failed to log in {rv}") # Select the mailbox you want to use, by default "INBOX" status, messages = mailbox.select("INBOX") if status != 'OK': raise Exception("Cannot select mailbox") result, data = mailbox.search(None, "ALL") email_ids = [] if isinstance(data[0], bytes): email_ids.extend(data[0].split()) return email_ids finally: mailbox.logout() ``` 这段程序首先创建了一个加密 SSL 的 IMAP 客户端实例并与指定主机名通信；接着验证账户凭证的有效性；随后选择要操作的具体文件夹（默认为 INBOX），这一步骤至关重要因为它将客户端的状态转换到了允许进一步查询和管理的操作环境内；最后才调用了 `search()` 方法查找符合条件的消息编号集合[^2]. 值得注意的是，如果希望关闭已打开的邮箱而不退出整个会话，则应在完成所有必要的读写活动之后再发出 `close()` 请求而不是立即这样做，因为后者同样受限于工作区的选择情况[^4].