Python MozillaCookieJar 怎样把 Cookie 保存到本地文件

如果你需要把 Python 客户端中的 Cookie 留到下一次运行，最直接的做法是使用 http.cookiejar.MozillaCookieJar：给它一个 cookies.txt 路径，在 Cookie 更新后调用 save()，下一次启动时调用 load()。它读写的是 Mozilla cookies.txt 格式，不是任意 JSON；默认不会保存会话 Cookie 和已经过期的 Cookie。

官方文档：https://docs.python.org/3/library/http.cookiejar.html

下面的示例只展示本地持久化和标准库接入方式。Cookie 文件属于敏感状态，示例使用项目目录下的占位文件名，不把真实登录 Cookie 写入代码或文章。

先区分内存 Cookie 和本地文件

CookieJar 负责在内存中保存 Cookie；MozillaCookieJar 是它的文件持久化子类，保存格式兼容 Mozilla 的 cookies.txt，也常见于 curl 或旧式浏览器 Cookie 文件。创建对象时传入的路径会成为默认保存位置，但文件不会因为构造对象就自动读取，必须显式调用 load() 或 revert()。

最小写法如下：

from pathlib import Path
from http.cookiejar import MozillaCookieJar

# 只保存文件位置；构造对象不会自动读取旧 Cookie
cookie_file = Path("cookies.txt")
jar = MozillaCookieJar(cookie_file)

# Cookie 被请求处理器更新后，再显式写入本地文件
jar.save()

这里的关键不是文件名，而是对象的类型：如果只使用普通 CookieJar，它没有直接落盘的格式实现；换成 MozillaCookieJar 后，save() 和 load() 才有 Mozilla 文件格式的具体行为。

save 的两个参数决定保存边界

save(filename=None, ignore_discard=False, ignore_expires=False) 默认使用构造对象时的文件名。默认值体现了一个安全的持久化边界：

• ignore_discard=False：不保存被标记为会话 Cookie 的条目。它们通常没有 expires 或 max-age。
• ignore_expires=False：不保存已经过期的 Cookie。
• 保存目标存在时会被覆盖，原文件中的 Cookie 不会自动合并进来。

如果业务确实需要把会话 Cookie 也写入文件，可以显式打开参数；这不是默认推荐值，因为它会延长短期状态的生命周期：

from http.cookiejar import MozillaCookieJar

jar = MozillaCookieJar("cookies.txt")

# 仅在明确需要保存会话状态时使用这两个开关
jar.save(ignore_discard=True, ignore_expires=False)

# 另存前先保留副本，避免覆盖唯一的 Cookie 文件
jar.save("cookies.next.txt")

官方文档还提醒，Mozilla 格式会丢失 RFC 2965 Cookie 以及 port 等较新的或非标准属性；保存前最好备份，尤其是文件还会被其他客户端使用时。

load 之前先处理文件和格式异常

读取文件同样是显式动作。文件不存在时可能得到 OSError，格式不符合该类预期时可能得到 LoadError。因此，首次启动和后续启动应区分处理，不要把“没有 Cookie 文件”当成程序崩溃。

from pathlib import Path
from http.cookiejar import LoadError, MozillaCookieJar

cookie_file = Path("cookies.txt")
jar = MozillaCookieJar(cookie_file)

try:
    # load() 会把文件中的 Cookie 加回当前容器
    jar.load()
except FileNotFoundError:
    # 第一次运行没有文件，保持空容器即可
    pass
except (LoadError, OSError) as exc:
    # 文件存在但格式或权限异常时，交给上层记录并决定是否重建
    raise RuntimeError("Cookie 文件无法加载") from exc

如果希望失败时连内存里的旧状态也不改变，可以考虑 revert()：它会清空并从文件重新加载，加载失败时对象状态不会被改变。只在你明确需要“以文件内容替换当前容器”时使用。

接入 urllib.request 时让 Cookie 自动复用

持久化只是文件层，真正发请求时还要把同一个 Cookie 容器交给 HTTPCookieProcessor。这样请求处理器会根据 Cookie 策略决定哪些条目可以返回给服务器；它不会绕过域名、路径或安全属性限制。

import urllib.request
from http.cookiejar import MozillaCookieJar

jar = MozillaCookieJar("cookies.txt")

try:
    # 文件不存在时按首次运行处理；示例不携带任何真实凭据
    jar.load()
except FileNotFoundError:
    pass

# 将同一个容器交给处理器，后续响应中的 Cookie 才能回写到 jar
opener = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(jar))

# 请求完成后按需保存；这里的 URL 仅用于说明调用位置
# response = opener.open("https://example.test/")
jar.save()

如果你的请求库不是 urllib.request，应查它自己的 Cookie 容器接口，不要把 Mozilla 文件格式当成所有库都能直接加载的通用协议。

常见误区与速查

一句话记忆：MozillaCookieJar 管文件格式，save() 管落盘边界，load() 管恢复，HTTPCookieProcessor 管请求接入；四者职责分开，Cookie 持久化就不容易混乱。

相关问题

MozillaCookieJar 会自动保存 Cookie 吗？

不会。它提供文件格式实现，但仍要在合适的时机显式调用 save()。

为什么保存后文件里没有临时 Cookie？

因为 ignore_discard 默认关闭，通常不会保存会话 Cookie。只有确认生命周期和安全边界后，才考虑打开它。

load 和 revert 有什么区别？

load() 把文件内容加载到当前容器，旧条目通常保留；revert() 会清空并按文件重新加载，且加载失败时保持原状态不变。