skops是当前唯一能同时解决跨版本兼容性与反序列化安全问题的标准方案,它通过json+numpy格式绕开pickle的opcode解释器,杜绝任意代码执行和版本不兼容错误,且必须显式设置trusted=true才可加载。

skops 是当前唯一能同时解决跨版本兼容性与反序列化安全问题的方案,不是“可选替代”,而是必须采用的标准路径。用原生 pickle.load() 加载外部模型,等于在生产环境里主动执行未知代码。
为什么不能用 pickle.load() 加载外部 sklearn 模型
scikit-learn 本身不控制序列化逻辑,完全依赖 Python 的 pickle —— 它在反序列化时会动态执行任意函数调用(如 os.system、subprocess.Popen),这不是 bug,是设计使然。一个恶意 .pkl 文件可在加载瞬间执行:rm -rf /、写入 webshell、外连 C2 服务器。
常见错误现象包括:
- 从 Hugging Face、GitHub 或用户上传渠道加载
.pkl后,服务进程异常退出或 CPU 突增 - 本地调试时
pickle.load()执行了print("hello")这类副作用,说明已触发任意代码 - 部署后遭供应链投毒,模型文件被替换为含
__reduce__恶意载荷的版本
用 skops.save 和 skops.load 替代 pickle
skops 把模型转成 JSON + NumPy 二进制格式,彻底绕开 pickle 的 opcode 解释器,既防代码执行,又消除了版本差异导致的 AttributeError 或 ModuleNotFoundError。
实操只需两步:
- 保存时:用
skops.save(model, "model.skops")替代pickle.dump()—— 不改训练代码,不引入新依赖 - 加载时:必须显式传
trusted=True,即skops.load("model.skops", trusted=True);若省略该参数,会直接抛UntrustedType异常,这是安全强制机制,不是报错 - 若模型含自定义类(如继承
BaseEstimator的新分类器),需提前注册:调用skops.card.Card.add_model(),并确保该类在加载环境中可 import(不能是嵌套类或局部定义)
遇到 UntrustedType 错误怎么办
这是 skops 主动拦截,不是配置失误。它检测到模型中存在未声明为可信的类型(比如非标准的 numpy.ndarray 子类、自定义容器对象),就会中断加载。
正确应对方式:
- 检查模型是否真的需要这些类型 —— 大多数 sklearn 模型只含
numpy.ndarray、sklearn内置 estimator、基本 Python 类型;如有冗余结构,先清理再保存 - 确认自定义类已在加载端导入且路径一致(例如序列化时用的是
mylib.models.MyClassifier,加载前必须已执行import mylib.models) - 切勿简单设
trusted=True就完事 —— 这等价于放弃所有类型校验,和直接用pickle几乎无异 - 生产环境建议推送到 Hugging Face Hub:
skops.hub.push(...),利用其自动签名与元数据校验能力,实现加载来源可追溯
别再碰 joblib 和 sklearn.externals
joblib 是 pickle 的封装,本质仍是 unsafe;它在 sklearn 1.0+ 中已被弃用,且完全不解决跨版本问题。而 sklearn.externals.joblib 在较新版本中已移除,硬引用会导致 ImportError。
skops 不依赖 joblib,也不绑定 sklearn 版本 —— 只要模型能被 sklearn 识别为合法 estimator(即满足 fit/predict 接口),就能处理。
真正容易被忽略的点是:即使你只在内网用、只加载自己团队生成的模型,只要模型文件传输链路(如 CI/CD artifact 存储、S3 bucket 权限配置、Git LFS 提交)存在被篡改可能,pickle 就永远是单点故障。安全不是“要不要做”,而是“什么时候做”。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











