Flutter Rust Bridge 中处理 serde_json::Value 的内存管理问题

在 Flutter 和 Rust 混合开发中，Flutter Rust Bridge 是一个非常实用的工具，它允许 Dart 代码直接调用 Rust 函数。然而，当涉及到复杂数据结构如 serde_json::Value 时，开发者可能会遇到一些棘手的内存管理问题。

问题背景

当我们在 Rust 中定义一个包含 serde_json::Value 的结构体，并使用 #[frb(non_opaque)] 标记使其对 Dart 可见时，可能会遇到一个特殊问题：在 Dart 端调用该结构体的方法（如 to_json()）后，结构体中的 serde_json::Value 字段会被标记为已释放（disposed），导致无法再次使用该结构体。

问题复现

考虑以下 Rust 结构体定义：

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
#[flutter_rust_bridge::frb(non_opaque)]
pub struct MyStruct {
    pub counter: i32,
    pub data: serde_json::Value,
}

在 Dart 端调用 to_json() 方法后，再次访问该结构体会抛出 DroppableDisposedException 异常，提示尝试使用已被释放的 RustArc。

问题分析

这个问题的根本原因在于 Flutter Rust Bridge 的内存管理机制。当 Dart 调用 Rust 方法时，涉及到的数据可能会被自动释放，特别是对于非基本类型的复杂数据结构。serde_json::Value 作为一种动态 JSON 值类型，其所有权管理需要特别注意。

解决方案

方案一：使用 RustAutoOpaque 包装

最直接的解决方案是使用 RustAutoOpaque 包装 serde_json::Value：

#[flutter_rust_bridge::frb(non_opaque)]
pub struct MyStruct {
    pub counter: i32,
    pub data: RustAutoOpaque<serde_json::Value>,
}

这种方法通过 RustAutoOpaque 提供的智能指针机制，可以避免数据被过早释放。不过需要注意的是，这可能会影响结构体的序列化能力。

方案二：自定义序列化

如果需要保持结构体的序列化能力，可以实现自定义的序列化逻辑：

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
#[flutter_rust_bridge::frb(non_opaque)]
pub struct MyStruct {
    pub counter: i32,
    #[serde(serialize_with = "serialize_value", deserialize_with = "deserialize_value")]
    pub data: serde_json::Value,
}

这种方法需要开发者自行实现 serialize_value 和 deserialize_value 函数，但可以保持完整的序列化能力。

最佳实践建议

1. 对于不需要序列化的场景，优先使用 RustAutoOpaque 方案，它提供了最可靠的内存管理。

2. 如果需要序列化功能，考虑将 serde_json::Value 转换为字符串形式存储，在需要时再解析：

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct MyStruct {
    pub counter: i32,
    pub data_json: String,
}

impl MyStruct {
    pub fn data(&self) -> serde_json::Value {
        serde_json::from_str(&self.data_json).unwrap()
    }
}

3. 对于性能敏感的场景，可以考虑使用 Arc<RwLock> 来共享数据，但需要注意线程安全问题。

总结

在 Flutter Rust Bridge 中使用 serde_json::Value 时，开发者需要特别注意内存管理问题。通过合理选择 RustAutoOpaque 包装或自定义序列化方案，可以避免数据被意外释放的问题。理解这些底层机制有助于开发出更健壮的跨语言应用程序。