SQLx未在编译时检测到缺失NOT NULL列的查询问题

1. 为何SQLx未在编译时捕获该问题？ #

核心原因是编译期SQLx获取的表结构与运行时不一致，具体场景包括：

• 编译时连接的数据库未执行新增user_id列的迁移：SQLx编译时会读取目标数据库的表元数据，如果编译时用的数据库还是旧表结构（没跑最新迁移），自然检测不出user_id缺失。
• sqlx-data.json元数据未更新：如果用了cargo sqlx prepare生成离线元数据，但生成后才执行了迁移，旧的元数据里没有user_id列的信息，编译时就不会触发检查。
• 编译时检查被意外跳过：比如代码中给查询加了#[sqlx(skip)]属性，或者未正确启用SQLx的编译时检查特性（0.8版本默认启用，除非刻意配置）。

2. 是否需要配置以启用此类编译时检查？ #

SQLx默认启用编译时查询验证，但需要确保以下配置正确：

• 在Cargo.toml中启用必要特性：必须包含对应数据库特性（比如postgres）、macros（用于SQLx宏），以及运行时特性（比如runtime-tokio-native-tls），示例配置：

  sqlx = { version = "0.8", features = ["postgres", "macros", "runtime-tokio-native-tls"] }
  

• 避免手动禁用检查：不要给查询宏加#[sqlx(offline)]或#[sqlx(skip)]属性，除非你明确不需要编译时验证。
• 确保编译时能访问到最新的数据库实例：编译前要保证DATABASE_URL指向的数据库已经执行完所有迁移。

3. 是否与编译时检查的数据库连接配置有关？ #

是的，这是最常见的诱因：

• 编译时使用的DATABASE_URL与运行时不一致：比如编译时连接的是测试库（未更新迁移），运行时用的是开发库（已更新），导致编译时元数据过时。
• 多环境数据库混淆：如果本地有多个PostgreSQL实例，或者用了Docker容器数据库，编译时连接的实例没同步执行迁移，也会导致元数据不匹配。
• 离线编译依赖旧元数据：如果之前执行过cargo sqlx prepare但未重新生成，离线编译时会使用旧的sqlx-data.json，无法感知表结构变化。

快速修复建议 #

1. 编译前确保DATABASE_URL指向的数据库已执行最新迁移：运行cargo sqlx migrate run后再编译代码。
2. 更新离线元数据：若使用离线编译，执行cargo sqlx prepare --check检查元数据是否过时，若过时则重新执行cargo sqlx prepare生成新的sqlx-data.json。
3. 验证编译时连接的数据库：执行sqlx db info查看编译时连接的数据库表结构，确认task表是否包含user_id列。

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