如何在本地正确启动 MLflow 跟踪服务器并创建实验

发布时间 - 2026-01-22 00:00:00    点击率:

本文详解解决“cannot define a mlflow experiment”错误的核心方法:必须先启动本地 mlflow 后端服务器,否则 `mlflow.set_experiment()` 会因无法连接追踪 uri 而抛出连接拒绝异常。

当你在代码中调用 mlflow.set_tracking_uri("http://127.0.0.1:8080") 和 mlflow.set_experiment("MLflow Quickstart") 却遇到类似以下报错:

MlflowException: API request to http://127.0.0.1:8080/api/2.0/mlflow/experiments/get-by-name failed...
Caused by NewConnectionError(... [WinError 10061] Aucune connexion n’a pu être établie car l’ordinateur cible l’a expressément refusée)

并非认证或权限问题,而是最基础的连接前提未满足:你尚未启动 MLflow 跟踪服务器

MLflow 的 set_tracking_uri 指向的是一个运行中的 HTTP 服务端点(即后端),它负责接收日志、管理实验与运行。若该服务未启动,客户端(你的 Python 脚本)自然无法建立连接——就像试图访问一个未开启的网站。

✅ 正确操作流程如下:

  1. 在终端(非 Python 环境)中启动 MLflow 服务器

    mlflow server --host 127.0.0.1 --port 8080 --backend-store-uri sqlite:///mlflow.db --default-artifact-root ./mlruns
    • --host 和 --port 需与代码中 set_tracking_uri 的地址严格一致;
    • --backend-store-uri 指定元数据存储(推荐 SQLite 快速起步);
    • --default-artifact-root 指定模型/图表等二进制文件的本地保存路径。
  2. 保持该终端持续运行(服务器进程需常驻),再执行你的 Python 脚本。

  3. 验证服务是否就绪:打开浏览器访问 http://127.0.0.1:8080,应能看到 MLflow UI 界面(含“Experiments”标签页)。

? 补充说明:

  • 不要尝试在 Jupyter 或 IDE 的 Python 控制台中直接运行 mlflow server 命令(它会阻塞线程且无法后台运行);
  • 若端口被占用,可更换端口(如 --port 5000),并同步更新代码中的 URI;
  • 初次运行时,mlflow.set_experiment(...) 会自动创建同名实验(无需手动初始化);
  • 使用 SQLite 时,请确保 mlflow.db 所在目录有写入权限;生产环境建议切换为 PostgreSQL 或 MySQL。

完成上述步骤后,你的原始代码即可正常运行:

import mlflow
mlflow.set_tracking_uri("http://127.0.0.1:8080")
mlflow.set_experiment("MLflow Quickstart")  # ✅ 成功创建/获取实验

with mlflow.start_run():
    mlflow.log_param("alpha", 0.5)
    mlflow.log_metric("ac

curacy", 0.92)

总结:MlflowException: Failed to establish a new connection 是典型的“服务未启动”信号,而非配置或权限错误。先启服务,再写代码,是本地使用 MLflow 跟踪功能不可跳过的第一步。


# mysql  # python  # 浏览器  # 端口  # 后端  # ai  # win 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Win11怎么关闭资讯和兴趣_Windows11任务栏设置隐藏小组件  详解MySQL数据库的安装与密码配置  Android中Textview和图片同行显示(文字超出用省略号,图片自动靠右边)  Win11怎么查看显卡温度 Win11任务管理器查看GPU温度【技巧】  今日头条微视频如何找选题 今日头条微视频找选题技巧【指南】  活动邀请函制作网站有哪些,活动邀请函文案?  网页制作模板网站推荐,网页设计海报之类的素材哪里好?  Python进程池调度策略_任务分发说明【指导】  Laravel如何保护应用免受CSRF攻击?(原理和示例)  如何打造高效商业网站?建站目的决定转化率  Laravel如何实现API版本控制_Laravel版本化API设计方案  Laravel Octane如何提升性能_使用Laravel Octane加速你的应用  Python文件操作最佳实践_稳定性说明【指导】  Laravel如何使用Service Container和依赖注入?(代码示例)  怎么制作网站设计模板图片,有电商商品详情页面的免费模板素材网站推荐吗?  Laravel如何自定义错误页面(404, 500)?(代码示例)  网站制作怎么样才能赚钱,用自己的电脑做服务器架设网站有什么利弊,能赚钱吗?  微信小程序 input输入框控件详解及实例(多种示例)  Laravel Eloquent访问器与修改器是什么_Laravel Accessors & Mutators数据处理技巧  北京的网站制作公司有哪些,哪个视频网站最好?  网站制作价目表怎么做,珍爱网婚介费用多少?  Gemini手机端怎么发图片_Gemini手机端发图方法【步骤】  如何用狗爹虚拟主机快速搭建网站?  如何在阿里云域名上完成建站全流程?  Laravel怎么导出Excel文件_Laravel Excel插件使用教程  ,怎么在广州志愿者网站注册?  Laravel如何实现邮箱地址验证功能_Laravel邮件验证流程与配置  Laravel Artisan命令怎么自定义_创建自己的Laravel命令行工具完全指南  Laravel怎么进行数据库回滚_Laravel Migration数据库版本控制与回滚操作  Laravel怎么使用Intervention Image库处理图片上传和缩放  品牌网站制作公司有哪些,买正品品牌一般去哪个网站买?  Laravel模型关联查询教程_Laravel Eloquent一对多关联写法  php485函数参数是什么意思_php485各参数详细说明【介绍】  音乐网站服务器如何优化API响应速度?  Laravel如何处理表单验证?(Requests代码示例)  香港服务器建站指南:免备案优势与SEO优化技巧全解析  nginx修改上传文件大小限制的方法  Windows10电脑怎么设置虚拟光驱_Win10右键装载ISO镜像文件  个人摄影网站制作流程,摄影爱好者都去什么网站?  MySQL查询结果复制到新表的方法(更新、插入)  香港服务器网站生成指南:免费资源整合与高速稳定配置方案  网站制作公司哪里好做,成都网站制作公司哪家做得比较好,更正规?  高防服务器租用首荐平台,企业级优惠套餐快速部署  使用PHP下载CSS文件中的所有图片【几行代码即可实现】  JS去除重复并统计数量的实现方法  Laravel如何与Vue.js集成_Laravel + Vue前后端分离项目搭建指南  Laravel如何记录自定义日志?(Log频道配置)  php json中文编码为null的解决办法  无锡营销型网站制作公司,无锡网选车牌流程?  Laravel如何配置.env文件管理环境变量_Laravel环境变量使用与安全管理