使用NVIDIA Video SDK 8.1静态链接libnvcuvid.so失败求助

你遇到的这个问题在NVIDIA SDK版本切换时很常见，我来帮你梳理下可能的原因和对应的解决办法：

先明确你的场景 #

之前用旧版NVIDIA Video SDK时，你通过动态加载libnvcuvid.so的函数指针来调用NVDEC，库路径是/usr/lib/nvidia-396/，包含这些文件：

/usr/lib/nvidia-396/libnvcuvid.so
/usr/lib/nvidia-396/libnvcuvid.so.1
/usr/lib/nvidia-396/libnvcuvid.so.396.18

升级到SDK 8.1后，API改成了extern声明的静态链接模式——Windows平台有配套的nvcuvid.lib，但Linux只有上述SO文件。你已经确认IDE能找到库路径（移除路径会提示找不到库），链接方式和同目录的cuda.so、cudart.so一致，但所有cuvid相关函数都报undefined reference错误，驱动版本396.18也满足SDK 8.1最低390的要求，你的链接命令是：

/usr/bin/g++ -o bin/xxxxx_xxx_d @"xxxxx_xxx.txt" -L. -LDebug -L/usr/lib/nvidia-396 -L/usr/local/cuda-9.1/lib64 -lcuda -lcudart -lnvcuvid .....

可能的原因及解决方案 #

1. 链接顺序搞反了（最容易踩的坑） #

GCC的链接器是按顺序处理依赖的：如果某个库依赖另一个库，依赖库必须放在被依赖库的后面。你的链接命令里-lnvcuvid放在了前面，可能在处理引用它的目标文件之前就已经跳过了，导致链接器找不到对应的符号。

解决办法：把-lnvcuvid移到链接命令的最后，放在所有目标文件和其他依赖库之后。调整后的命令大概是这样：

/usr/bin/g++ -o bin/xxxxx_xxx_d @"xxxxx_xxx.txt" -L. -LDebug -L/usr/lib/nvidia-396 -L/usr/local/cuda-9.1/lib64 -lcuda -lcudart ..... -lnvcuvid

2. 库的符号没导出 #

Linux下的SO文件可能默认隐藏了内部符号，旧版你用动态加载函数指针的方式，不依赖符号表的可见性，但静态链接需要符号被导出到动态符号表中。NVIDIA的libnvcuvid.so在部分驱动版本中，可能没把cuvid的API符号公开出来。

验证方法：在终端运行这个命令，查看库中是否有你需要的cuvid函数符号：

nm -D /usr/lib/nvidia-396/libnvcuvid.so | grep cuvid

如果输出为空或者只有寥寥几个符号，说明符号被隐藏了。

解决办法：

• 查SDK 8.1的Linux官方文档，确认是否需要特定的编译/链接选项（比如-Wl,--no-undefined），或者是否有配套的静态库（有些SDK会把静态链接的符号放在单独的.a文件里，SO仅用于动态加载）。
• 如果确实没有导出符号，可能需要暂时回到动态加载函数指针的老办法，或者升级驱动到更新的版本（比如418.x及以上），新版本的驱动可能修复了符号导出的问题。

3. 头文件和库的ABI不匹配 #

SDK 8.1的头文件可能定义了新的函数签名或ABI，而你用的396.18驱动版本的libnvcuvid.so虽然满足最低版本要求，但可能还没实现这些新的API，或者函数签名有差异。

验证方法：

• 对比旧版SDK和8.1的头文件，看看cuvidCreateDecoder这类核心函数的参数是否有变化。
• 用这个命令查看库中的函数签名，和头文件对比：

  objdump -T /usr/lib/nvidia-396/libnvcuvid.so | grep cuvidCreateDecoder
  

解决办法：

• 确保使用的头文件和驱动版本完全匹配，或者升级驱动到更适配SDK 8.1的版本。
• 检查编译时是否定义了SDK要求的宏（比如NVDEC_API_VERSION），保证头文件和库的版本对齐。

4. 32位/64位架构不匹配 #

如果你的程序是32位的，但libnvcuvid.so是64位的（或者反过来），也会出现链接错误。

验证方法：分别查看库和生成的可执行文件的架构：

# 查看库的架构
file /usr/lib/nvidia-396/libnvcuvid.so
# 查看可执行文件的架构
file bin/xxxxx_xxx_d

确保两者的架构一致（比如都是x86_64）。

解决办法：调整编译选项，比如用-m32编译32位程序，或者使用对应架构的库文件。

总结 #

建议你先从调整链接顺序开始排查，这是Linux链接中最常见的问题。如果不行，再检查符号是否导出。这两个方向解决不了的话，再去核对ABI和架构的问题。

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