Android NDK项目无法链接FFTW3线程库：未定义符号问题求助

问题根源 #

这个链接错误说白了就是链接器找不到fftwf_threads_set_callback的实现，大概率是FFTW编译配置缺了关键参数，或是CMake里的库链接逻辑出错——比如链接了错误版本的库、顺序不对，甚至重复编译导致配置冲突。

一步步修复 #

1. 重新编译FFTW（确保适配Android） #

你之前的编译命令没指定NDK交叉编译工具链，很可能导致生成的库和Android不兼容。按下面步骤重新编译：

# 先清理之前的编译残留
make clean

# 配置NDK工具链（替换成你自己的NDK路径）
export ANDROID_NDK_HOME=/Users/yourname/Library/Android/sdk/ndk/25.2.9519653
export TOOLCHAIN=$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/darwin-x86_64
export AR=$TOOLCHAIN/bin/aarch64-linux-android-ar
export CC=$TOOLCHAIN/bin/aarch64-linux-android33-clang
export CXX=$TOOLCHAIN/bin/aarch64-linux-android33-clang++
export LD=$TOOLCHAIN/bin/aarch64-linux-android-ld
export RANLIB=$TOOLCHAIN/bin/aarch64-linux-android-ranlib
export STRIP=$TOOLCHAIN/bin/aarch64-linux-android-strip

# 重新配置编译，指定专属安装目录（避免全局安装混乱）
./configure \
--host=aarch64-none-linux-android33 \
--enable-threads \
--enable-float \
--prefix=/Users/yourname/fftw-android-arm64

# 并行编译+安装
make -j$(sysctl -n hw.ncpu) # Mac用这个获取CPU核心数加速编译
make install

编译完成后去指定的安装目录lib下检查，必须存在libfftw3f.so（浮点基础库）和libfftw3f_threads.so（浮点线程扩展库），缺一个都不行。

2. 修正CMakeLists.txt配置 #

别用add_subdirectory(fftwf)重新编译FFTW了，直接导入你刚编译好的预编译库，避免CMake重复编译出冲突：

add_library(demo SHARED native-lib.cpp)

# 导入FFTW浮点基础库
add_library(fftw3f SHARED IMPORTED)
set_target_properties(fftw3f PROPERTIES
    IMPORTED_LOCATION "/Users/yourname/fftw-android-arm64/lib/libfftw3f.so"
    INTERFACE_INCLUDE_DIRECTORIES "/Users/yourname/fftw-android-arm64/include"
)

# 导入FFTW浮点线程库
add_library(fftw3f_threads SHARED IMPORTED)
set_target_properties(fftw3f_threads PROPERTIES
    IMPORTED_LOCATION "/Users/yourname/fftw-android-arm64/lib/libfftw3f_threads.so"
    INTERFACE_INCLUDE_DIRECTORIES "/Users/yourname/fftw-android-arm64/include"
)

# 链接库！重点：线程库要放在基础库前面，因为线程库依赖基础库的符号
target_link_libraries(demo
    fftw3f_threads
    fftw3f
    m  # 数学库，FFTW依赖它
    log # 可选，Android日志库
)

另外你之前的target_include_directories写错了目标库（写的fbi而非demo），直接删掉那些冗余配置，用上面的INTERFACE_INCLUDE_DIRECTORIES即可自动关联头文件路径。

3. 简化build.gradle配置 #

把cppFlags里的链接参数全部删掉，链接逻辑交给CMake处理，避免两边配置冲突：

externalNativeBuild {
    cmake {
        cppFlags "-O3 -g --std=c++17 -fopenmp"
        arguments "-DANDROID_STL=c++_shared" # 使用C++标准库时建议加上
    }
}

4. 简化头文件引用 #

代码里直接写#include <fftw3.h>即可，CMake已经帮你指定了头文件路径，不用写冗长的相对路径。

验证步骤 #

1. 清理旧构建产物：./gradlew clean
2. 重新构建项目：./gradlew assembleDebug
3. 若仍报错，检查库的符号是否存在：

   $TOOLCHAIN/bin/aarch64-linux-android-nm -D /Users/yourname/fftw-android-arm64/lib/libfftw3f_threads.so | grep fftwf_threads_set_callback
   

   能输出该符号说明库没问题，再检查CMake/gradle配置；没输出则回到第一步重新编译FFTW。

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