批量标记删除旧邮件时触发imaplib.IMAP4.error错误求助

编写脚本批量标记并删除2023年1月1日前的旧邮件，初始运行正常，但标记约600封后触发错误。脚本代码如下：

# Import necessary modules.
import imaplib
import getpass
import time

# Gets users input.
username = input('Please input your Username: ') 

# Gets user's password - For most services this will need to be done through app passwords, which need to be enabled.
password = getpass.getpass() 

# Lets the user decide which folder to select emails from.
# For my use case it will be 'Inbox' first
email_folder = (input('Please select the folder you wish to have emails deleted from: ')).upper() 

# Allows the user to choose which email provider they use
email_host = input('Please input your email provider: ').strip()

# Makes a call to the email service based on users input.
email_provider_imap = f'imap.{email_host.strip()}'

# A function that will mark and delete emails, Will loop 25 times.
# I did it this way because Imaplib only allows access to 1000 emails at a time per login. 

def delete_these(user, creds, email_provider):
    x = 0
    while x < 26:
        # Creates the imap4 class with SSL 
        imap = imaplib.IMAP4_SSL(email_provider)

        # Logs the user in 
        imap.login(user, creds)
        print('logged in!')
        
        # From user input will select the folder containing the Emails to be deleted.
        imap.select(email_folder)

        # Gets emails from the inbox and stores them as user id's, Identifies emails from before Janurary 1st 2023
        _, emails_to_delete = imap.search(None, 'BEFORE "01-JAN-2023"')
        
        # Declares emails_to_delete as a list that can be iterated over by splitting Email id's
        emails_to_delete = emails_to_delete[0].split()
        
        # This for loop iterates through and marks the emails for deletion
        for mail in emails_to_delete:
            imap.store(mail, '+FLAGS', '\\Deleted')
            print('Deleting emails marked for deletion: ', mail)
        print('Loop complete!')
        # Removes the Emails
        imap.expunge()

        # Closes the email
        imap.close()

        # Logs the user out to avoid raising an error from trying to use imap.search() multiple times.
        imap.logout()
        print('Logged out!')

        # Sleeps the function for a 10 seconds
        time.sleep(10)

        # Increases x by 1 so that there is no accidental infinite loop
        x += 1

# calls the function for execution
delete_these(username, password, email_provider_imap)

报错信息：

Deleting emails marked for deletion:  b'9379'
Traceback (most recent call last):
  File "c:\Users\Marcin Malek\Desktop\handle_emails\del_emails.py", line 49, in <module>
    delete_these(username, password, email_provider_imap)
  File "c:\Users\Marcin Malek\Desktop\handle_emails\del_emails.py", line 39, in delete_these
    imap.store(mail, '+FLAGS', '\\Deleted')
  File "C:\Users\Marcin Malek\AppData\Local\Programs\Python\Python311\Lib\imaplib.py", line 851, in store
    typ, dat = self._simple_command('STORE', message_set, command, flags)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Marcin Malek\AppData\Local\Programs\Python\Python311\Lib\imaplib.py", line 1230, in _simple_command
    return self._command_complete(name, self._command(name, *args))
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\Marcin Malek\AppData\Local\Programs\Python\Python311\Lib\imaplib.py", line 1055, in _command_complete
    raise self.error('%s command error: %s %s' % (name, typ, data))
imaplib.IMAP4.error: STORE command error: BAD [b'[CLIENTBUG] STORE Bad sequence in the command']

尝试对接谷歌、雅虎邮箱，期望脚本完成循环后正常退出，寻求报错解决方法。

1. 错误原因 #

[CLIENTBUG] STORE Bad sequence in the command 是因为传入了无效的邮件序号：

• 每次删除邮件后，后续邮件的序号会前移，但脚本仍用旧序号执行STORE操作，导致序号无效。
• 逐个调用STORE命令效率极低，容易触发服务商请求限制，引发异常。

2. 具体修复方案 #

(1) 批量执行STORE命令 #

IMAP支持批量指定邮件ID，用逗号拼接ID列表一次性标记，减少请求次数：

# 替换原有的for循环
if emails_to_delete:
    # 将字节类型的ID转成字符串后拼接
    mail_ids = ','.join(mail.decode('utf-8') for mail in emails_to_delete)
    imap.store(mail_ids, '+FLAGS', '\\Deleted')
    print(f'Marked {len(emails_to_delete)} emails for deletion')

(2) 限制单次处理邮件数量 #

每次登录后只处理固定数量的邮件（比如500封），避免序号混乱：

# 搜索后截取前500个ID
emails_to_delete = emails_to_delete[0].split()[:500]

部分服务商（如Gmail）支持LIMIT参数直接限制搜索结果：

_, emails_to_delete = imap.search(None, 'BEFORE "01-JAN-2023"', 'LIMIT 500')

(3) 优化登录逻辑，避免频繁登退 #

原脚本每次循环重新登录，效率低且易触发限制，改为一次登录内循环处理直到无邮件可删：

def delete_these(user, creds, email_provider):
    imap = imaplib.IMAP4_SSL(email_provider)
    imap.login(user, creds)
    print('Logged in!')
    imap.select(email_folder)
    
    while True:
        _, emails_to_delete = imap.search(None, 'BEFORE "01-JAN-2023"')
        emails_to_delete = emails_to_delete[0].split()
        if not emails_to_delete:
            print('No more old emails to delete.')
            break
        
        # 单次处理500封
        batch = emails_to_delete[:500]
        mail_ids = ','.join(m.decode('utf-8') for m in batch)
        imap.store(mail_ids, '+FLAGS', '\\Deleted')
        print(f'Marked {len(batch)} emails for deletion')
        
        imap.expunge()
        print('Expunged marked emails')
        time.sleep(2)  # 增加延迟，避免请求过快
    
    imap.close()
    imap.logout()
    print('Logged out!')

(4) 统一处理字节类型ID #

原脚本中邮件ID是字节类型，部分服务商要求字符串类型，需解码后使用：

mail_ids = ','.join(mail.decode('utf-8') for mail in emails_to_delete)

3. 额外注意事项 #

• 谷歌、雅虎等开启两步验证的邮箱，必须使用应用专用密码登录，普通密码无法通过IMAP验证。
• 测试时先注释imap.expunge()，仅标记邮件确认无误后再执行删除，避免误删。
• 部分服务商对日期格式敏感，若01-JAN-2023报错，可尝试小写月份01-Jan-2023。

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