1. 问题现象与背景解析
最近在Ubuntu 22.04系统上通过pip安装MindSpore Transformers时,不少开发者遇到了"ModuleNotFoundError: No module named 'moxing'"的错误提示。这个报错通常发生在运行涉及华为云OBS操作的代码时,因为moxing是华为云早期提供的Python SDK组件。
注意:从MindSpore 1.8版本开始,官方已明确建议用新版obsutil工具替代moxing,但部分老代码和示例仍保留了对moxing的依赖。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 根本原因深度分析
2.1 moxing模块的历史定位
moxing曾是华为云ModelArts平台的核心传输组件,主要提供:
- 云端OBS存储与本地文件系统的交互
- 分布式训练中的数据自动分发
- 训练日志和模型自动上传功能
2.2 新老版本兼容性问题
MindSpore Transformers的某些示例代码可能:
- 沿用了早期依赖moxing的数据加载方式
- 未及时更新requirements.txt依赖声明
- 混合使用了新旧版API接口
3. 完整解决方案实操
3.1 临时解决方案(兼容旧代码)
如果必须运行依赖moxing的旧脚本,可手动安装:
bash复制pip install moxing==0.3.2
但需要注意:
- 该版本最高支持Python 3.7
- 在Ubuntu 22.04上可能需要额外处理openssl依赖
3.2 推荐方案:迁移到obsutil
3.2.1 安装配置obsutil
bash复制# 下载最新版
wget https://obs-community.obs.cn-north-1.myhuaweicloud.com/obsutil/current/obsutil_linux_amd64.tar.gz
tar -xzvf obsutil_linux_amd64.tar.gz
sudo mv obsutil_linux_amd64_*/obsutil /usr/local/bin/
# 配置访问密钥
obsutil config -i=your_ak -k=your_sk -e=obs.cn-north
