本文讲解 go 使用 database/sql 驱动执行 postgresql 查询时，因错误放置类型转换导致 `syntax error at or near "$1"` 的根本原因及正确写法，重点说明 `$1` 占位符必须直接参与类型转换（如 `$1::timestamp with time zone`），而不能将 `::int4` 等类型修饰符套在函数调用内部。
在 Go 中通过 database/sql（配合 pq 或 pgx 驱动）向 PostgreSQL 发送参数化查询时，PostgreSQL 期望占位符 $1, $2, … 出现在可直接被类型转换或函数接受的位置。而原代码中：
"time >= extract(epoch from timestamp with time zone $1)::int4"
存在两个关键问题：
- $1 不在类型转换作用域内：timestamp with time zone $1 是非法语法 —— PostgreSQL 不支持在类型修饰符（如 timestamp with time zone）后紧跟 $1；正确的写法是将占位符作为类型转换的目标，即 $1::timestamp with time zone；
- extract(epoch from ...) 无法直接对 $1 做隐式类型推断：当 $1 是字符串（如 "2015-03-01 00:00:00"）时，PostgreSQL 需明确知道它应被解释为带时区的时间戳，否则 extract(epoch from $1) 会因类型不匹配报错。
✅ 正确写法如下（修正后完整示例）：
from := "2015-03-01 00:00:00"
rows, err := db.Query(
`SELECT time, val
FROM table
WHERE time >= EXTRACT(EPOCH FROM $1::TIMESTAMP WITH TIME ZONE)::INT4
AND time < EXTRACT(EPOCH FROM '2015-03-01 00:15:10'::TIMESTAMP WITH TIME ZONE)::INT4
ORDER BY time ASC`,
from,
)
if err != nil {
log.Fatal(err)
}
defer rows.Close()? 关键改进说明：
- $1::TIMESTAMP WITH TIME ZONE：显式将字符串参数转换为带时区时间戳，确保 EXTRACT(EPOCH FROM ...) 能安全计算；
- 所有类型转换（::...）均紧贴占位符或字面量，符合 PostgreSQL 语法规则；
- 推荐使用反引号（`）包裹 SQL 字符串，避免 Go 字符串拼接带来的可读性与转义风险。
⚠️ 注意事项：
- 不要尝试在函数内部嵌套 $1（如 func($1)），除非该函数明确接受 unknown 类型并能自动推导——多数时间函数要求明确类型；
- 若 from 变量本身已是 time.Time 类型，更推荐直接传入（驱动通常自动映射为 TIMESTAMP WITH TIME ZONE），无需字符串格式化；
- 在生产环境中，建议统一使用 t.Unix() 获取秒级时间戳并在 Go 层计算范围，减少数据库端 EXTRACT 计算开销，提升可读性与可测试性。
总结：PostgreSQL 的 $1 占位符不是文本宏，而是具有严格类型上下文的参数节点。所有类型修饰符（::type）和类型转换函数（如 CAST($1 AS type)）必须直接作用于 $1，而非包裹在其他表达式中。遵循这一原则，即可避免绝大多数“syntax error at or near $1”类错误。
