本文聚焦 Go 语言使用 lib/pq 驱动连接 PostgreSQL 时因误用 ? 占位符导致查询失败的问题，明确指出 PostgreSQL 要求使用 $1, $2 等位置参数语法，并提供完整、安全、可落地的参数化查询实现方案。
本文聚焦 go 语言使用 lib/pq 驱动连接 postgresql 时因误用 `?` 占位符导致查询失败的问题，明确指出 postgresql 要求使用 `$1`, `$2` 等位置参数语法，并提供完整、安全、可落地的参数化查询实现方案。
在 Go 应用中对接 PostgreSQL 数据库时，一个高频且隐蔽的错误是：开发者习惯性沿用 MySQL 或 SQLite 的 ? 占位符写法（如 "WHERE id = ?"），却未意识到 PostgreSQL 原生仅支持 $n 形式的序号占位符（如 $1, $2）。当你写下：
database.QueryRow("SELECT ... FROM pages WHERE id = ?", pageID)
lib/pq 驱动会将整条 SQL 字符串原样发送给 PostgreSQL 服务端，而 PostgreSQL 解析器遇到 ? 时会直接报错：ERROR: syntax error at or near "?"——该错误常被日志忽略或静默吞没，最终表现为 QueryRow 返回 sql.ErrNoRows 或 panic，如你所见的 "Couldn't get page: 1" 提示。
✅ 正确写法必须使用 $1 占位符，并确保参数类型与数据库字段兼容：
err := database.QueryRow(
"SELECT page_title, page_content, page_date FROM pages WHERE id = $1",
pageID,
).Scan(&thisPage.Title, &thisPage.Content, &thisPage.Date)
注意：此处 pageID 应为 int 或 int64 类型（取决于 pages.id 的定义，通常是 SERIAL 或 BIGSERIAL）。若从 URL 路由获取（如 mux.Vars(r)["id"]），它默认是字符串，需显式转换：
pageIDStr := vars["id"]
pageID, err := strconv.ParseInt(pageIDStr, 10, 64)
if err != nil {
http.Error(w, "Invalid page ID", http.StatusBadRequest)
return
}
? 关键要点总结：
-
占位符语法不可混用：
?属于 MySQL/SQLite 风格；PostgreSQL 严格要求$1,$2, …； -
sql.Open()不等于已连接：务必在初始化后调用db.Ping()验证连接有效性； -
永远检查错误：你的原始代码中
log.Fatal(err.Error)是错误写法（err.Error是方法，非字段），应为err.Error()；更推荐使用log.Printf("DB error: %v", err)+ HTTP 错误响应； -
类型安全优先：避免将字符串直接传入数值型条件；使用
strconv或sql.NullInt64等增强健壮性； -
驱动兼容性提示：若后续迁移到
pgx（高性能替代驱动），其占位符语法仍为$1，完全兼容，无需修改 SQL 模板。
最后，一个生产就绪的 ServePage 改写示例（含错误处理与类型转换）：
func ServePage(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
idStr := vars["id"]
id, err := strconv.ParseInt(idStr, 10, 64)
if err != nil {
http.Error(w, "Invalid page ID", http.StatusBadRequest)
return
}
var thisPage Page
err = database.QueryRow(
"SELECT page_title, page_content, page_date FROM pages WHERE id = $1",
id,
).Scan(&thisPage.Title, &thisPage.Content, &thisPage.Date)
if err == sql.ErrNoRows {
http.Error(w, "Page not found", http.StatusNotFound)
return
}
if err != nil {
log.Printf("Database query failed: %v", err)
http.Error(w, "Internal server error", http.StatusInternalServerError)
return
}
html := fmt.Sprintf(`
<title>%s</title><h1>%s</h1><div>%s</div>`,
thisPage.Title, thisPage.Title, thisPage.Content)
w.Header().Set("Content-Type", "text/html; charset=utf-8")
fmt.Fprintln(w, html)
}
遵循以上规范，即可彻底规避占位符语法错误，构建出安全、清晰、易于维护的 Go + PostgreSQL 查询逻辑。
