扩展DuckDB连接Oracle时遇LNK2019未解析外部符号问题

你当前遇到的LNK2019未解析外部符号错误，根源是代码中使用了Oracle的OCCI（C++接口），但仅链接了底层的OCI（C接口）库，导致OCCI的类方法无法找到实现。以下是具体解决步骤：

1. 修正CMake配置，链接OCCI库 #

OCCI是Oracle提供的C++数据库接口，和OCI是两个独立的库。你需要修改CMakeLists.txt，找到并链接occi.lib（Windows平台）：

# Specify the path to the Oracle Instant Client
set(ORACLE_INSTANT_CLIENT_DIR "${CMAKE_CURRENT_LIST_DIR}/src/instantclient_23_4")

# Add include directories
include_directories(${ORACLE_INSTANT_CLIENT_DIR}/sdk/include)

# 查找OCCI和OCI库（优先OCCI，因为代码用的是C++接口）
find_library(OCCI_LIB occi PATHS ${ORACLE_INSTANT_CLIENT_DIR}/sdk/lib)
find_library(OCI_LIB oci PATHS ${ORACLE_INSTANT_CLIENT_DIR}/sdk/lib)

if(NOT OCCI_LIB)
    message(FATAL_ERROR "occi.lib not found in ${ORACLE_INSTANT_CLIENT_DIR}/sdk/lib")
endif()
if(NOT OCI_LIB)
    message(FATAL_ERROR "oci.lib not found in ${ORACLE_INSTANT_CLIENT_DIR}/sdk/lib")
endif()

# 同时链接OCCI和OCI库
target_link_libraries(${EXTENSION_NAME} ${OCCI_LIB} ${OCI_LIB})

2. 确保架构匹配 #

• 确认DuckDB扩展的编译架构（32位/64位）和Oracle Instant Client的架构完全一致，混合架构会导致链接或运行时错误。
• Windows平台下，若使用Visual Studio，需在CMake中指定对应架构（如-A x64）。

3. 配置C++标准兼容性 #

Oracle OCCI对C标准有要求（如Oracle 23c需C17及以上），在CMake中添加标准配置：

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

4. 处理运行时依赖 #

编译通过后，需要将Oracle Instant Client的动态库文件复制到DuckDB扩展的输出目录：

• Windows平台：复制instantclient_23_4目录下的occi.dll、oci.dll、oraociei.dll、oraons.dll到扩展输出路径（如build/release/extension/parquet）。
• 确保这些库在系统PATH中，或者和DuckDB可执行文件同目录，否则运行时会出现加载失败。

5. 检查代码中的OCCI使用 #

确认代码中OCCI的调用方式正确，比如createEnvironment的参数匹配：

// 确保使用正确的OCCI环境创建方式
oracle::occi::Environment *env = oracle::occi::Environment::createEnvironment(
    oracle::occi::Environment::DEFAULT, 
    nullptr, nullptr, nullptr
);

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