本文介绍使用 go 的 database/sql 包配合 sqlite 时，如何简洁、安全地判断用户名等唯一字段是否已存在，推荐使用 queryrow 替代 query + 循环遍历，避免资源浪费并提升可读性与健壮性。
本文介绍使用 go 的 database/sql 包配合 sqlite 时，如何简洁、安全地判断用户名等唯一字段是否已存在，推荐使用 queryrow 替代 query + 循环遍历，避免资源浪费并提升可读性与健壮性。
在 Go 中操作 SQLite 数据库时，判断某条记录（如用户名）是否存在，是用户注册、登录等场景的常见需求。原始实现中使用 db.Query() 配合 rows.Next() 循环计数，不仅代码冗余，还存在潜在问题：rows 本身不可直接取长度（len(rows) 会编译报错），且未正确关闭 rows，易引发连接泄漏。
更优解是使用 db.QueryRow() —— 它专为至多返回一行的查询设计，语义清晰、性能高效，且自动处理资源释放。当查询无匹配结果时，QueryRow().Scan() 返回 sql.ErrNoRows；若发生其他错误（如 SQL 语法错误、数据库连接中断），则返回对应错误，需显式区分处理。
以下是推荐的实现方式：
import (
"database/sql"
"log"
)
func UserExists(db *sql.DB, username string) (bool, error) {
const sqlStmt = `SELECT 1 FROM userinfo WHERE username = ?`
var dummy int
err := db.QueryRow(sqlStmt, username).Scan(&dummy)
if err != nil {
if err == sql.ErrNoRows {
return false, nil // 用户名不存在，非错误
}
return false, err // 其他数据库错误，应向上层传递
}
return true, nil
}✅ 关键优化点说明：
- 使用 SELECT 1 而非 SELECT username，减少数据传输开销，语义更明确（仅需判断存在性）；
- 函数签名改为 (bool, error)，符合 Go 错误处理最佳实践，使调用方能区分“不存在”与“查询失败”；
- QueryRow 自动关闭内部 rows，无需手动 rows.Close()，避免资源泄漏；
- Scan(&dummy) 仅接收占位值，无需额外变量存储实际字段内容。
⚠️ 注意事项：
- 切勿忽略 err 检查，尤其是 sql.ErrNoRows 必须显式判断，否则会导致逻辑错误；
- 若表中 username 字段未建索引（特别是 UNIQUE 约束未隐式创建索引），查询性能将随数据量增长而下降，建议确保 username 有唯一索引；
- 在高并发场景下，UserExists 应与后续插入/更新操作置于同一事务中，防止竞态条件（如检查存在 → 插入之间被其他协程抢先写入），此时需结合 INSERT OR IGNORE 或 ON CONFLICT 处理。
综上，QueryRow 是检查单值存在的标准、高效、安全方式，应作为 Go 数据库开发中的首选模式。
