SQL工具栏按钮无响应的主因是onclick未正确绑定或执行函数缺失关键依赖（如connection实例）；需确保函数可访问、连接已建立、环境适配、参数化防注入，并对SQL执行进行索引优化与超时控制。
SQL 工具栏按钮点击后没反应？检查 onclick 绑定和 SQL 执行上下文
常见现象是按钮渲染出来了，但点一下完全没日志、没请求、也没报错。根本原因通常是事件没绑对位置，或执行函数里缺了关键依赖——比如没传 connection 实例，或 executequery 函数压根没暴露到全局作用域。
- 确保按钮的
onclick指向的是可访问的函数，不是闭包内未导出的私有方法 - SQL 执行必须依赖已建立的连接对象，不能在未登录/未选库状态下硬调
runSql - 如果用的是 Web SQL 或 SQLite Wasm（如
sql.js），注意db.run()和db.exec()行为差异：前者不返回结果，后者返回数组但不支持参数化
如何让「一键执行」支持参数化 SQL 而不拼接字符串？
硬拼 WHERE name = '" + userInput + "' 是典型 SQL 注入温床，尤其工具栏常用于调试，用户输入不可控。真正安全的做法是把参数抽离，由执行层统一处理。
- 快捷按钮配置项里不要存完整 SQL 字符串，改存模板 + 参数映射，例如：
{ sql: "SELECT * FROM users WHERE status = ?", params: ["active"] } - 执行时用
statement.bind(params).all()（SQLite）或connection.query(sql, params)（MySQL Node.js 驱动） - 前端若用
sql.js，注意它不原生支持命名参数，?占位符顺序必须严格匹配params数组
多个数据库环境（dev/staging/prod）下，快捷 SQL 怎么自动适配？
一套 SQL 在本地跑通，推到测试环境就报 Table 'prod.users' doesn't exist，本质是没做环境感知。别靠人肉改表名前缀，应该在加载快捷项时动态注入上下文。
- 快捷项定义里避免写死库名/表名，改用占位符如
SELECT * FROM ${TABLE_PREFIX}users - 初始化工具栏时，从当前连接元数据中提取
schema或database名，作为TABLE_PREFIX值注入 - 如果后端提供多租户支持，也可以把
tenant_id作为额外参数透传进 SQL 执行链路
为什么加了快捷按钮，但执行慢得像卡住？重点看事务和锁
“一键查最近 100 条日志”看着简单，但如果对应 SQL 是 SELECT * FROM big_log_table ORDER BY id DESC LIMIT 100，而表没建 id 索引，实际会触发全表扫描+文件排序，前端就表现为按钮变灰几秒没响应。
- 所有快捷 SQL 必须经过 EXPLAIN 分析，尤其是带
ORDER BY、JOIN、IN子查询的语句 - 避免在快捷入口里执行写操作（INSERT/UPDATE/DELETE），除非明确加了二次确认弹窗和权限校验
- 如果用的是服务端代理执行（如通过
/api/sql/run），记得设置合理的超时时间，别让前端无限等待504 Gateway Timeout
工具栏看着只是几个按钮，但每个背后都连着连接状态、SQL 解析、参数绑定、环境变量、执行超时和错误降级——漏掉其中一环，用户点下去就是黑屏或静默失败。
