Log2SQL:把 MyBatis/Hibernate 日志一键还原成可执行 SQL 的 IDEA 插件
前言
日常开发中,调试 SQL 几乎是每个 Java 后端工程师绕不开的工作。ORM 框架(MyBatis、Hibernate)帮我们把对象映射成了 SQL,但真正排查问题时,我们想要的往往是那条参数已经填好、能直接丢进数据库跑的 SQL。
传统做法要么手动把 ? 一个个替换成参数值,要么在拼接 SQL 的工具里反复粘贴,繁琐且容易出错。Log2SQL 就是为了解决这个痛点而生的 IntelliJ IDEA 插件——它能自动监听你的 Run/Debug 控制台输出,把框架日志实时还原为可直接执行的 SQL。
它能做什么
Log2SQL 的核心能力可以概括为一句话:监听日志 → 还原 SQL → 辅助执行。
1. 自动监听当前项目的 Run/Debug 进程
无需手动配置、无需复制粘贴日志。插件会自动挂载到当前项目的 Run/Debug 进程上,后续控制台一有新输出,就实时捕获、实时解析。你只管正常启动服务、触发接口,SQL 会自动出现在插件面板里。
2. 还原可执行 SQL(参数已填好)
- MyBatis:识别
Preparing:(SQL 模板)与Parameters:(参数列表)两行日志,把占位符?按顺序替换为真实参数值。 - Hibernate:识别
org.hibernate.SQL(SQL 语句)与BasicBinder(参数绑定)日志,完成参数回填。
还原后的 SQL 是类型化的——字符串会自动加引号,数值、日期、布尔等按各自类型正确格式化,复制出来即可在数据库客户端直接执行。
3. 类型化参数绑定与 SQL 格式化
参数还原不是简单的字符串拼接,而是按类型绑定,避免引号、转义等手工替换时常见的坑。还原后的 SQL 还会做格式化排版,关键字对齐、换行合理,可读性远高于压成一行的原始日志。
4. 实用辅助功能
| 功能 | 说明 |
|---|---|
| 关键字检索 | 在大量 SQL 中按关键字快速过滤定位 |
| 一键复制 | 选中任意一条还原后的 SQL,直接复制到剪贴板 |
| 保留数量设置 | 自定义面板保留的历史 SQL 条数,控制内存与噪音 |
| 折叠卡片 | 每条 SQL 以卡片形式展示,可折叠展开,界面清爽 |
| 左右分栏 | 日志与还原结果左右分栏对照,边看边核对 |
5. DAO 与 XML 关联跳转
看到一条 SQL,想快速找到它的出处?Log2SQL 支持从还原结果直接跳转到对应的 DAO 方法或 Mapper XML,省去在海量代码里全文搜索的时间,定位 SQL 来源一气呵成。
6. 直接调用 IDEA Database 执行
更进一步,插件支持把还原后的 SQL 以及执行计划直接调用 IntelliJ IDEA 内置的 Database 工具窗口查询。也就是说,从"看日志"到"跑 SQL、看执行计划"可以全程在 IDEA 里完成,无需来回切换外部数据库客户端。
支持的日志格式
| 框架 | 日志来源 | 作用 |
|---|---|---|
| MyBatis | Preparing / Parameters | 提供 SQL 模板与参数列表 |
| Hibernate | org.hibernate.SQL / BasicBinder | 提供 SQL 语句与参数绑定 |
软件使用截图
[video(video-8iN7tysW-1795078089668)(type-csdn)(url-live.csdn.net/v/embed/554… 插件 Log2SQL)]
第一次安装后需要登录账号
与同类插件对比
市面上做"SQL 日志还原"的插件不算少,但多数只盯着 MyBatis、需要手动粘贴日志、还原后还得切到外部工具去跑。Log2SQL 的差异在于把「监听 — 还原 — 跳转 — 执行」整条链路在 IDEA 里做成了闭环。下面用能力矩阵直接对比(✅ 支持 / ⚠️ 部分支持 / ❌ 不支持):
| 能力维度 | Log2SQL | MyBatis Log Plugin | MyBatis Log Free | MyBatis Log Panda | MyBatisCodeHelper-Pro | DebugTools |
|---|---|---|---|---|---|---|
| MyBatis | ✅ | ✅ | ✅ | ✅ | ✅ | ⚠️ |
| Hibernate | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| 自动监听 Run/Debug 控制台 | ✅ | ❌ | ❌ | ⚠️ | ❌ | ⚠️ |
| 类型化参数还原(带类型格式化) | ✅ | ⚠️ | ⚠️ | ⚠️ | ❌ | ⚠️ |
| 还原后 SQL 格式化排版 | ✅ | ✅ | ✅ | ⚠️ | ❌ | ❌ |
| DAO ↔ Mapper XML 关联跳转 | ✅ | ❌ | ❌ | ❌ | ⚠️ | ❌ |
| 直连 IDEA Database 执行 SQL | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| 直连 IDEA Database 看执行计划 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| 关键字检索 / 折叠卡片 / 左右分栏 | ✅ | ❌ | ❌ | ⚠️ | ❌ | ❌ |
| 价格 | 低 | 部分付费 | ✅ | ✅ | ❌ | ✅ |
说明:表中第三方插件能力以其公开文档为准,"⚠️ / ❌" 指其文档中未体现相应能力,供选型参考。
一眼可见,Log2SQL 的 6 项独有 / 领先优势:
| 优势点 | Log2SQL 表现 | 同类插件现状 |
|---|---|---|
| 双 ORM 覆盖 | MyBatis + Hibernate 全支持 | 几乎清一色只做 MyBatis,Hibernate 全线缺失 |
| 真·零手动 | 自动监听 Run/Debug 后续输出 | 多数需复制粘贴日志再点解析 |
| IDE 内闭环执行 | 还原 SQL / 执行计划直连 IDEA Database 跑 | 需切到外部数据库客户端 |
| 代码级溯源 | 一键跳转 DAO ↔ Mapper XML | 普遍不具备 |
| 类型化还原 | 按类型绑定,引号/转义不出错 | 多为简单字符串替换 |
| 高效交互 | 检索 / 折叠卡片 / 左右分栏 齐备 | 大多缺失 |
典型使用流程
- 正常以 Run/Debug 方式启动项目;
- 打开 Log2SQL 工具窗口,插件自动开始监听后续控制台输出;
- 触发业务接口,面板中实时出现还原后的可执行 SQL;
- 用关键字检索定位目标 SQL,格式化后一键复制;
- 需要看来源时,点击跳转到 DAO / XML;
- 需要验证时,直接把 SQL 或执行计划丢进 IDEA Database 查询。
适合谁用
- 经常需要排查、复现线上 SQL 问题的后端开发;
- 习惯在 IDEA 内一站式完成"看日志—改 SQL—执行验证"的工程师;
- 使用 MyBatis 或 Hibernate,且厌倦了手动替换
?占位符的所有人。
小结
Log2SQL 把"从 ORM 日志里扒出一条能跑的 SQL"这件重复且易错的事自动化了:自动监听、类型化还原、格式化展示、关联跳转、IDEA Database 直连执行,一整套流程都在 IDE 内闭环完成。相比同类插件,它在 ORM 覆盖度、自动化程度和 IDE 集成深度上都明显更胜一筹。
如果你也在为手动拼 SQL 而头疼,欢迎试用 Log2SQL。使用中遇到的问题或改进建议,欢迎在评论区留言交流,我会持续迭代优化。