如何调试rocket_db_pools库的「missing field `url`」错误

1. 配置文件键名错误 #

rocket_db_pools 要求数据库配置的URL字段必须以url作为键，若你在Rocket.toml里写的是database_url或其他自定义名称（如db_url），就会触发「missing field url」错误。

正确配置示例：

[default.databases.my_db]
url = "postgresql://postgres:postgres@localhost:5432/my_db"

2. 配置结构层级错误 #

数据库配置必须嵌套在[<环境>.databases]层级下（默认环境为default），层级缺失会导致Rocket无法识别url字段。比如以下错误写法：

# 错误：未嵌套在databases层级下
[default]
my_db.url = "postgresql://postgres:postgres@localhost:5432/my_db"

3. 代码与配置的数据库名称不匹配 #

若代码中声明的数据库名称和Rocket.toml里的数据库名称不一致，Rocket会找不到对应配置的url字段。比如代码里写：

#[database("wrong_db_name")]
struct MyDb(DbConn<Postgres>);

而配置里的数据库名称是my_db，就会出现该错误。

4. 使用了过时的配置格式 #

如果是从旧版本Rocket迁移过来，仍沿用rocket_sync_db_pools的旧配置格式，而rocket_db_pools的配置结构已更新，必须使用新的嵌套格式才能正常识别。

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