用 go/ast 提取 SQL 的核心是结合 AST 遍历与上下文判断:遍历 ast.BasicLit(token.STRING)、检查其父节点是否为 SQL 执行函数调用或 query-like 变量赋值,并递归解析参数表达式;需覆盖复合字面量、map value、闭包、类型断言等边界场景,最终合并静态字符串与调用点溯源两路结果。

怎么用 go/ast 扫描 Go 源码里的 SQL 字符串
直接用 go/ast 无法“识别 SQL”,它只负责解析 Go 语法树,不理解字符串内容。真正能提取 SQL 的,是结合 AST 遍历 + 字符串字面量(ast.BasicLit)+ 上下文判断(比如变量名含 query、函数调用如 db.Query)。重点不是“找 SQL”,而是“找可能承载 SQL 的字符串字面量”。
常见误判场景:日志消息、JSON 字段名、注释伪代码、SQL 拼接中间变量——这些都得靠上下文过滤。
- 只遍历
ast.BasicLit类型为token.STRING的节点 - 跳过反引号字符串(
`...`),除非你明确需要多行 SQL 模板(但实际极少这么写) - 检查父节点是否为赋值语句(
ast.AssignStmt)且左值变量名含sql、query、stmt等关键词 - 检查父节点是否为函数调用(
ast.CallExpr),且 Fun 是db.Query、tx.Exec、sqlx.Select等已知 SQL 执行入口
如何安全提取 db.Query / db.Exec 的第一个参数
这是最可靠的目标:ORM 或标准库中 SQL 执行函数的第一个参数几乎总是原始 SQL 字符串或格式化后的字符串。但要注意,它不一定是 ast.BasicLit,也可能是 ast.BinaryExpr(拼接)、ast.CallExpr(fmt.Sprintf)或 ast.Ident(变量引用)。
不能只取 CallExpr.Args[0] 就完事——必须递归展开表达式,直到得到可确定的字符串字面量或放弃(比如遇到未知变量)。
- 若
Args[0]是ast.BasicLit且 Kind ==token.STRING,直接取Value并用strconv.Unquote解析 - 若为
ast.BinaryExpr(+连接),需递归左右子树,合并所有可解的字符串字面量(仅限纯字符串拼接,跳过含变量的分支) - 若为
ast.CallExpr且Fun是fmt.Sprintf,可尝试提取第一个参数(模板字符串),但第二个及以后参数一律忽略——它们不是 SQL 本身 - 若为
ast.Ident,尝试向上查找最近的ast.AssignStmt,再对右值做同样展开;查不到就跳过,不强行猜测
为什么不用正则先扫字符串再用 AST 定位?
因为正则匹配字符串字面量不可靠:"SELECT * FROM users WHERE name = '" + name + "'" 这种拼接,正则会把三段都当 SQL 提取,而 AST 能看清结构,知道只有第一段是静态 SQL,后面是注入点。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
反过来,如果只依赖 AST 不做字符串内容分析,又会漏掉 const userQuery = "SELECT ..." 这类声明——它没出现在调用位置,但确实是 SQL。
- 推荐组合策略:先用 AST 找出所有
ast.BasicLit字符串 + 所有 SQL 执行函数调用点 - 对每个字符串,检查其“使用位置”:是否被传给 SQL 执行函数?是否赋值给
query-like 变量?是否在sql包相关 struct 字段里? - 对每个 SQL 调用点,逆向追踪第一个参数的源头,合并所有能确定的静态字符串片段
- 最终结果是两路结果的并集,而非单一路径
go/ast 遍历时容易忽略的边界情况
AST 遍历看似简单,但 Go 的语法糖和嵌套结构会让很多 SQL 躲过扫描。几个典型漏点:
-
struct{ Query string }{Query: "SELECT ..."}—— 字面量在复合字面量里,父节点是ast.CompositeLit,不是赋值也不是调用,需额外检查字段名 -
var queries = map[string]string{"user": "SELECT..."}—— 字符串在 map value 里,要识别ast.MapType和ast.MapLit中的ast.KeyValueExpr - 内联函数或闭包中调用
db.Query——ast.FuncLit节点需递归进入其Body - 接口类型断言后调用:
if db, ok := x.(SQLRunner); ok { db.Query(...) }—— 此时Fun是ast.IndexExpr或ast.TypeAssertExpr,不能硬判Ident - Go 1.22+ 支持泛型,
repo.Find[User](ctx, "SELECT ...")中的字符串仍是Args[1],但Fun是带ast.IndexListExpr的复杂结构,需跳过泛型部分再取Args
真正难的不是写出第一个能跑的遍历器,而是让漏报率低于 5%——这要求你持续收集项目里真实出现的 SQL 写法,然后补 case。没有银弹,只有不断贴合业务代码风格。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










