Python oracledb厚客户端找到libclntsh.so但无法定位libnnz11.so

针对你在Amazon Linux 2023 EC2上测试Python oracledb厚客户端时，出现能找到libclntsh.so但无法定位libnnz11.so的问题，以下是具体排查方向和解决办法：

1. 环境变量配置时机或生效范围问题 #

脚本中设置的ORACLE_HOME和LD_LIBRARY_PATH可能未正确生效到oracledb加载库的进程上下文：

• 解决方式1：在启动Python脚本前，先在shell中导出环境变量，确保进程继承正确的路径：

  export ORACLE_HOME=/path/to/your/oracle/client
  export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
  python your_script.py
  

• 解决方式2：在Python脚本最开头优先设置环境变量，再导入oracledb：

  import os
  # 替换为你的Oracle客户端实际路径
  os.environ['ORACLE_HOME'] = '/path/to/your/oracle/client'
  os.environ['LD_LIBRARY_PATH'] = f"{os.environ['ORACLE_HOME']}/lib:{os.environ.get('LD_LIBRARY_PATH', '')}"
  import oracledb
  oracledb.init_oracle_client()
  

2. 架构不匹配（64位/32位） #

Amazon Linux 2023是64位系统，需确认Oracle客户端及libnnz11.so为64位版本：

• 执行命令检查文件架构：

  file /path/to/oracle/client/lib/libnnz11.so
  

  输出需包含ELF 64-bit LSB shared object，若为32位，需更换64位Oracle客户端。

3. 版本兼容性问题 #

oracledb对Oracle客户端版本有要求，libnnz11.so属于Oracle 11g版本，需确认：

• 你的oracledb版本是否支持11g客户端（建议使用最新稳定版oracledb）；
• 若版本不兼容，可升级oracledb，或更换为12c及以上版本的Oracle客户端（对应libnnz12.so等后续版本库文件）。

4. SELinux权限限制 #

Amazon Linux 2023默认开启SELinux，可能阻止进程读取lib目录下的文件：

• 临时关闭SELinux测试：

  sudo setenforce 0
  

  若问题解决，需为Oracle客户端目录添加正确的SELinux上下文：

  sudo semanage fcontext -a -t lib_t "/path/to/oracle/client/lib(/.*)?"
  sudo restorecon -Rv /path/to/oracle/client/lib
  

针对AWS Serverless部署的提前注意事项 #

• Lambda等Serverless环境为只读文件系统，需将Oracle客户端打包到部署包，或使用Lambda层托管客户端文件；
• 确保Lambda运行时（如对应Amazon Linux 2023的runtime）与本地EC2环境一致，避免库依赖不兼容；
• 在Lambda中设置环境变量时，需保证LD_LIBRARY_PATH包含Oracle客户端lib目录，或在代码开头按上述方式设置环境变量。

内容的提问来源于stack exchange，提问作者Jevan has no idea