Rust sqlx query_as!宏报错：预期Option<String>，实际得到String

问题原因 #

sqlx的query_as!宏会根据Postgres表列的约束自动推导映射类型：

• 如果列定义为NOT NULL，宏会推导为非Option类型（比如String）
• 如果列允许为空（NULL），宏会推导为Option类型
  你的报错是因为结构体中user_id定义为Option<String>，但宏推导出来的是String，两者类型不匹配。

修正方案 #

方案1：数据库列允许为空时，显式指定类型 #

如果你的events表中user_id列允许为空（即定义为character varying NULL），需要在query_as!的SQL语句中显式标注字段的目标类型：

pub async fn find_by_id(db: &DbPool, id: &Uuid) -> Result<Self, ErrorResponse> {
    let res = query_as!(
        Self,
        "select order_id, created, user_id as \"user_id: Option<String>\" from events where order_id = $1",
        id
    )
    .fetch_one(db)
    .await?;

    Ok(res)
}

通过as "user_id: Option<String>"的语法，强制sqlx将user_id映射为Option<String>类型，和结构体定义匹配。

方案2：数据库列不允许为空时，修改结构体类型 #

如果你的events表中user_id列定义为NOT NULL，那么结构体中的user_id不应该用Option，直接改为String即可：

#[derive(Debug, Serialize, Deserialize)]
pub struct EventEntity {
    pub order_id: Uuid,
    pub created: OffsetDateTime,
    pub user_id: String, // 移除Option包装
}

额外检查 #

先确认events表中user_id列的实际约束：

• 执行SQL查询查看列定义：SELECT column_name, is_nullable FROM information_schema.columns WHERE table_name = 'events' AND column_name = 'user_id';
• 根据is_nullable的值（YES或NO）选择对应的修正方案。

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