我之前也碰到过几乎一模一样的HDF5插件加载问题，结合你描述的场景——终端SSH登录或者本地运行脚本完全正常，但用Paramiko/subprocess调用就报错，这大概率不是相对路径的锅，而是环境变量加载不完整或者HDF5插件路径没正确传递导致的，咱们一步步来拆解：

先看错误核心 #

你贴的错误日志里，最关键的两句是：

required filter 'HDF5 JPEG-LS filter' is not registered
can't open directory

这说明HDF5找不到JPEG-LS插件的存放目录，而这个目录的路径通常是通过环境变量HDF5_PLUGIN_PATH来指定的。

为什么终端/本地正常，但Paramiko/subprocess不行？ #

这里的核心差异是shell的启动模式：

• 当你通过终端SSH登录或者本地打开终端时，启动的是交互式登录shell，这种shell会自动加载~/.bashrc、~/.profile这类配置文件，里面的环境变量（比如HDF5_PLUGIN_PATH）会生效。
• 但Paramiko默认执行命令时，启动的是非交互式非登录shell；subprocess如果直接调用命令，也不会加载用户的shell配置文件。这就导致你以为已经加载了环境变量，但实际上运行脚本的环境里根本没有HDF5_PLUGIN_PATH。

具体解决思路 #

1. 直接在脚本里硬编码插件路径（最稳妥） #

不需要依赖shell配置，直接在Python脚本开头手动设置环境变量，确保HDF5能找到插件：

import os
# 替换成你实际的HDF5插件目录，比如/usr/local/hdf5/lib/plugin，或者你安装JPEG-LS插件的路径
os.environ['HDF5_PLUGIN_PATH'] = '/absolute/path/to/hdf5/plugins'

# 然后导入你的HDF5相关库（比如h5py）
import h5py
# 后续脚本逻辑...

2. 在Paramiko/subprocess调用时传递完整环境变量 #

如果不想修改脚本，可以在调用时手动传递包含HDF5_PLUGIN_PATH的环境变量：

• 对于subprocess：

import subprocess
import os

# 复制当前环境变量，再添加/修改HDF5_PLUGIN_PATH
env = os.environ.copy()
env['HDF5_PLUGIN_PATH'] = '/absolute/path/to/hdf5/plugins'
# 用绝对路径调用脚本，避免相对路径干扰
subprocess.run(['python3', '/full/path/to/your_script.py'], env=env)

• 对于Paramiko：

import paramiko

ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
ssh.connect('your_host', username='your_user', password='your_password')

# 构造包含HDF5_PLUGIN_PATH的环境变量，或者直接在命令里设置
cmd = 'export HDF5_PLUGIN_PATH=/absolute/path/to/hdf5/plugins && python3 /full/path/to/your_script.py'
stdin, stdout, stderr = ssh.exec_command(cmd)

# 查看输出和错误
print("输出:", stdout.read().decode())
print("错误:", stderr.read().decode())
ssh.close()

3. 强制Paramiko使用交互式登录shell加载配置 #

如果你的HDF5_PLUGIN_PATH是在~/.bashrc或~/.profile里配置的，可以让Paramiko启动交互式登录shell，强制加载这些配置：

import paramiko

ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
ssh.connect('your_host', username='your_user', password='your_password')

# 用bash -l（登录shell）-i（交互式）来执行命令，确保加载.bashrc和.profile
cmd = 'bash -l -i -c "python3 /full/path/to/your_script.py"'
stdin, stdout, stderr = ssh.exec_command(cmd)

print("输出:", stdout.read().decode())
print("错误:", stderr.read().decode())
ssh.close()

4. 验证环境变量是否正确传递 #

如果还是有问题，可以先在Paramiko/subprocess里执行命令，检查环境变量是否生效：

• Paramiko里执行：

stdin, stdout, stderr = ssh.exec_command('echo $HDF5_PLUGIN_PATH; echo $PATH')
print("环境变量输出:", stdout.read().decode())

• 对比终端里执行同样命令的输出，如果HDF5_PLUGIN_PATH为空，说明确实是环境变量没加载，回到前面的步骤调整即可。

5. 检查插件目录的权限 #

最后别忘了确认：运行脚本的用户（也就是Paramiko连接的用户）对插件目录有读取权限，可以执行ls -l /absolute/path/to/hdf5/plugins看看权限设置，避免因为权限不足导致HDF5无法打开目录。

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