使用NDK工具链编译的Android Qt应用启动触发段错误

问题背景 #

• 纯C++程序用NDK 20.0.5594570交叉编译arm64-v8a架构，推送至三星A73的/data目录运行正常。
• 引入Qt 5.15.2（同NDK版本编译的arm64-v8a库）后，编译成功的可执行文件+依赖库推送至/data目录，设置LD_LIBRARY_PATH后启动触发Segmentation Fault，栈回溯指向libQt5Core_arm64-v8a.so中的QJNIEnvironmentPrivate初始化，且ldd无法识别Qt核心库与libc++_shared.so。

核心原因 #

1. JNI环境缺失：Qt 5.15.2的Android核心库依赖Android应用框架提供的JNI运行时上下文，直接通过shell启动裸可执行文件时，系统未初始化JNIEnv，导致QJNIEnvironmentPrivate初始化时访问空指针，触发SIGSEGV。
2. ldd识别问题：Android shell自带的ldd工具与交叉编译的库的ABI/工具链版本不匹配，属于工具兼容性问题，并非崩溃的直接原因。

解决方案 #

1. 正确运行方式：打包为Android APK（推荐） #

Qt for Android程序无法作为裸可执行文件独立运行，必须依托Android应用容器：

• 使用Qt Creator创建Android项目，配置NDK 20.0.5594570与Qt 5.15.2，编译生成APK。
• 安装APK后，通过adb shell run-as <你的应用包名>进入应用私有目录，运行目录内的可执行文件——此时进程已处于应用容器中，系统会自动初始化JNI环境。

2. 调试用：借助app_process启动（手动注入JNI环境） #

若需在/data目录临时调试，可使用Android系统自带的app_process工具（该工具会自动初始化JNI环境）：

adb shell LD_LIBRARY_PATH=/data/QHELLO_WORLD_DIR app_process /data/QHELLO_WORLD_DIR com.example.QHelloWorldEntry

注：com.example.QHelloWorldEntry需对应一个实现了入口逻辑的类，或直接指向Qt程序的入口（确保JNI环境被正确注入）。

3. 确保库依赖配置正确 #

• 确认推送的libc++_shared.so是NDK 20.0.5594570中arm64-v8a版本，路径为：

  $NDK_ROOT/toolchains/llvm/prebuilt/<你的主机系统>/sysroot/usr/lib/aarch64-linux-android/libc++_shared.so
  

• 启动时正确设置库路径：

  adb shell export LD_LIBRARY_PATH=/data/QHELLO_WORLD_DIR:$LD_LIBRARY_PATH && /data/QHELLO_WORLD_DIR/QHELLO_WORLD
  

  （此步骤仅解决库加载问题，无法替代JNI环境）

4. 深入调试建议 #

使用NDK自带的gdb工具调试崩溃细节：

1. 手机端启动gdbserver：

   adb shell gdbserver :1234 /data/QHELLO_WORLD_DIR/QHELLO_WORLD
   

2. 本地用交叉编译gdb连接：

   $NDK_ROOT/toolchains/llvm/prebuilt/<你的主机系统>/bin/aarch64-linux-android-gdb
   (gdb) target remote <手机IP>:1234
   

   此时可查看完整栈回溯，定位JNI初始化失败的具体代码位置。

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