无法通过Python包装器连接Hyperledger Indy测试池：找不到indy.dll

排查动态库路径 #

• 先确认系统中是否存在libindy库文件：
  • Linux/macOS：执行 find /usr -name libindy.so 或 find /usr -name libindy.dylib，验证文件是否存在
  • Windows：检查C:\Program Files\Indy SDK\lib目录下是否有indy.dll
• 若找到库文件，需确保其在系统动态库搜索路径内：
  • Linux：将库路径添加到LD_LIBRARY_PATH，执行 export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH，可写入~/.bashrc或~/.zshrc实现永久生效
  • macOS：执行 export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH，或把库软链到/usr/lib（需系统权限）
  • Windows：将indy.dll所在路径添加到系统PATH环境变量，重启命令行或IDE后生效

验证安装包版本匹配 #

• 确保python3-indy与系统libindy版本完全一致，版本不匹配会导致加载失败：
  • Linux：用dpkg -l | grep indy（Debian/Ubuntu系）或rpm -qa | grep indy（RHEL/CentOS系）查看系统包版本；Python端执行pip show python3-indy查看绑定包版本
  • 版本不一致时，卸载现有包后重新安装对应版本：

    pip uninstall python3-indy
    sudo apt remove indy libindy
    # 替换为匹配的版本号，示例为1.16.0
    sudo apt install indy=1.16.0 libindy=1.16.0
    pip install python3-indy==1.16.0
    

排除Docker环境干扰 #

• 运行Python代码的宿主机需单独安装完整libindy库，不要混淆容器内的库文件
• 确认Python代码中指定的pool1.txn文件路径正确，避免路径错误引发的连带问题

检查依赖库完整性 #

• libindy依赖OpenSSL、libsodium等系统库，缺失会导致加载失败：
  • Linux：执行 ldd /path/to/libindy.so 查看依赖项，安装标记为not found的缺失包
  • Windows：使用Dependency Walker工具检查indy.dll的依赖，补全缺失的库文件

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