故障排查

常见问题

以下为使用 DolphinDB C++ API 时的常见问题及解决方法。

问题	原因	解决方法
编译时出现报错 "undefined reference to 'uuid_generate'"	未安装 libuuid-devel 库或者未添加 -luuid 参数	排查有没有添加 -luuid 参数来链接 uuid 库 Centos 系统可以通过命令 sudo yum install libuuid-devel 安装 libuuid-devel 库 Ubuntu 系列可以通过命令 sudo apt-get install uuid-dev 安装 libuuid-devel 库
使用 Visual Studio 2022 编译 C++应用时报”无法解析的外部符号“错误	在编译 C++应用时添加了预定义宏 _DDBAPIDLL	去掉该预定义宏
在 Linux 环境下，编译 C++应用时报 ”undefined reference to dolphindb::DBConnection::connect(…)” 错误	在编译 C++应用时和编译 C++ API 动态库时，宏 _GLIBCXX_USE_CXX11_ABI 的值没有统一	重新编译 C++ API 或者重新编译 C++应用即可，注意该宏的值需要一致
在 Linux 环境下，运行 C++应用时报错，无法找到 libDolphinDBAPI.so 或者 libssl.so 动态库等	在运行时无法找到相关动态库	尝试将相关动态库放到执行文件所在目录下 运行前手动添加 LD_LIBRARY_PATH，运行 export LD_LIBRARY_PATH=libPath 指定库搜索路径
在 Visual Studio 中运行时抛出如下异常：	DolphinDBAPI.dll 在编译时运行库选择了 MT 或 MTD，推荐使用 MD 或 MDD； 动态库和可执行文件采用了不同版本的 Visual Studio 版本编译； 动态库和可执行文件的 Release Debug 选项不一致。	根据不同的可能原因，相应调整

运行时异常处理

如果在连接数据库时没有开启自动重连，那么在出现网络问题等异常时，C++ API 会抛出 dolphindb::IOException、dolphindb::RuntimeException 等异常，在 C++应用程序中需要注意捕获，否则会导致进程中止。

下面是一些常见的发生异常的场景：