Android集成MLKit translate SDK 16.1.2 Release构建原生崩溃排查

参照Google ML Kit官方Android翻译开发指南实现文本翻译功能，依赖版本为com.google.mlkit:translate:16.1.2。该功能在Debug构建下运行正常，但Release构建会触发原生层崩溃，报错信息为：Fatal signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 0x78f4752a0a in tid 5897；若将Release构建设置为debuggable，崩溃不再出现。测试设备为Pixel 3a（Android 11）。

可能的原因及修复方案 #

1. R8/ProGuard混淆规则缺失 #

• ML Kit翻译模块的原生绑定类、JNI接口如果被混淆重命名或者移除，会导致原生层调用Java层方法时找不到对应引用，触发非法内存访问错误。debuggable开关默认会关闭部分混淆优化，同时保留更多符号信息，所以开启后崩溃消失是典型的混淆问题特征。
• 修复方案：在ProGuard规则文件中添加ML Kit翻译模块的官方保留规则，同时保留JNI相关类的完整签名。

2. 原生库裁剪/压缩配置问题 #

• Release构建默认开启minifyEnabled、shrinkResources，部分情况下资源压缩会误删ML Kit依赖的原生.so库的必要段，或者压缩过程中破坏了原生库的重定位信息。debuggable模式下会禁用原生库的压缩与裁剪，因此不会触发崩溃。
• 修复方案：在build.gradle的packagingOptions中排除ML Kit相关原生库的压缩，示例配置如下：

android {
    packagingOptions {
        doNotStrip "**/libtranslate*.so"
    }
}

3. 编译优化选项导致的原生层兼容问题 #

• Release构建默认开启O2及以上级别的编译优化，部分优化逻辑会调整原生代码的内存布局，而com.google.mlkit:translate:16.1.2版本的翻译模块原生代码和Android 11的部分ART虚拟机优化存在兼容性冲突。debuggable模式下会降低编译优化等级，调整内存布局规则，因此规避了冲突。
• 修复方案：可以暂时升级ML Kit翻译依赖到17.0.1及以上版本，该版本已经修复了对应优化冲突问题；如果不能升级版本，可以在Release构建的build.gradle中添加配置关闭相关优化：

android {
    buildTypes {
        release {
            ndk {
                abiFilters "arm64-v8a", "armeabi-v7a"
                cppFlags "-O0"
            }
        }
    }
}

4. 翻译模型加载的时序问题 #

• Release构建下App启动速度更快，可能出现翻译模块初始化还未完成就调用翻译方法的情况，原生层访问未初始化的内存地址触发SIGSEGV。debuggable模式下App启动速度更慢，模块初始化完成后才会走到调用逻辑，因此不会触发崩溃。
• 修复方案：添加翻译模块初始化完成的回调监听，确认初始化成功、模型下载完成后再调用翻译接口。

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