Buffalo中执行原生SQL须通过事务对象tx调用，禁用app.DB直接查询；需用?占位符防注入，字段映射依赖db标签，事务必须显式提交或回滚。
Buffalo 中执行原生 SQL 的核心方式是 tx.Query 和 tx.QueryRow
Buffalo 本身不提供独立的数据库执行层，它依赖底层使用的 ORM（默认是 Pop）来操作数据库。Pop 支持原生 SQL，但必须通过事务对象（tx）调用，不能直接在 db 上执行——否则会报 no such function: Query 或 panic：「unsupported driver」这类错误。
常见错误现象：在 handler 里写 app.DB.Query(...)，结果编译通过但运行时报错；或者用了 app.DB.Raw(...)（这是旧版 Pop v4 写法，v5+ 已移除）。
- 务必先获取事务对象：
tx, err := app.DB.Transaction()，或更推荐用app.DB.WithContext(c.Context()).Transaction()确保上下文传播 -
tx.Query用于 SELECT 多行，返回*pop.Query，需配合All(&results)解析 -
tx.QueryRow用于 SELECT 单行，返回*sql.Row，需手动Scan - INSERT/UPDATE/DELETE 推荐用
tx.Raw(...).Exec()（Pop v5.4+ 支持），它返回sql.Result，可调RowsAffected()
参数绑定必须用 ? 占位符，不能拼接字符串
Pop 底层使用 database/sql，所有驱动（PostgreSQL、MySQL、SQLite）都要求预处理语句风格。用 fmt.Sprintf 拼接 SQL 是严重安全漏洞，且在 PostgreSQL 下会因引号和类型报错（如 ERROR: syntax error at or near "123"）。
示例：正确写法是 tx.Raw("SELECT * FROM users WHERE id = ? AND status = ?", userID, "active")；错误写法是 "...WHERE id = " + strconv.Itoa(userID)。
- SQLite 和 MySQL 使用
?；PostgreSQL 实际会把?编译成$1,$2，无需手动改 - 如果要动态列名或表名（如分表场景），只能拼接，但必须严格校验白名单，例如
if !validTableName(table) { return errors.New("invalid table") } - NULL 值传参时，用
sql.NullString等类型，不要传nil指针
SELECT 结果映射到结构体时字段名必须匹配，且注意大小写
Pop 的 All(&slice) 默认按字段名（非列别名）映射结构体字段。若 SQL 里写了 SELECT user_name AS name，而结构体字段是 Name string，则不会赋值——因为 Pop 匹配的是原始列名 user_name，不是别名 name。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
常见错误：返回空数据或零值，debug 时发现 rows.Columns() 打印出的是 [user_name email]，但结构体字段叫 Username，没加 json:"user_name" 标签就映射失败。
- 方案一：SQL 中用原字段名，结构体字段名首字母大写并加
db:"user_name"标签（Pop v5 要求） - 方案二：用
tx.QueryRow+Scan手动解包，完全绕过 Pop 映射逻辑 - PostgreSQL 默认字段名小写，即使建表写
CREATE TABLE Users (ID INT)，查询SELECT ID FROM users返回的列名仍是id，注意大小写一致性
事务生命周期必须显式结束，否则连接泄漏
Buffalo 不自动 commit 或 rollback。如果只调 tx.Transaction() 却忘记 tx.Commit() 或 tx.Rollback()，该连接会一直占用，达到数据库连接池上限后整个应用卡死（PostgreSQL 报 too many clients already）。
典型漏写场景：在 if err != nil 分支里只 return，没调 tx.Rollback()；或 defer 写成 defer tx.Commit() 导致无论成功失败都 commit。
- 标准写法是用
defer func() { if !committed { _ = tx.Rollback() } }()配合committed = true标记 - 更稳妥的做法是用
pop.Transaction(app.DB, func(tx *pop.Connection) error { ... })，它内部自动处理 rollback/commit - 执行纯查询（SELECT）也建议走事务，避免脏读；除非明确配置了
ReadUncommitted级别
原生 SQL 在 Buffalo 里不是“备选方案”，而是必要手段——比如窗口函数、CTE、UPSERT、JSONB 查询等，Pop 的 DSL 很难覆盖。但每条手写 SQL 都得自己负责参数安全、字段映射、事务边界和驱动兼容性，没有银弹。
