Python mailbox.mbox 修改后为什么还要 flush 和 unlock

Python mailbox.mbox 修改后要把 flush() 和 unlock() 看成两个不同的收尾动作：前者把邮箱对象中尚未写出的变更刷新到文件，后者释放对 mbox 文件的排他锁。只调用其中一个，都可能留下“数据没落盘”或“锁一直占用”的问题。

Python 官方文档地址：https://docs.python.org/3/library/mailbox.html

先分清变更、落盘和锁的三个职责

排查 mbox 文件“明明改了却看不到”的场景时，最容易混淆的是三个状态：消息对象是否已经修改、修改是否已经写入单文件邮箱、其他进程是否还被锁挡住。get_message() 得到的是一个消息表示，修改这个表示后还要通过 box[key] = msg 写回邮箱对象；写回并不等于完成所有文件 I/O。

mbox 把多封邮件放在同一个文件中，写入过程不能只按“改了一个对象”理解。lock() 保护的是修改期间的排他访问；flush() 处理的是邮箱对象保留的待写变更；unlock() 负责让其他协作者重新获得访问机会。它们分别对应保护、持久化和协作边界。

用锁保护一次 mbox 修改

下面的示例只演示修改一封邮件主题后的收尾方式。它不运行示例，也不假设本地文件一定存在；finally 中的关闭动作负责把资源释放放在异常路径上。

import mailbox

def update_subject(mbox_path, key, subject):
    # mbox 是单文件邮箱，修改前先取得排他锁。
    box = mailbox.mbox(mbox_path, create=False)
    locked = False
    try:
        box.lock()
        locked = True
        msg = box.get_message(key)
        msg["Subject"] = subject
        # 消息对象是当前邮箱的表示，显式写回同一个 key。
        box[key] = msg
        # 将邮箱对象中待写的变更刷新到 mbox 文件。
        box.flush()
    finally:
        if locked:
            # 先确保文件完成刷新，再让其他进程重新访问。
            box.unlock()
        box.close()

这里的关键不是“调用次数”，而是职责顺序。先锁定，再读取和写回；写回后刷新；刷新完成后解锁。若 get_message()、赋值或刷新抛出异常，finally 仍会尝试释放已经取得的锁。

真实项目中还应区分“找不到 key”“权限不足”和“锁不可用”等异常，让调用方知道本次修改是否根本没有开始。不要在捕获异常后无条件报告成功，也不要把失败的写回当成空邮箱。

为什么修改后要 flush 再 unlock

flush() 的含义是写出邮箱对象尚未落到文件系统的变化。对某些邮箱格式它可能没有额外动作，但官方接口仍建议形成调用习惯。对 mbox 这类单文件格式，先完成刷新再释放锁，能让“其他进程获得锁时看到什么”更加明确。

如果只调用 unlock()，你释放了并发访问权，却没有表达“待写变化已经完成”。另一个进程可能在前一个修改尚未写完时打开文件，产生竞态。如果只调用 flush()，当前进程仍持有排他锁，后续读取者可能一直无法进入，尤其是异常路径或长生命周期对象更容易放大这个问题。

官方文档还说明，close() 会刷新邮箱、在需要时解锁，然后关闭打开的文件。因此能用上下文管理器时，可把生命周期交给它：

import mailbox

def add_message(mbox_path, message):
    # with 会在进入时加锁，在退出时完成 close 收尾。
    with mailbox.mbox(mbox_path, create=True) as box:
        box.add(message)
        # close 会负责刷新待写变更并释放锁。

上下文管理器适合把“打开到关闭”限制在一个短作用域内。如果代码必须跨多个函数持有邮箱对象，就应明确谁负责 flush()、谁负责 unlock() 和 close()，避免不同层重复或遗漏收尾。

用 close 收尾并避开常见误区

第一，修改消息对象后忘记 box[key] = msg，即使调用了 flush() 也没有新的内容可写。第二，把 unlock() 当成保存按钮；它只处理锁，不替代写回和刷新。第三，拿 mbox 的单文件并发语义套到 Maildir：Maildir 的消息分散在目录中，flush() 和锁方法的行为不同，不能只凭方法名推断。

最后，锁保护的是一段修改过程，不是应用级事务快照。其他程序仍可能在你前后读取之间改变邮箱；如果业务要求稳定统计，应另行设计快照或协调策略。本文只回答本地 mbox 修改后的收尾问题，不把文件锁扩展成跨进程数据库事务。

常见问题

只调用 close，不手动调用 flush 和 unlock 可以吗？

可以，只要这个对象的生命周期由你明确管理，close() 会完成刷新、解锁和关闭。手动调用适合需要在关闭前明确表达阶段边界的代码。

flush 后还需要 unlock 吗？

需要。flush() 解决待写变更，unlock() 解决排他访问；除非随后立刻由 close() 统一收尾，否则两者不能互相替代。

为什么修改了 msg 但文件内容没有变化？

最常见原因是只改了 get_message() 返回的表示，没有通过同一个 key 写回邮箱。确认写回后，再安排刷新和解锁。