在Bazel项目中正确使用cxxbridge实现Rust与C++互调

在使用Bazel构建系统结合rules_rust规则集时，开发者经常会遇到Rust与C++互操作的问题。本文将以cxx项目为例，详细介绍如何正确配置Bazel项目来实现C++调用Rust函数的功能。

问题背景

当开发者尝试在Bazel项目中使用cxxbridge-cmd工具生成Rust与C++之间的绑定代码时，可能会遇到生成的C++代码无法找到对应的Rust函数实现的问题。具体表现为链接阶段报错，提示缺少cxxbridge1$my_rust_fn这样的符号。

根本原因分析

经过深入排查，发现问题的根源在于Bazel/rules_rust对crate根文件的推断行为与预期不符。在构建过程中，Bazel未能正确识别和处理包含cxx桥接代码的Rust模块，导致以下两种情况：

1. 当桥接Rust模块直接列在rust_static_library目标的srcs中时，crate根文件需要显式声明mod来包含该桥接模块
2. 当桥接Rust模块通过独立的rust rlib Bazel目标提供时，crate根文件需要使用use来引入该crate

解决方案

方案一：直接包含桥接模块

当桥接Rust代码直接作为静态库源文件时，需要在crate根文件中明确声明模块关系：

// lib.rs
mod bridge;  // 确保桥接模块被正确包含

相应的BUILD文件配置示例：

rust_static_library(
    name = "my_lib",
    srcs = [
        "lib.rs",
        "bridge.rs",  # 包含cxx桥接文件
    ],
    # 其他配置...
)

方案二：通过独立crate引入

更推荐的做法是将桥接代码组织为独立的Rust库，然后在主库中引用：

// lib.rs
use my_bridge;  // 使用独立的桥接crate

对应的BUILD文件配置：

rust_library(
    name = "my_bridge",
    srcs = ["bridge.rs"],  # 包含cxx桥接文件
    # 其他配置...
)

rust_static_library(
    name = "my_lib",
    srcs = ["lib.rs"],
    deps = [":my_bridge"],  # 依赖桥接crate
    # 其他配置...
)

注意事项

1. 确保在桥接Rust文件中正确使用了cxx宏，例如：

   #[cxx::bridge]
   mod ffi {
       extern "Rust" {
           fn my_rust_fn() -> i32;
       }
   }
   

2. 在C++侧，确保包含了生成的桥接头文件，并正确链接Rust静态库

3. 检查Bazel工具链配置，确保rules_rust和cxx相关依赖版本兼容

总结

在Bazel项目中使用cxx实现Rust与C++互操作时，关键在于正确处理模块的组织和依赖关系。通过明确声明模块或合理组织crate结构，可以确保cxx桥接代码被正确生成和处理。这种配置方式不仅适用于简单的函数调用，也为更复杂的类型共享和回调机制奠定了基础。

对于初次接触Bazel和Rust/C++互操作的开发者，建议从简单示例开始，逐步验证每个构建环节，确保理解Bazel构建过程中各个组件的关系和作用。