在Buildroot中构建Rust应用：cargo离线锁定构建报错问题

环境与配置 #

我基于Cargo创建了一个Rust应用的Buildroot包，编写的.mk文件如下：

MY_RUST_APP_VERSION = 1.1.0
MY_RUST_APP_SITE = $(BR2_EXTERNAL_PATH)/package/my-rust-app
MY_RUST_APP_SUBDIR = my-rust-app
MY_RUST_APP_SITE_METHOD = local

# Release build for smaller size and faster execution
# cargo already builds as --release by default in buildroot
#MY_RUST_APP_CARGO_BUILD_OPTS = --release

$(eval $(cargo-package))

当Cargo.toml无外部依赖时构建正常，但添加tracing依赖后构建失败：

[dependencies]
tracing = "0.1.40"

报错信息 #

Buildroot输出的错误：

error: no matching package named `tracing` found
location searched: registry `crates-io`
required by package `my-rust-app v1.1.0`
As a reminder, you're using offline mode (--offline) which can sometimes cause surprising resolution failures, if this error is too confusing you may wish to retry without the offline flag.

排查发现Buildroot默认调用Cargo时添加了--offline和--locked参数，导致无法拉取新依赖。执行make my-rust-app-dirclean && make my-rust-app-reconfigure无效，Buildroot的dl目录中也找不到Rust依赖文件，但本地直接执行cargo build可成功构建。

解决方法 #

方法1：临时禁用离线和锁定参数（快速调试用） #

直接在.mk文件中添加以下配置，覆盖Buildroot的默认行为，让Cargo可以联网拉取依赖：

MY_RUST_APP_CARGO_OFFLINE = NO
MY_RUST_APP_CARGO_LOCKED = NO

添加后清理并重新构建：

make my-rust-app-dirclean
make my-rust-app

方法2：预下载依赖（符合Buildroot离线构建规范，推荐） #

Buildroot的设计原则是支持离线构建，因此更推荐提前把依赖下载到本地，避免联网需求：

1. 在本地Rust项目目录执行以下命令，生成包含所有依赖的vendor目录：

   cargo vendor
   

2. 执行cargo build生成Cargo.lock文件，确保依赖版本被锁定
3. 将vendor目录和Cargo.lock文件一起放到你的BR2_EXTERNAL包目录中（和Cargo.toml同目录）
4. 在.mk文件中添加以下配置，让Buildroot使用本地的预下载依赖：

   MY_RUST_APP_CARGO_VENDOR_DIR = $(MY_RUST_APP_SITE)/vendor
   MY_RUST_APP_CARGO_LOCKED = YES
   

5. 清理并重新构建：

   make my-rust-app-dirclean
   make my-rust-app
   

方法3：强制清理所有相关构件 #

如果之前的清理操作无效，可以尝试更彻底的清理：

make clean
make my-rust-app

内容的提问来源于stack exchange，提问作者Filip Kubicz