Android中使用FreeType2返回负数值指针问题排查

问题背景 #

我在Android应用中通过NDK使用FreeType2，操作流程如下：

• 下载FreeType并解压至cpp文件夹
• 在CMakeLists中引入FreeType
• 代码可正常编译并在模拟器运行

但连接真机时出现异常，Activity操作步骤：

• 通过System.loadlibrary('mylib')加载库
• 经JNI调用C++代码
• 调用初始化FreeType的函数（FT_Init_FreeType），返回库句柄（jlong）

模拟器返回正常句柄，但真机返回类似-547637666626...的大负数值，不符合正常指针/句柄特征。

异常代码（仅真机失效） #

/*********THIS DOESNT WORK ON real USB connected device ******    
extern "C"
JNIEXPORT jlong JNICALL
Java_com_pearlspotsystems_nativecppwithft_MainActivity_getFTLibrary(JNIEnv *env, jobject thiz) 
{
      FT_Library library;

      int major, minor, patch;
      long err = FT_Init_FreeType(&library);
      if(err) {
        return 0;
      } else {
         return (jlong) library;
      }
}

正常代码（真机/模拟器均有效） #

/********THIS WORKS ON BOTH EMULATOR and REAL DEVICE!!!!***/
extern "C"
JNIEXPORT jstring JNICALL
Java_com_pearlspotsystems_nativecppwithft_MainActivity_getFreeTypeVersion(JNIEnv *env,
                                                                     jobject thiz) {
FT_Library library;
int major, minor, patch;
long err = FT_Init_FreeType(&library);
if(err) {
    std::string err_string = "Error!!!!!!!";
    return env->NewStringUTF(err_string.c_str());
} else {
    FT_Library_Version((FT_Library) library, &major, &minor, &patch);
    std::string ret_string = "FT-Version:" + std::to_string(major) + "." + 
    std::to_string(minor);
    return env->NewStringUTF(ret_string.c_str());
}
}

疑问 #

1. 是否是FT_Library转jlong的问题？还是其他原因？
2. 为何模拟器可正常运行？
3. 为何获取版本的函数在真机和模拟器都正常？

排查方向 #

1. 指针类型转换规范问题 #

JNI中jlong是有符号64位整数类型，而FT_Library本质是无符号指针地址。直接用C风格强制转换(jlong)library时，若真机内存地址的最高位为1，会触发符号扩展，导致无符号指针被转成有符号的大负数。
正确的转换方式应使用reinterpret_cast保证指针值完整转换：

return reinterpret_cast<jlong>(library);

2. 架构位宽不匹配 #

模拟器可能为32位架构（如armeabi-v7a），指针为32位，转成64位jlong时自动零扩展显示为正数；而真机多为64位架构（arm64-v8a），指针是64位，若地址落在高半区（最高位为1），转成有符号jlong就会显示为负数。
检查CMakeLists中的ABI配置：确认编译了真机对应的ABI（如arm64-v8a），且FreeType的编译目标ABI与Native库一致，避免跨架构的指针位宽差异。

3. 句柄有效性验证 #

真机返回的负数并非一定是无效句柄，只是jlong的有符号类型导致显示异常。可以尝试用返回值继续调用FreeType API（如FT_Done_FreeType），若能正常执行无崩溃，说明句柄实际有效，仅显示形式异常。

4. 错误码类型匹配问题 #

FT_Init_FreeType的返回值是FT_Error类型（32位整数），代码中用long接收可能存在类型截断风险。应改为：

FT_Error err = FT_Init_FreeType(&library);

避免因类型不匹配导致错误判断（比如真机上错误码被错误转换为0，进入返回指针的分支）。

5. 内存布局差异 #

真机的内存布局与模拟器不同，FreeType初始化后句柄指向的地址可能落在高地址区域，但这不影响实际使用，仅转换为有符号jlong时显示为负数。

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