go 语言中封装 *sql.db 时需注意方法名大小写规则：所有公开方法首字母必须大写（如 prepare），小写方法（如 prepare）不可访问，否则编译报错“undefined (cannot refer to unexported field or method)”。
go 语言中封装 *sql.db 时需注意方法名大小写规则：所有公开方法首字母必须大写（如 prepare），小写方法（如 prepare）不可访问，否则编译报错“undefined (cannot refer to unexported field or method)”。
在 Go 中，通过结构体封装 *sql.DB 是常见且推荐的做法，既能增强可维护性，又能统一连接管理、日志、重试等扩展逻辑。但新手常因 Go 的导出规则（exported vs unexported）踩坑——只有首字母大写的标识符才对外部包可见，而 sql.DB 的所有公开方法（如 Prepare、Query、Exec、Ping）均严格遵循此约定。
你遇到的错误：
dbConn.db.prepare undefined (cannot refer to unexported field or method sql.(*DB)."".prepare)
根本原因正是将 Prepare 误写为小写的 prepare。Go 编译器无法识别该名称，因为它既不是 *sql.DB 的导出方法，也不是结构体字段（db 字段本身是导出的，但 prepare 不是其合法成员）。
✅ 正确写法如下（注意首字母大写）：
getNodeRecord, err := dbConn.db.Prepare(dbQuery)
if err != nil {
log.Fatal("Failed to prepare statement:", err)
}
defer getNodeRecord.Close()⚠️ 同时，你的原始代码中还存在几个关键问题，需一并修正：
-
*Open() 方法未保存 `sql.DB实例** 当前Open()使用了局部变量db，但未赋值给d.db字段，导致后续dbConn.db为nil，调用Close()或Prepare()` 会 panic。应改为：
func (d *DatabaseConn) Open() error { d.driverName = DB_DRNAME d.userName = DB_UNAME d.password = DB_PWD d.databaseName = DB_DBNAME d.dataSourceName = fmt.Sprintf("%s:%s@/%s?charset=utf8", d.userName, d.password, d.databaseName) db, err := sql.Open(d.driverName, d.dataSourceName) if err != nil { return err } // ✅ 关键：保存到结构体字段 d.db = db // ✅ 建议：验证连接有效性 if err = db.Ping(); err != nil { return fmt.Errorf("failed to ping database: %w", err) } return nil } Open() 方法接收者应为指针
因为需要修改结构体字段（如 d.db），必须使用 *DatabaseConn 接收者，否则修改仅作用于副本。-
Close() 中 recover() 非必要且掩盖真实错误
sql.DB.Close() 是安全的，不会 panic；若 d.db 为 nil，应提前校验并返回明确错误，而非依赖 recover。优化后：func (d *DatabaseConn) Close() error { if d.db == nil { return errors.New("database connection is not initialized") } return d.db.Close() } -
完整使用示例：
var dbConn DatabaseConn if err := dbConn.Open(); err != nil { log.Fatal("Failed to open database:", err) } defer dbConn.Close() // 注意：此处需确保 Open 成功后再 defer query := "SELECT * FROM ms_node WHERE node_id = ?" stmt, err := dbConn.db.Prepare(query) if err != nil { log.Fatal("Failed to prepare statement:", err) } defer stmt.Close() var id int err = stmt.QueryRow(123).Scan(&id) if err != nil { log.Fatal("Query failed:", err) }
? 总结：封装 *sql.DB 的最佳实践包括——使用指针接收者、显式保存实例、校验连接健康状态、严格遵循 Go 导出命名规范（首字母大写）、避免滥用 recover。掌握这些，你就能构建健壮、可扩展的数据库连接层。
