Python升级后pickle反序列化失败主因是协议升级与类路径解析变严格；datetime.fromisoformat()在3.9+变严格；C扩展包需重装适配新ABI；dataclass frozen=True下default_factory行为变更；隐性变更更需警惕。
Python 升级后 pickle 反序列化失败
旧版本 Python（如 3.7）用 pickle 保存的数据，在 3.10+ 上直接 pickle.load() 很可能报 UnicodeDecodeError 或 AttributeError。这不是数据损坏，而是默认协议升级 + 类路径解析逻辑变化导致的。
核心原因：Python 3.8 起 pickle.DEFAULT_PROTOCOL 升到 4，而老数据多用协议 2 或 3；更关键的是，新版本对类名绑定更严格，比如模块重命名、__qualname__ 改变都会让 pickle 找不到原类。
- 临时救急：加载时强制指定协议，如
pickle.load(f, encoding='bytes')（适用于 2→3.x 场景）或encoding='latin1'（部分 3.6→3.9 兼容） - 长期方案：别用
pickle存长期数据；改用json+ 自定义序列化，或msgpack+ 显式 schema - 验证方式：用旧环境打开文件，执行
pickle.format_version查协议号，再比对新环境支持范围
datetime 对象在 Python 3.9+ 中的 fromisoformat() 行为变化
3.9 之前，datetime.fromisoformat("2020-01-01") 能容忍缺省时间部分；3.9+ 开始严格校验 ISO 8601 格式，缺 T 和时间会直接抛 ValueError。
这影响所有依赖字符串反解时间的旧代码，尤其从数据库或日志里读出的“纯日期”字段。
立即学习“Python免费学习笔记（深入）”；
- 检查你是否在调用
fromisoformat()前做了.replace(' ', 'T')这类预处理——现在可能多余甚至出错 - 安全写法：统一用
date.fromisoformat()解纯日期，datetime.fromisoformat()解带时间的完整字符串 - 注意
datetime.fromisoformat("2020-01-01T00:00:00Z")在 3.11+ 还会因时区处理差异失败，建议改用datetime.fromisoformat(...).replace(tzinfo=timezone.utc)
第三方包 ABI 不兼容引发的 ImportError: undefined symbol
升级 Python 后，用 pip install 装的老版二进制包（如 numpy、psycopg2）可能报 undefined symbol: PyUnicode_AsUTF8AndSize 这类错误。本质是 C 扩展没重新编译，链接到了旧的 Python C API 符号表。
不是 pip 缓存问题，也不是权限问题，是 ABI 层面断裂。
- 必须重装：运行
pip install --force-reinstall --no-deps <pkg></pkg>，确保触发源码编译（如有）或下载匹配新 Python 的 wheel - 特别注意
conda环境：conda update python后务必跟conda install <pkg></pkg>，不能混用 pip 装 C 包 - CI/CD 中要显式清除
~/.cache/pip和site-packages下对应包，否则缓存 wheel 会跳过重建
dataclass 默认值在 Python 3.10+ 的冻结行为变更
带 default_factory 的 dataclass 字段，在 3.10 后如果设了 frozen=True，初始化时若 factory 返回可变对象（如 list），实例字段会被意外共享——和预期“每个实例独立”相悖。
这不是 bug，是冻结机制对 __post_init__ 干预方式变了，导致 factory 调用时机异常。
- 复现条件：Python ≥3.10 +
@dataclass(frozen=True)+field(default_factory=list) - 验证方法：创建两个实例，修改其中一个的 list，看另一个是否同步变
- 解决：要么去掉
frozen=True，要么把 factory 逻辑移到__post_init__里手动赋值，避开冻结拦截
最麻烦的从来不是升级动作本身，而是那些没报错、但值悄悄变了的地方——比如浮点数哈希顺序、字典迭代顺序、甚至 re.match() 对空字符串的返回值。上线前得跑真实数据流，不能只靠单元测试。
