集群环境下GCC链接FFTW 3.3.5库出现未定义引用错误的原因排查

核心问题根因排查点 #

• gcc链接顺序完全错误
  gcc的链接解析规则是从左到右扫描目标文件与依赖库：当遇到目标文件/源文件时，会记录下其中未定义的外部符号；当扫描到依赖库时，才会从库中匹配前面记录的未定义符号完成解析。
  你之前写的两个编译命令都违反了这个规则：不管是直接写静态库全路径的第一条命令，还是用-lfftw3的第二条命令，都把FFTW库放在了源文件fftwCPU.c的前面。gcc扫描到FFTW库的时候，还没有遇到源文件里的fftw函数调用，根本不会从库中提取对应符号，直接跳过库内容继续扫描，最后自然抛出所有fftw相关函数的未定义引用错误。
  另外需要明确：LD_LIBRARY_PATH是运行时动态链接器查找动态库的路径配置，对编译阶段的库查找、静态库链接完全没有影响，不能用这个配置替代编译时的-L路径指定。
• 调用接口与实际安装的FFTW库不匹配
  FFTW的不同精度接口对应完全独立的库文件，不存在兼容关系：
  • fftw_*开头的双精度接口，对应库文件libfftw3.a/libfftw3.so，编译FFTW时默认只生成这个版本
  • fftwf_*开头的单精度接口，需要编译时显式开启--enable-float选项，才会生成对应的libfftw3f.a/libfftw3f.so
    集群上安装的这个FFTW是搭配MVAPICH2 MPI环境编译的，大概率默认只安装了双精度版本的库，没有生成单精度的libfftw3f系列文件。如果你用单精度的fftwf_*接口哪怕把链接顺序调对，也会因为找不到对应符号报错；反过来如果库只装了单精度版本，用双精度的fftw_*接口同样会失败。
• 静态库ABI兼容性问题
  这个路径下的FFTW是用GCC 4.9.3版本编译生成的静态库，如果你当前集群登录节点的gcc版本和4.9.3差距过大（比如使用GCC 10+版本），会因为C语言符号、C++运行时ABI不匹配，导致库中的函数符号无法被正常识别。

快速验证方法 #

可以直接通过以下两个命令快速定位问题：

1. 查看库目录下实际存在的FFTW库文件：
   ls /cm/extra/apps/FFTW/3.3.5/GCC-4.9.3_MVAPICH2-2.2-GDR/lib/ | grep fftw
   根据输出的文件名，判断库支持的精度类型，对应选择匹配的接口和链接参数
2. 检查库中是否包含你调用的目标函数：
   nm /cm/extra/apps/FFTW/3.3.5/GCC-4.9.3_MVAPICH2-2.2-GDR/lib/libfftw3.a | grep fftw_plan_dft_1d
   如果命令没有任何输出，说明这个库根本不包含你代码里调用的接口，需要更换对应版本的库。

正确的编译命令示例 #

如果库目录下只有双精度版本的libfftw3文件，且代码用的是双精度fftw_*接口，正确编译命令为：
gcc -o fftw.out fftwCPU.c -L/cm/extra/apps/FFTW/3.3.5/GCC-4.9.3_MVAPICH2-2.2-GDR/lib/ -lfftw3 -lm

如果库目录下存在单精度版本的libfftw3f文件，且代码用的是单精度fftwf_*接口，正确编译命令为：
gcc -o fftw.out fftwCPU.c -L/cm/extra/apps/FFTW/3.3.5/GCC-4.9.3_MVAPICH2-2.2-GDR/lib/ -lfftw3f -lm

如果需要链接静态库，调整顺序后的写法为：
gcc -o fftw.out fftwCPU.c /cm/extra/apps/FFTW/3.3.5/GCC-4.9.3_MVAPICH2-2.2-GDR/lib/libfftw3.a -lm

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