容器中使用MLFlow时挂载mlruns目录导致log_artifacts无输出问题

问题根因 #

这个问题90%以上是挂载卷的权限或者路径映射问题导致的，MLflow旧版本存在写入失败不抛错的静默bug，才会出现无报错但无文件的情况：

1. 权限不匹配：Docker容器内运行脚本的用户UID/GID和宿主机上mlruns目录的所有者UID/GID不一致，容器用户没有挂载目录的写入权限。MLflow默认会先将产物写入容器内临时目录，复制到目标路径失败时，部分旧版本不会抛出报错，直接静默结束。
2. 路径映射错误：挂载的宿主机目录和容器内MLflow实际写入的mlruns路径不匹配，脚本运行时生成的文件落到了容器内未被挂载的路径下，你从宿主机挂载目录自然看不到产物。
3. 权限可见性问题：如果容器用root用户运行，写入挂载目录的文件所有者是root，你用宿主机普通用户查看时可能因权限不足看不到文件，误以为没有生成。

修复方案 #

• 解决权限问题
  • 启动容器时指定与宿主机mlruns目录所有者一致的UID/GID，示例启动参数：docker run --user $(id -u):$(id -g) -v $(pwd)/mlruns:/app/mlruns 你的镜像名
  • 临时排查可以先给宿主机mlruns目录放开权限：sudo chmod 777 ./mlruns，验证功能正常后再调整为合理权限。
• 确认路径映射正确
  • 启动容器时明确绑定mlruns目录的映射关系，保证容器内MLflow写入的路径正好是挂载的目标路径。
  • 脚本中增加打印确认MLflow的存储路径：

    print(mlflow.get_tracking_uri())
    # 路径不对的话手动强制指定
    mlflow.set_tracking_uri("./mlruns")
    

• 修复静默报错问题
  • 将MLflow升级到2.3.0及以上版本，该版本已修复写入失败无报错的问题，运行时会直接输出权限不足、路径不存在等明确错误信息，方便排查。
  • 进入容器手动测试写入挂载目录：docker exec -it 容器ID touch /app/mlruns/test.txt，如果执行失败说明是Docker挂载的基础问题，和MLflow无关，先解决挂载配置即可。

内容的提问来源于stack exchange，提问作者greg hor