Python imaplib 怎样以只读方式选择邮箱

如果脚本只是统计收件箱、读取邮件头或抓取某类邮件，选择邮箱时最好显式传入 readonly=True。Python 的 imaplib.IMAP4.select() 会把当前邮箱以只读方式选中，后续可以继续做搜索和读取，但不会允许对这个已选邮箱执行修改标记、删除等操作。

官方地址：https://docs.python.org/3/library/imaplib.html

最小写法是 client.select("INBOX", readonly=True)。它保护的是当前选中邮箱的写操作，不是把整个 IMAP 账号变成只读账号；连接仍需正常认证，其他客户端也可能改变邮箱状态。

先把连接和邮箱选择分成两件事

我在做收件箱巡检时，通常先把 TLS、登录和邮箱选择拆开看。这样一旦结果不符合预期，可以判断是连接失败、认证失败，还是邮箱没有按只读模式打开。IMAP4_SSL 默认使用 993 端口；生产代码应显式传入 ssl.create_default_context()，让证书和主机名校验按标准上下文执行。

import imaplib
import os
import ssl

# 读取环境变量，避免把邮箱密码写进源码
host = os.environ["IMAP_HOST"]
user = os.environ["IMAP_USER"]
password = os.environ["IMAP_PASSWORD"]

# 上下文管理器退出时会发送 LOGOUT，并释放连接
with imaplib.IMAP4_SSL(
    host=host,
    timeout=15,
    ssl_context=ssl.create_default_context(),
) as client:
    # 登录只负责认证，邮箱是否只读由 select 的参数决定
    client.login(user, password)

    # readonly=True 让当前选中的 INBOX 不接受修改操作
    status, data = client.select("INBOX", readonly=True)
    if status != "OK":
        raise RuntimeError(f"选择邮箱失败: {status} {data!r}")

    # EXISTS 响应通常放在 data[0]，这里只读取数量，不修改邮件
    exists = int(data[0] or b"0")
    print(f"当前邮箱邮件数: {exists}")

这里的关键不是把参数写成字符串，而是把 readonly=True 传给 select。返回值通常是 ("OK", [b"数量"])，但网络服务的响应仍应先检查状态码，再读取数据。

只读模式允许什么，不允许什么

只读选择不会阻止所有 IMAP 命令。像 SEARCH、FETCH 和基于 UID 的读取仍然可以使用，适合做归档索引、主题统计和邮件内容抽取。相反，STORE 会改动邮件标记，EXPUNGE 会永久清理带删除标记的邮件，这些都不应放在只读邮箱的处理路径中。

还要注意，IMAP 的消息序号会随着邮箱变化而重新编号。Python 官方文档建议在需要长期引用邮件时优先使用 UID；只读模式解决“不要改动邮箱”，UID 解决“不要依赖易变的序号”，两者是不同问题。

# 只读路径：可以查找并读取，不改变邮件状态
status, data = client.search(None, "UNSEEN")
if status != "OK":
    raise RuntimeError(f"搜索失败: {data!r}")

for message_id in data[0].split():
    # 使用 UID 获取邮件，避免普通序号因 EXPUNGE 或并发变化而失效
    fetch_status, payload = client.uid("FETCH", message_id, "(BODY.PEEK[HEADER])")
    if fetch_status != "OK":
        raise RuntimeError(f"读取邮件失败: {message_id!r}")

# 下面这些命令属于修改路径，不应在 readonly=True 的连接里调用
# client.store(message_id, "+FLAGS", "\\Seen")
# client.expunge()

BODY.PEEK 的意图也是尽量避免因为读取正文而改变已读标记，但服务器能力和客户端实现仍需按实际协议响应处理。只读选择是第一道边界，读取命令本身也要选择不会产生副作用的参数。

遇到 readonly 异常时怎样判断

readonly=True 是选择邮箱时的请求。如果服务器后来改变了邮箱的可写状态，imaplib.IMAP4.readonly 异常会提示需要重新打开邮箱。它不是“代码没有传参数”的证明，而是服务器端权限或并发客户端状态发生了变化。

1. 先记录命令阶段。区分连接、登录、select、search 和 fetch，避免把认证错误误判为只读错误。
2. 保留原始状态码。不要只打印“邮箱为空”；NO、BAD 和空数据的含义不同。
3. 重新建立连接再选择。遇到 IMAP4.abort 或 IMAP4.readonly 时，关闭当前实例并重新连接通常比继续复用旧状态更稳妥。
4. 把写操作移出巡检脚本。如果业务确实需要标记已读或删除，应使用独立的可写流程、明确的权限和审计记录。

适合采用的场景与相关问题

只读选择适合报表、监控、索引、备份前扫描和邮件内容抽取等场景，尤其适合多个任务共享一个邮箱时降低误操作风险。它不替代账号权限控制，也不能阻止同一邮箱上的其他客户端写入。

readonly=True 会让 login 也变成只读吗？

不会。它只影响随后通过 select 选中的邮箱。登录仍然是普通认证，账号本身是否有写权限由服务器和账号策略决定。

只读模式下能不能搜索和读取邮件？

可以。SEARCH、FETCH 和 UID 读取仍是典型用途，但应检查每次命令的返回状态，并优先选择不会改变标记的读取参数。

为什么还要使用 UID？

邮箱发生删除或并发变化时，普通消息序号可能重新排列。UID 用于稳定引用邮件，解决的是定位可靠性，不等同于只读保护。

来源说明：正文中的 API 行为、异常边界、端口和 UID 建议依据 Python 官方 imaplib 文档整理；文章示例只展示结构和处理方式，不代表在某个真实邮箱上执行过。