使用cpu加速转换pdf文件，报错libascend_hal.so: cannot open shared object file: no such file or directory

[xunliu834-a11y]

🔎 Search before asking | 提交之前请先搜索

• I have searched the MinerU Readme and found no similar bug report.
• I have searched the MinerU Issues and found no similar bug report.
• I have searched the MinerU Discussions and found no similar bug report.

🤖 Consult the online AI assistant for assistance | 在线 AI 助手咨询

• I have consulted the online AI assistant but was unable to obtain a solution to the issue.

Description of the bug | 错误描述

目前使用cpu加速转换，系统信息已上传附件，magic-pdf版本是1.3.11。服务器架构为aarch64，通过容器的方式启动mineru，物理宿主机为鲲鹏920服务器

How to reproduce the bug | 如何复现

执行magic-pdf -p 文件.pdf -o .文件转换时报错

Operating System Mode | 操作系统类型

No response

Operating System Version| 操作系统版本

Python version | Python 版本

3.10

Software version | 软件版本 (mineru --version)

2.0.x

Device mode | 设备模式

cpu

[xunliu834-a11y]

上创两张解析时的报错信息

[dosubot[bot]]

Hi @xunliu834-a11y! I'm Dosu and I’m helping the MinerU team.

你的环境报错 libascend_hal.so: cannot open shared object file，即使你选择了 CPU 模式，根本原因通常是环境里安装了 torch_npu 包，哪怕你没用 NPU，只要 torch_npu 存在，MinerU 检查 NPU 可用性时就会尝试加载华为 Ascend NPU 的依赖库（比如 libascend_hal.so），如果系统没有这些库就会报错。相关代码逻辑和社区讨论

解决方法：

1. 强烈建议在容器或环境变量里明确设置 MINERU_DEVICE_MODE=cpu，这样 MinerU 会强制只用 CPU，不会再检测 NPU。
2. 如果你本身不需要 NPU，建议直接卸载 torch_npu 包（pip uninstall torch_npu），或者构建镜像时不要安装它。
3. 如果你需要保留 torch_npu，务必保证 MINERU_DEVICE_MODE=cpu，否则 torch_npu 的自动检测依然可能触发加载 NPU 相关库。

只要环境变量设置正确，并且没有多余的 NPU 相关包，CPU 模式下不会再报这个错。详细分析和最佳实践见这里。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[xunliu834-a11y]

新的报错

[myhloli]

torch需要更新到2.6.0以上