
在 Go 中使用 Prepare 执行 LIKE 模糊查询时,不能将通配符 % 写在 SQL 语句中并配合 ? 占位符(如 '%?%'),否则会因参数绑定失败而报错;正确做法是将通配符拼接到 Go 变量值中,再作为参数传入预处理语句,既保持 SQL 注入防护,又支持模糊搜索。
在 go 中使用 `prepare` 执行 `like` 模糊查询时,不能将通配符 `%` 写在 sql 语句中并配合 `?` 占位符(如 `'%?%'`),否则会因参数绑定失败而报错;正确做法是将通配符拼接到 go 变量值中,再作为参数传入预处理语句,既保持 sql 注入防护,又支持模糊搜索。
在 Go 的数据库操作中,sql.Stmt.Prepare 的核心安全机制在于参数与 SQL 结构的严格分离:占位符 ? 仅用于传递纯数据值,数据库驱动会将其作为绑定参数(bound parameter)处理,而非字符串拼接。因此,像 "name LIKE '%?%'" 这样的写法是错误的——SQL 解析器会把 ? 当作字面量字符,导致最终语句不包含任何参数占位符,从而触发 sql: statement expects 0 inputs; got 1 错误。
✅ 正确做法是:将通配符逻辑移至 Go 层,即对查询变量提前添加 %,再传入预处理语句:
stmt, err := dBusers.Prepare("SELECT id, name, email, username FROM users WHERE name LIKE ?")
if err != nil {
logging.LogError("Could not prepare users query: " + err.Error())
return nil, errors.New("could not prepare users query")
}
defer stmt.Close() // 避免资源泄漏
// ✅ 安全拼接通配符:参数值本身包含 %
rows, err := stmt.Query("%" + name + "%")
if err != nil {
logging.LogError("Could not execute users query: " + err.Error())
return nil, errors.New("could not query users")
}
defer rows.Close()
⚠️ 注意事项:
-
永远不要在 SQL 字符串中拼接用户输入(如
fmt.Sprintf("... LIKE '%%%s%%'", name)),这会彻底破坏 SQL 注入防护; - 若需支持前缀、后缀或全匹配等不同模式,可统一封装为辅助函数:
func likePattern(s string, mode string) string { switch mode { case "prefix": return s + "%" case "suffix": return "%" + s case "contains": return "%" + s + "%" default: return "%" + s + "%" } } // 使用:stmt.Query(likePattern(name, "contains")) - 对于 MySQL,确保字段已建立合适索引(如
INDEX(name)或前缀索引),否则LIKE '%xxx%'可能导致全表扫描,影响性能; - 若需大小写敏感匹配,可在 SQL 中显式指定 collation(如
WHERE name LIKE ? COLLATE utf8mb4_0900_as_cs),但通常默认行为已满足多数场景。
总结:预处理语句的安全性源于“结构与数据分离”,通配符属于数据语义的一部分,应由应用层构造,而非混入 SQL 模板。这一原则同样适用于 ILIKE(PostgreSQL)、GLOB(SQLite)等其他模糊匹配场景。










