本文介绍使用 go 的 database/sql 包配合 sqlite 时，如何简洁、安全地判断某用户名是否已存在于数据库中，重点推荐 queryrow + scan 方式替代遍历 rows，避免资源浪费并提升可读性与健壮性。
本文介绍使用 go 的 database/sql 包配合 sqlite 时，如何简洁、安全地判断某用户名是否已存在于数据库中，重点推荐 queryrow + scan 方式替代遍历 rows，避免资源浪费并提升可读性与健壮性。
在 Go 应用中操作 SQLite 数据库时，常需验证某个唯一字段（如 username）是否已存在。原始实现中使用 db.Query() 遍历 rows 并计数，不仅冗余（仅需“存在与否”布尔结果），还易忽略错误处理、资源泄漏风险（未调用 rows.Close()），且逻辑不够直观。
更优解是使用 db.QueryRow() —— 它专为最多返回一行的查询设计。若匹配记录存在，Scan() 成功；若无匹配，则返回 sql.ErrNoRows；其他错误（如 SQL 语法错、连接中断）则返回具体异常。这使逻辑清晰、性能高效、资源自动管理（无需手动 Close）。
以下是推荐的实现方式：
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 错误处理最佳实践，调用方可区分“不存在”（正常业务逻辑）与“查询失败”（需告警/重试）；
- 显式判断 sql.ErrNoRows：避免将业务不存在误判为系统错误；
- 无需手动关闭 rows：QueryRow 内部已妥善处理。
⚠️ 注意事项：
- 切勿忽略 err！直接 if err != nil { return false } 会掩盖真实故障（如表不存在、权限不足），导致静默失败；
- 若仅用于校验（如注册前检查），建议配合事务或唯一约束双重保障，防止竞态条件（T0 查询不存在 → T1 插入 → T2 插入重复）；
- 生产环境务必启用 sqlite3 驱动的日志或监控，确保 QueryRow 调用的稳定性。
综上，QueryRow 是检查单值存在性的标准、高效、符合 Go 惯例的方式——简洁即可靠，明确即安全。
