为何无法链接使用动态并行与分离编译的CUDA静态库

错误成因 #

• CUDA架构不匹配：你在静态库中仅指定了编译适配算力52（Maxwell架构）的设备代码，但当前编译环境默认目标架构包含算力86（Ampere架构），动态并行依赖的CUDA设备运行时（cudadevrt）缺少对应86架构的符号，触发未定义引用错误。
• 依赖库缺失：动态并行特性必须链接cudadevrt.lib（CUDA设备运行时库），你只链接了主机端的cudart.lib，未引入该必要依赖。
• 主程序CUDA配置缺失：主程序的CMake配置未声明CUDA语言支持，CMake不会为纯cpp的可执行目标执行CUDA设备符号解析步骤，无法关联静态库中的CUDA设备符号与依赖库的符号。
• 架构配置不一致：静态库和可执行目标的CUDA架构配置未对齐，导致设备链接阶段符号无法匹配。

修复步骤 #

1. 修改MyLib的CMakeLists.txt #

cmake_minimum_required(VERSION 3.17 FATAL_ERROR)
project(MyLib LANGUAGES CXX CUDA)

find_package(CUDAToolkit REQUIRED)

add_library(${PROJECT_NAME} STATIC mylib.h mylib.cu)

target_compile_options(${PROJECT_NAME} PRIVATE "$<$<AND:$<CONFIG:Debug>,$<COMPILE_LANGUAGE:CUDA>>:-G;-src-in-ptx>")

# 替换为你实际显卡支持的算力，或者写Auto让CMake自动检测本机显卡
set_target_properties(${PROJECT_NAME} PROPERTIES CUDA_ARCHITECTURES "Auto")
set_target_properties(${PROJECT_NAME} PROPERTIES CUDA_SEPARABLE_COMPILATION ON)
set_target_properties(${PROJECT_NAME} PROPERTIES CUDA_RESOLVE_DEVICE_SYMBOLS ON)

# 链接官方导入目标，自动引入cudart和动态并行必须的cudadevrt
target_link_libraries(${PROJECT_NAME} PRIVATE CUDA::cudart CUDA::cudadevrt)

2. 修改主程序的CMakeLists.txt #

cmake_minimum_required(VERSION 3.17 FATAL_ERROR)
# 声明CUDA语言支持，启用设备链接流程
project(CUDA_Dynamic_Parallelism LANGUAGES CXX CUDA)

add_executable(${PROJECT_NAME} main.cpp)
# 和静态库保持架构配置一致
set_target_properties(${PROJECT_NAME} PROPERTIES CUDA_ARCHITECTURES "Auto")
set_target_properties(${PROJECT_NAME} PROPERTIES CUDA_SEPARABLE_COMPILATION ON)
set_target_properties(${PROJECT_NAME} PROPERTIES CUDA_RESOLVE_DEVICE_SYMBOLS ON)

target_link_libraries(${PROJECT_NAME} PRIVATE MyLib)

3. 额外验证项 #

• 确认你的CUDA 11.4版本支持目标显卡的算力，CUDA 11.4最高支持到算力8.7，兼容86架构。
• 如果需要分发二进制，可以把CUDA_ARCHITECTURES设置为你需要兼容的所有算力版本，例如"52 61 75 86"覆盖常见消费级显卡架构。

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