背景

Rust 的安全保证在 FFI 边界需要重新建立。一个有效指针还不够,还要说明长度、所有权、调用线程和释放函数。

核心判断

  1. 把 unsafe 收敛到薄适配层并写出可验证的安全前提。
  2. 明确借用指针是否被外部库保存,以及返回资源如何释放。
  3. 跨边界处理错误码与 panic,不让未约定的异常穿过 ABI。

最小示例

下面保留核心逻辑;业务类型、调用入口和环境配置按项目补齐。

pub fn parse(bytes: &[u8]) -> Result<Value, Error> {
    // SAFETY: ffi_parse 在调用期间只读取 ptr..ptr+len,
    // 不保存指针;返回独立拥有的句柄,由 Value 的 Drop 释放。
    unsafe {
        ffi_parse(bytes.as_ptr(), bytes.len()).map(Value::from_raw)
    }
}

边界与误区

示例假定外部 parser 只在调用期间读取输入,不保留指针,且返回有效的拥有型句柄。若 Value 借用输入,必须携带正确生命周期,不能返回任意长寿命值。

验证方式

覆盖空输入、无效字节、错误返回和重复释放;用外部库的 sanitizer 与 Rust 测试联合检查,线程约束写进类型或入口检查。

小结

把 unsafe 集中在薄适配层,明确分配释放、指针有效期和线程约束。