含CUDA代码的Node Addon模块在Docker容器中运行时出现链接错误

针对你遇到的__cudaRegisterFatBinary符号未定义错误（即使nm显示符号已存在），可尝试以下几种解决方案：

1. 调整链接库顺序 #

GNU链接器的符号解析是从左到右进行的，依赖符号的库需要放在提供符号的库之前。将你的CUDA静态库移到CUDA官方库前面：

"libraries": [
      "/usr/src/app/libgpu.lib",
      "/usr/local/cuda/lib64/libcudart_static.a",
      "/usr/local/cuda/lib64/libcudadevrt.a",
      "/usr/local/cuda/lib64/libculibos.a"
],

2. 添加缺失的CUDA静态库 #

使用-rdc=true（可重定位设备代码）编译时，除了libcudart_static.a，还需要链接设备端运行时库libcudadevrt.a和CUDA工具库libculibos.a，这些是CUDA静态链接的必要依赖。

3. 修改静态库编译命令 #

在生成静态库的dlink步骤中，明确关联必要的静态库，避免依赖缺失：

nvcc --compiler-options '-fPIC' -rdc=true -c -o temp.o cuda_lib.cu
nvcc --compiler-options '-fPIC' -dlink -o gpuCode.o temp.o -lcudart_static -lcudadevrt
ar cru libgpu.lib gpuCode.o temp.o
ranlib libgpu.lib

4. 强制保留静态库符号 #

如果链接器优化丢弃了未被直接引用的CUDA符号，可通过--whole-archive选项强制保留：

"ldflags": [
  "-Wl,--whole-archive",
  "/usr/src/app/libgpu.lib",
  "-Wl,--no-whole-archive",
  "/usr/local/cuda/lib64/libcudart_static.a",
  "/usr/local/cuda/lib64/libcudadevrt.a",
  "/usr/local/cuda/lib64/libculibos.a"
],

注意：--whole-archive仅包裹你的CUDA静态库，避免过度包含其他库的冗余符号。

5. 验证Docker环境的CUDA路径 #

确保容器中/usr/local/cuda/lib64下存在所需静态库，可执行命令确认：

ls /usr/local/cuda/lib64/libcudart_static.a /usr/local/cuda/lib64/libcudadevrt.a

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