自定义结构Rust项目使用Rocket宏编译失败问题排查

错误原因 #

Rocket框架的#[get]、#[launch]等宏在展开时，会生成基于crate根路径的绝对引用代码。你的工作区结构没有遵循Cargo默认的子crate布局规则：常规子crate会以独立目录存在（如api/下包含src/main.rs），而你将二进制crate的代码直接放在工作区根目录的src/api下，导致Cargo无法正确识别该二进制crate的独立根路径，宏生成的代码无法解析Rocket的内部模块路径，最终抛出绝对路径引用错误。

解决方法 #

不需要改变“将代码放在工作区src下”的结构，只需通过Cargo配置和代码属性明确crate的边界即可：

1. 修正工作区Cargo.toml配置 #

在工作区根目录的Cargo.toml中，直接定义库和二进制crate的入口路径、版本及依赖：

[workspace]
# 无需指定members，直接通过[[lib]]/[[bin]]定义子crate
members = []

# 配置core库crate
[[lib]]
name = "core"
path = "src/core/lib.rs"
edition = "2021" # 匹配你的Rocket版本要求的Rust版本

# 配置api二进制crate
[[bin]]
name = "api"
path = "src/api/main.rs"
edition = "2021"
# 继承工作区共享依赖
dependencies = { workspace = true }

# 工作区共享依赖
[workspace.dependencies]
rocket = { version = "0.5.0-rc.3", features = ["json"] } # 替换为你使用的Rocket版本

2. 为api二进制crate添加明确的crate属性 #

在src/api/main.rs的最顶部，添加crate名称和类型的声明，让Rocket宏能正确识别当前crate的根：

#![crate_name = "api"]
#![crate_type = "bin"]

use rocket::{get, launch, routes};

#[get("/")]
fn index() -> &'static str {
    "Hello, world!"
}

#[launch]
fn rocket() -> _ {
    rocket::build().mount("/", routes![index])
}

3. 验证编译 #

运行以下命令编译工作区：

cargo build

此时Rocket的宏应该能正确展开并编译通过。

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