Flutter Rust Bridge 中使用 SQLite 的 Android x86_64 兼容性问题解决方案

在 Flutter 应用开发中，通过 Flutter Rust Bridge 集成 Rust 代码时，使用 SQLite 数据库会遇到一个典型的兼容性问题：在 Android x86_64 模拟器上运行时出现动态库加载失败的情况。本文将深入分析这个问题并提供完整的解决方案。

问题现象

当开发者在 Flutter 项目中通过 Flutter Rust Bridge 集成 Rust 代码，并使用 SQLite 作为存储方案时，在 iOS 模拟器和真实设备上运行正常，但在 Android x86_64 架构的模拟器上会出现以下错误：

Failed to load dynamic library 'librust_lib_frb_sqlite.so': dlopen failed: cannot locate symbol "__extenddftf2"

这个错误表明系统无法找到 __extenddftf2 这个符号，这是典型的 Android x86_64 架构兼容性问题。

问题根源

经过分析，这个问题主要源于以下几个方面：

1. Android x86_64 模拟器的特殊限制：x86_64 架构的 Android 模拟器对某些符号的支持不完整，特别是与浮点运算相关的符号。

2. SQLite 依赖链：当使用 Rust 的 SQLite 绑定库（如 rusqlite）时，它会依赖 libsqlite3-sys，后者在编译时会引入一些特定的符号。

3. 符号冲突：在 Android x86_64 环境下，某些必要的符号可能被重复定义或缺失，导致动态库加载失败。

解决方案

方法一：修改构建配置

最彻底的解决方案是通过修改构建配置来避免使用有问题的符号。具体步骤如下：

1. 在 Rust 项目根目录下创建 build.rs 文件

2. 添加以下构建脚本内容：

fn main() {
    #[cfg(target_os = "android")]
    println!("cargo:rustc-link-lib=c++_shared");
    
    // 针对 Android x86_64 的特殊处理
    if std::env::var("TARGET").unwrap().contains("x86_64-linux-android") {
        println!("cargo:rustc-cdylib-link-arg=-Wl,--allow-multiple-definition");
    }
}

3. 确保 Android 构建环境变量已正确设置

方法二：添加必要的共享库

另一种解决方案是确保必要的共享库被正确包含：

1. 在 Flutter 项目的 android/app/src/main 目录下创建 jniLibs 文件夹

2. 将 libc++_shared.so 文件复制到对应架构的子目录中，例如：

   • jniLibs/x86_64/
   • jniLibs/armeabi-v7a/
   • jniLibs/arm64-v8a/

3. 确保这些共享库与目标架构匹配

注意事项

1. 真实设备测试：虽然这个问题主要出现在 x86_64 模拟器上，但建议在真实 Android 设备上进行验证，确保所有架构都能正常工作。

2. 构建工具链：确保使用最新的 Android NDK 和 Rust 工具链，旧版本可能存在已知的兼容性问题。

3. 依赖版本：检查并更新所有相关依赖，包括 rusqlite、libsqlite3-sys 等，确保使用最新稳定版本。

结论

通过上述解决方案，开发者可以成功在 Flutter Rust Bridge 项目中集成 SQLite 数据库，并解决 Android x86_64 模拟器上的兼容性问题。这种问题在跨平台开发中较为常见，理解其背后的原理有助于开发者更好地处理类似的技术挑战。

对于 Flutter 与 Rust 的混合开发，建议开发者建立完善的跨平台测试流程，覆盖所有目标架构和设备类型，确保应用的稳定性和兼容性。