调试imaplib错误：Yahoo邮箱SPAM文件夹搜索删除问题

先处理当前报错 #

你遇到的imaplib.IMAP4.error: command SEARCH illegal in state AUTH，本质是未成功选中目标文件夹，导致后续SEARCH命令无法执行。Yahoo邮箱的垃圾邮件文件夹默认名称不是SPAM，需要先确认正确标识。

第一步：获取Yahoo邮箱所有文件夹列表 #

运行以下代码，找到垃圾邮件对应的文件夹名称：

import imaplib

box = imaplib.IMAP4_SSL('imap.mail.yahoo.com', 993)
box.login("你的Yahoo邮箱地址","应用授权码")
# 列出所有文件夹
typ, folders = box.list()
for folder in folders:
    print(folder.decode())
box.logout()

输出结果中，Yahoo垃圾邮件文件夹通常为Junk（部分地区可能显示为中文垃圾邮件），记录下这个名称。

问题1：访问Yahoo邮箱非INBOX文件夹 #

确认文件夹名称后，使用box.select()选中目标文件夹，示例：

# 选中默认垃圾邮件文件夹Junk
box.select('Junk')

选中成功时，box.select()会返回('OK', [b'X'])（X为文件夹内邮件数量），此时即可执行后续搜索、删除操作。

问题2：用通配符搜索特定用户名@任意域名的邮件 #

IMAP协议的SEARCH命令支持前缀匹配，针对name@任意域名的需求，需将搜索条件用双引号包裹，确保通配符*生效，写法如下：

# 搜索发件人以name@开头的所有邮件
typ, data = box.search(None, 'FROM', '"name@*"')

修正后的完整可运行代码 #

import imaplib

# 配置信息
YAHOO_EMAIL = "你的Yahoo邮箱地址"
YAHOO_APP_PASSWORD = "你的应用授权码"  # 注意：Yahoo需用应用授权码，而非登录密码
TARGET_FOLDER = "Junk"  # 替换为你从文件夹列表中获取的正确名称
TARGET_SENDER_PREFIX = "name@"

# 连接IMAP服务器
box = imaplib.IMAP4_SSL('imap.mail.yahoo.com', 993)
box.login(YAHOO_EMAIL, YAHOO_APP_PASSWORD)

# 选中目标文件夹
select_status, _ = box.select(TARGET_FOLDER)
if select_status != 'OK':
    print(f"无法选中文件夹 {TARGET_FOLDER}，请检查名称是否正确")
    box.logout()
    exit()

# 搜索匹配邮件
search_status, data = box.search(None, 'FROM', f'"{TARGET_SENDER_PREFIX}*"')
if search_status != 'OK' or not data[0]:
    print("未找到匹配的邮件")
    box.close()
    box.logout()
    exit()

# 标记邮件为删除并执行删除操作
for num in data[0].split():
    box.store(num, '+FLAGS', '\\Deleted')
box.expunge()

# 关闭连接
box.close()
box.logout()
print("匹配的邮件已成功删除")

关键注意事项 #

• Yahoo邮箱需开启两步验证后生成应用授权码，不能直接用登录密码登录IMAP。
• 若搜索条件不生效，可检查IMAP服务器是否支持通配符匹配，部分场景可改用SUBSTRING语法实现前缀匹配。

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