调试
SQL调试
开启 SQL 跟踪，查看 MySQL、ClickHouse、PostgreSQL 的 SQL 执行情况。
Cool Request 支持在项目运行时跟踪数据库 SQL 执行情况。只需要在 CoolRequest 设置中开启 SQL 跟踪，即可监控应用执行的 MySQL、ClickHouse、PostgreSQL SQL，并查看 SQL 内容、执行耗时和异常信息。
开启 SQL 跟踪
- 进入
CoolRequest设置。 - 进入 Trace 跟踪相关配置。
- 开启 SQL 跟踪。
- 重新发起业务请求或方法调用，在 SQL 跟踪面板中查看本次执行的 SQL 记录。
提示
SQL 跟踪需要应用在运行或调试状态下产生真实数据库访问。开启后，再执行 HTTP 请求、Call This Method、Dubbo 调用或其他会访问数据库的业务逻辑，即可看到对应 SQL。
支持的数据库
当前 SQL 跟踪支持以下数据库执行日志：
- MySQL
- ClickHouse
- PostgreSQL
对于使用连接池、ORM 框架或 MyBatis 的项目，只要最终通过受支持数据库驱动执行 SQL，Cool Request 就可以跟踪到对应的 SQL 执行情况。
适用场景
- 调试接口时确认实际执行的 SQL 是否符合预期。
- 分析一次请求中数据库访问次数和耗时。
- 排查 MySQL、ClickHouse、PostgreSQL 查询异常。
- 定位慢 SQL、重复查询和错误参数绑定问题。
- 配合 MyBatis 调试结果，确认预览 SQL 与运行时 SQL 是否一致。
调试建议
- 开启 SQL 跟踪后再执行目标业务操作，避免历史 SQL 干扰判断。
- 排查慢接口时，优先按执行耗时排序或关注耗时较高的 SQL。
- 如果没有看到 SQL 记录，先确认业务逻辑确实访问了数据库，并确认数据库类型在支持范围内。
- 写操作调试前确认当前连接的数据库环境，避免对生产或重要数据产生误操作。
- 问题定位完成后，可以关闭 SQL 跟踪，减少调试信息对日常开发界面的干扰。