讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

updream

一键生成高质量推广成片

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

在Python中如何将Scikit-learn模型无缝导出为ONNX格式

浅浩君_7960

浅浩君_7960

发布时间:2026-11-17 08:53:06

|

245人浏览过

|

来源于php中文网

原创

scikit-learn模型导出ONNX前必须已训练完成、使用skl2onnx工具、模型在官方支持列表中、输入数据dtype和shape明确、pipeline各步骤均兼容且类型适配正确。

在python中如何将scikit-learn模型无缝导出为onnx格式

scikit-learn模型导出ONNX前必须满足哪些前提条件

不是所有 sklearn 模型都能直接转 ONNX。核心限制在于:ONNX 官方只通过 skl2onnx 支持部分 sklearn 算法,且要求模型已训练完成、不包含自定义类或闭包逻辑。

  • 必须使用 skl2onnx(而非 onnxmltools,后者已弃用)
  • 模型类型需在 官方支持列表 中,例如 LogisticRegression、RandomForestClassifier、SVC(kernel='rbf' 仅限 sklearn ≤1.2)、StandardScaler 等
  • 输入数据必须有明确的 dtype 和 shape;不能传 None 或混合类型列(如 pandas DataFrame 含 object 列)
  • 训练时若用了 pipeline,需确保每一步都支持转换(比如 SimpleImputer 在 sklearn ≥1.0 中默认 strategy='mean' 才可转)

如何用skl2onnx正确调用convert_sklearn

convert_sklearn 不是黑盒函数,它的三个关键参数决定能否成功:

  • model:必须是已调用 fit() 的实例(未训练会报 AttributeError: 'XXX' object has no attribute 'classes_' )
  • initial_types:必须显式声明输入名、类型和形状,不能依赖自动推断
    示例:[('input', FloatTensorType([None, 4]))] 表示任意行数、4 列的 float32 输入
  • target_opset:建议固定为 17 或 18(太高可能触发未知算子错误;太低不支持新模型如 HistGradientBoostingClassifier)
from skl2onnx import convert_sklearn
from skl2onnx.common.data_types import FloatTensorType
from sklearn.ensemble import RandomForestClassifier
<p>clf = RandomForestClassifier(n_estimators=10).fit(X_train, y_train)
onx = convert_sklearn(
clf,
initial_types=[('input', FloatTensorType([None, X_train.shape[1]]))],
target_opset=17
)
with open("rf.onnx", "wb") as f:
f.write(onx.SerializeToString())</p>

Pipeline导出时最容易漏掉的两个细节

用 sklearn.pipeline.Pipeline 时,90% 的失败源于这两点:

  • 没对 pipeline 中的每一步做类型适配:比如 ColumnTransformer 需配合 skl2onnx.convert.convert_sklearn + get_column_transformer_outputs 手动处理,不能直接塞进 convert_sklearn

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

  • 忘记把最终 estimator 的输出名与 pipeline 的 final step 对齐:若 pipeline 最后是 StandardScaler,则 initial_types 应描述 scaler 的输入(即前一步输出),而不是原始 X 的 shape

    Python 环境工具基础版
    Python 环境工具基础版

    管理 Python 项目环境,支持虚拟环境创建、依赖安装与环境诊断

    下载
  • 若 pipeline 含 FunctionTransformer,其 func 必须是纯函数(无副作用、不依赖全局变量),否则 ONNX runtime 加载时报 RuntimeError: Unable to find function

  • 推荐先用 skl2onnx.update_registered_converter 注册自定义转换器(如特殊预处理类),而不是硬编码绕过类型检查

验证ONNX模型是否真能跑通

导出文件不报错 ≠ 模型可用。必须做三步验证:

  • 用 onnx.checker.check_model 校验结构合法性(缺失 doc_string 不影响运行,但缺失 graph 会直接崩溃)
  • 用 onnxruntime.InferenceSession 加载并 feed 真实尺寸输入(注意:shape 必须匹配 initial_types 中定义的 batch 维度,[1, 4] 不能喂 [4])
  • 对比 sklearn 与 ONNX 的预测输出:分类任务看 session.run(None, {'input': X_test.astype(np.float32)})[0] 是否与 clf.predict(X_test) 一致;概率输出要对比 predict_proba 和 ONNX 输出第二列(顺序可能不同)

有些模型(如 LinearSVC)在 sklearn 中默认用 decision_function,而 ONNX 默认导出 predict,这时需显式传参 options={id(clf): {'zipmap': False}} 控制输出格式。

实际部署时,FloatTensorType 的 shape 声明里用 [None, N] 是安全的,但若后续要用 TensorRT 或 TVM 做推理优化,就得提前固定 batch size 并改用 [1, N],否则编译阶段会失败。

热门AI工具

更多
码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

相关专题

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

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

1931

2023.07.20

python能做什么
python能做什么

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

5484

2023.07.25

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

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

1889

2023.07.31

python教程
python教程

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

33497

2023.08.03

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

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

3927

2023.08.04

python eval
python eval

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

3947

2023.08.04

scratch和python区别
scratch和python区别

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

1283

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

636

2023.08.10

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn