本文详解 go 使用 database/sql 驱动 postgresql 时出现 “syntax error at or near `$1`” 的根本原因——postgresql 不支持在类型转换子句（如 `timestamp with time zone $1`）中直接嵌入占位符，需将类型转换移至参数本身，并提供正确写法、原理说明及安全实践建议。
在 Go 中使用 database/sql + lib/pq（或 pgx）连接 PostgreSQL 时，开发者常通过 $1, $2 等位置参数实现安全的参数化查询。但当 SQL 中涉及类型强制转换（如 timestamp with time zone $1）时，极易触发 pq: syntax error at or near "$1" 错误——这不是 Go 或驱动的问题，而是 PostgreSQL 语法规则所致。
PostgreSQL 要求：占位符 $n 必须作为独立表达式出现，不能嵌套在复合类型构造语法内部。例如以下写法是非法的：
-- ❌ 错误：$1 被包裹在 "timestamp with time zone ..." 语法结构中 timestamp with time zone $1
PostgreSQL 解析器会将其视为语法碎片，无法识别 $1 为有效参数引用，从而报错。
✅ 正确做法是：先将参数声明为对应类型，再在函数中使用。即把类型转换操作施加于 本身，而非包裹它：
var from string = "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 TIMESTAMP WITH TIME ZONE '2015-03-01 00:15:10')::INT4 "+
"ORDER BY time ASC",
from,
)
if err != nil {
log.Fatal("Query failed:", err)
}
defer rows.Close()关键修改点：
- 将 extract(epoch from timestamp with time zone $1)
→ 改为 extract(epoch from $1::timestamp with time zone) - 占位符 $1 现在是 ::timestamp with time zone 的直接操作数，符合 PostgreSQL 参数绑定语法规范。
? 补充建议：
- 优先使用 timestamptz 列类型：若表中 time 字段本就是 TIMESTAMPTZ，可省去 EXTRACT(EPOCH...) 转换，直接用 >= $1 比较，语义更清晰、性能更优；
- 避免硬编码时间字符串：示例中第二个时间 '2015-03-01 00:15:10' 同样建议参数化（用 $2），提升复用性与可维护性；
- 验证输入格式：确保传入的 from 字符串符合 PostgreSQL 接受的日期时间格式（如 2006-01-02 15:04:05 或带时区版本），否则会在运行时触发 invalid input syntax for type timestamp with time zone 错误。
总结：PostgreSQL 的 $1 占位符不是文本替换宏，而是强类型绑定变量。所有类型修饰（::type）、函数调用（EXTRACT(...)) 都必须围绕占位符构建合法表达式，而非将占位符塞进任意语法槽位。遵循这一原则，即可彻底规避此类“near $1”语法错误。
