ImportError: libopenblas.so.0: cannot open shared object file 完整复盘与解决方案

这里写目录标题

[1 背景](#1 背景)
[2 核心疑问：到底是不是环境变量 LD_LIBRARY_PATH 的问题？](#2 核心疑问：到底是不是环境变量 LD_LIBRARY_PATH 的问题？)
[2.1 基础原理：Linux 如何找到 .so 共享库](#2.1 基础原理：Linux 如何找到 .so 共享库)
[2.2 根因拆解（Ubuntu 22.04 Jammy 特有）](#2.2 根因拆解（Ubuntu 22.04 Jammy 特有）)
[3 解决方案](#3 解决方案)
[3 补充知识：为什么会调用到openblas库](#3 补充知识：为什么会调用到openblas库)

1 背景

在 Jetson（Orin/Nano，JetPack Ubuntu Jammy）远程 SSH 运行 PyTorch 代码时，导入 torch 触发经典共享库报错：libopenblas.so.0: cannot open shared object file: No such file or directory。

很多人误以为是 Python 虚拟环境、LD_LIBRARY_PATH 环境变量配置错误，或是 PyTorch 没安装；本文拆解底层根因、区分系统动态链接器原理、提供临时调试 / 永久修复两套方案，并补充 Jetson 平台特有踩坑点。

2 核心疑问：到底是不是环境变量 LD_LIBRARY_PATH 的问题？

半对半错：本质不是环境变量缺失，是系统库文件部署路径变更 + 动态链接器检索规则不匹配，环境变量只是临时绕开问题的手段，不能根治。

2.1 基础原理：Linux 如何找到 .so 共享库

Linux 程序加载动态库的查找顺序：

编译时写入程序内的 rpath
环境变量 LD_LIBRARY_PATH（用户自定义路径，终端临时生效）
系统动态链接器配置目录 /etc/ld.so.conf 及其 include 文件
系统默认库目录：/usr/lib/aarch64-linux-gnu/、/lib/aarch64-linux-gnu/
缓存：ldconfig 生成的 /etc/ld.so.cache 索引

注意：动态链接器默认不会递归扫描子文件夹！

2.2 根因拆解（Ubuntu 22.04 Jammy 特有）

执行 find /usr -name "*libopenblas*.so* 后，库文件真实存放路径：

bash 复制代码

/usr/lib/aarch64-linux-gnu/openblas-pthread/libopenblas.so.0

新版 Ubuntu 将多线程版本 OpenBLAS 放到了openblas-pthread 子目录，不再直接放在顶层 /usr/lib/aarch64-linux-gnu/。

PyTorch（通用 aarch64 wheel）编译阶段，链接器写死依赖 libopenblas.so.0，检索路径为系统顶层库目录，不会自动检索子文件夹。

系统 ldconfig 默认索引顶层目录，子目录不会加入全局缓存，导致运行时找不到文件。

3 解决方案

在系统默认库目录创建软链接，指向子目录内真实的库文件，更新链接缓存：

bash 复制代码

# 创建软链接
sudo ln -s /usr/lib/aarch64-linux-gnu/openblas-pthread/libopenblas.so.0 /usr/lib/aarch64-linux-gnu/libopenblas.so.0
# 更新系统动态链接缓存
sudo ldconfig

3 补充知识：为什么会调用到openblas库

在我本地的代码中，只调用了torch的库。

python 复制代码

import torch
import torch.nn as nn
import torch.onnx

在调用torch后，会调用到底层的C++ 底层核心模块 _C.so，而PyTorch CPU 算子（matmul、卷积底层addmm运算）依赖 BLAS 实现。

仅仅执行 import torch，还未编写任何神经网络推理代码，系统就会加载全部依赖的动态库，直接触发本次报错 。

不止 PyTorch，numpy、opencv等科学计算库，同样会依赖 OpenBLAS，这也是我们执行 find 命令时，在 numpy、opencv 目录下看到 openblas 相关文件的原因。