0

0

Python对象序列化_pickle机制解析【教程】

舞姬之光

舞姬之光

发布时间:2026-01-05 17:17:02

|

534人浏览过

|

来源于php中文网

原创

Pickle 是 Python 默认对象序列化工具,用于保存对象状态和重建逻辑,依赖解释器、类定义及代码版本,存在兼容性与安全风险;支持基本类型、顶层函数、类实例等,不支持文件对象、嵌套类等;可通过 __getstate__ 和 __setstate__ 控制序列化行为;协议版本 0–5 影响性能与兼容性;反序列化不受信任数据会导致 RCE,应优先选用 JSON、Protocol Buffers 等安全替代方案。

python对象序列化_pickle机制解析【教程】

Pickle 是 Python 默认的对象序列化工具,它能把内存中的对象转换成字节流,便于存储或传输,之后还能原样还原。但它的核心不是“存数据”,而是“保存对象的状态和重建逻辑”——这意味着它依赖 Python 解释器、类定义、模块路径,甚至代码版本。用不好容易报错、不兼容、甚至有安全风险。

pickle 能序列化什么?哪些会失败?

支持的类型包括:基本数据类型(int/str/list/dict/tuple/set)、函数(仅限顶层定义的函数,不能是 lambda 或嵌套函数)、类实例(要求类在模块顶层且可被 import)、大多数内置类型(如 datetime、Decimal)。

常见失败情况:

  • 文件对象、网络连接、数据库游标等系统资源类对象无法序列化
  • 类定义不在模块顶层(比如在函数内定义的 class)会报 AttributeError: Can't pickle local object
  • 使用了 C 扩展或自定义 __reduce__ 但返回非法格式时会出错
  • 不同 Python 版本间默认协议不兼容(如 3.8 用 protocol=4 序列化的数据,3.7 可能无法加载)

如何控制序列化行为?\_\_getstate\_\_ 和 \_\_setstate\_\_ 是关键

默认情况下,pickle 会保存对象的整个 __dict__。如果想排除某些属性(比如临时缓存、打开的文件句柄),或需要自定义重建逻辑,就该重写这两个方法:

立即学习Python免费学习笔记(深入)”;

  • __getstate__ 返回一个字典,表示“你想保存哪些状态”。可以删掉不可序列化的字段,或替换为可序列化的值
  • __setstate__ 接收这个字典,在反序列化时手动恢复对象状态,比如重新打开资源、重建缓存

例如:

PHP5学习对象教程
PHP5学习对象教程

PHP5学习对象教程由美国人古曼兹、贝肯、瑞桑斯编著,简张桂翻译,电子工业出版社于2007年12月1日出版的关于PHP5应用程序的技术类图书。该书全面介绍了PHP 5中的新功能、编程方法及设计模式,还分析阐述了PHP 5中新的数据库连接处理、错误处理和XML处理等机制,帮助读者系统了解、熟练掌握和高效应用PHP。

下载
class CacheHolder:
  def __init__(self, data):
    self.data = data
    self._cache = {}  # 不想保存
  def __getstate__(self):
    state = self.__dict__.copy()
    state.pop('_cache', None)
    return state
  def __setstate__(self, state):
    self.__dict__.update(state)
    self._cache = {}  # 反序列化后初始化空缓存

协议版本、性能与跨版本兼容性怎么选?

Pickle 协议从 0 到 5(Python 3.8+ 支持),数字越大功能越强、体积越小、速度越快,但也越不兼容旧版本:

  • protocol=0:ASCII 文本格式,人类勉强可读,兼容性最好(2.x/3.x 都行),但慢且大
  • protocol=2:Python 2.3+ 引入,支持新式类,推荐用于跨 Python 2/3 场景
  • protocol=4:Python 3.4+ 默认,支持超长序列、复数类型优化,日常开发首选
  • protocol=5:Python 3.8+ 新增,支持带外数据(out-of-band buffers),适合大数据量 + 零拷贝场景

显式指定协议更稳妥:pickle.dumps(obj, protocol=pickle.HIGHEST_PROTOCOL) 或固定值(如 4)。

为什么不要用 pickle 处理不受信任的数据?

pickle 在反序列化时会动态执行代码(如导入模块、调用 __reduce__ 返回的函数)。恶意构造的字节流可以触发任意命令执行,等同于远程代码执行(RCE)。

安全替代方案:

  • 传数据用 JSON(需对象可转 dict)、msgpack(更紧凑)、toml/yaml(适合配置)
  • 要保留类型信息且可信环境,可用 dill(支持更多对象,但同样不安全)
  • 微服务通信优先用 Protocol Buffers 或 Apache Avro,语言中立、向后兼容

记住:pickle 是 Python 内部工具,不是通用数据交换格式。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

734

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

631

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

752

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

617

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1258

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

577

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

705

2023.08.11

漫蛙2入口地址合集
漫蛙2入口地址合集

本专题整合了漫蛙2入口汇总,阅读专题下面的文章了解更多详细内容。

153

2026.01.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 0.6万人学习

Django 教程
Django 教程

共28课时 | 2.8万人学习

SciPy 教程
SciPy 教程

共10课时 | 1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号