如何在SQLx中正确添加BOX条件实现PostgreSQL查询？

1. 替换易被拆分的操作符 #

SQLx会误把<@拆成< @导致语法错误，直接用PostGIS的ST_Within函数替代该操作符，逻辑完全一致：
原错误写法：AND topleft <@ BOX $2
替换为：AND ST_Within(topleft, $2)

2. 正确绑定BOX参数 #

不要用字符串拼接BOX，推荐两种绑定方式：

• 类型绑定：确保项目依赖包含PostGIS扩展（sqlx = { version = "0.7", features = ["postgres", "postgres-postgis"] }），直接传入Box类型变量：

  let target_box = Box::new(Point::new(min_x, min_y), Point::new(max_x, max_y));
  let query = sqlx::query!(
      r#"
      SELECT * FROM your_table
      WHERE some_condition = $1
      AND ST_Within(topleft, $2)
      "#,
      condition_value,
      target_box
  );
  

• 手动构造BOX：通过ST_MakeBox2D函数拆分坐标参数绑定，避免类型依赖问题：

  let query = sqlx::query!(
      r#"
      SELECT * FROM your_table
      WHERE some_condition = $1
      AND ST_Within(topleft, ST_MakeBox2D(POINT($2, $3), POINT($4, $5)))
      "#,
      condition_value,
      box_min_x,
      box_min_y,
      box_max_x,
      box_max_y
  );
  

3. 基于拆分字段的替代方案 #

既然已经把topleft拆分为x、y字段，也可以直接用数值范围查询实现BOX过滤，无需依赖PostGIS函数：

let query = sqlx::query!(
    r#"
    SELECT * FROM your_table
    WHERE some_condition = $1
    AND topleft_x BETWEEN $2 AND $4
    AND topleft_y BETWEEN $3 AND $5
    "#,
    condition_value,
    box_min_x,
    box_min_y,
    box_max_x,
    box_max_y
);

4. 调试验证 #

如果仍有问题，开启SQLx的调试日志（在Cargo.toml中添加sqlx = { ..., features = ["log"] }），查看最终生成的SQL语句，确认参数绑定和语法是否正确。

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