YashanDB|YMP 报错“OCI 版本为空或架构不一致”?一文快速排查

【问题描述】

在执行 YMP 工具进行数据迁移预检查时，报错提示：

“OCI 版本为空或 OCI 架构与本地系统架构不匹配”

这类错误通常与 Oracle 客户端动态库的依赖问题有关。

【排查步骤】

1. 查看 DTS 日志，确认真实错误原因

日志路径：

tail -f yashan-migrate-platform/logs/dts_log/run.log

若提示缺失 libnsl.so.1.说明驱动库 libdrv_oracle.so 缺少依赖。

2. 检查是否正确设置

确认环境变量中是否已包含 Oracle 客户端路径：

cat yashan-migrate-platform/db/conf/ymp_migrate.bashrc

3. 确认依赖库缺失情况

source yashan-migrate-platform/db/conf/ymp_migrate.bashrc
ldd /bin/yasdts/lib/libdrv_oracle.so

如输出中包含 “not found”，表示该依赖库未找到。

【解决方法】

方式一：安装缺失的动态库

若 libnsl.so.1 缺失，可通过包管理器安装，或从其他系统复制。

方式二：通过软链接解决版本不一致

如果系统中已有 libnsl.so.2.但缺少 libnsl.so.1.可手动创建链接：

ldconfig -p | grep libnsl  # 查看当前系统已有库
cd /bin/yasdts/lib         # 切换到 Oracle 驱动目录
ln -s /lib64/libnsl.so.2 libnsl.so.1
ldd libdrv_oracle.so       # 确认已无缺失

【知识补充】

动态库的查找顺序：

环境变量 LD_LIBRARY_PATH

配置文件 /etc/ld.so.conf(需运行 ldconfig 生效)

系统默认路径：/lib, /usr/lib, /lib64. /usr/lib64

查看动态库依赖的命令：

ldd 

【总结】

该报错本质上不是 YMP 工具自身的问题，而是系统缺少 Oracle 客户端依赖库。通过日志 + 环境检查 + 动态库软链接，即可快速排查与解决。