在 mybatis 中配置 sql 日志,核心做法是将 `org.apache.ibatis.logging.stdout.stdoutimpl` 设置为 mybatis 的日志实现类。具体操作是在 mybatis 主配置文件 `

MyBatis 全局配置文件中如何设置日志实现
要启用 SQL 日志,需要在 `mybatis-config.xml` 或 Spring Boot 的 `application.yml` 中进行配置。对于传统的 MyBatis 独立项目,修改 XML 配置文件是最直接的方式。通过指定 `logImpl` 属性为 `STDOUT_LOGGING`,MyBatis 会在执行 SQL 时自动调用标准输出流进行记录。

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<settings>
<!-- 设置日志实现为标准输出 -->
<setting name="logImpl" value="STDOUT_LOGGING" />
</settings>
<mappers>
<mapper resource="mappers/UserMapper.xml"/>
</mappers>
</configuration>上述代码展示了完整的 MyBatis 配置文件结构。关键部分在于 `
立即学习“Java免费学习笔记(深入)”;
Spring Boot 项目中如何通过 YAML 配置 SQL 日志
在 Spring Boot 集成 MyBatis 的场景下,通常不需要单独的 `mybatis-config.xml`,而是直接在 `application.yml` 或 `application.properties` 中配置。这种方式更加简洁,且能更好地与 Spring 的环境管理结合。同样使用 `logImpl` 属性,但配置路径不同。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

# application.yml
mybatis:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl这段 YAML 配置将 MyBatis 的日志实现指向了 `StdOutImpl`。在 Spring Boot 启动后,MyBatis 会自动加载该配置。开发者可以在控制台中看到类似以下的输出: ```text Creating a new SqlSession SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@...] was not registered for synchronization because synchronization is not active JDBC Connection [HikariProxyConnection@...] wrapping com.mysql.cj.jdbc.ConnectionImpl Preparing Statement: SELECT * FROM users WHERE id = ? Parameter Binding: {1=1} ResultSet: [User{id=1, name='Alice'}] ```
这种配置方式适用于大多数基于 Spring Boot 的项目。如果项目同时使用了 Lombok 或其他插件,确保这些插件不会干扰日志的输出格式。此外,如果需要更详细的日志信息,如 SQL 执行时间,可以结合 SLF4J 和 Logback 进行更复杂的配置,但对于单纯的 SQL 调试,`STDOUT_LOGGING` 已经足够。
SQL 日志输出中包含哪些具体信息
当启用 `STDOUT_LOGGING` 后,输出的日志内容非常详细,包含了 SQL 语句、参数绑定、连接状态以及结果集信息。这些信息对于排查 SQL 错误、性能问题或数据不一致非常有帮助。例如,可以看到预处理语句(PreparedStatement)的具体内容,以及参数是如何绑定的。
以下是一个典型的日志输出片段分析:
==> Preparing: SELECT * FROM users WHERE age > ? AND status = ? ==> Parameters: 18(String), 'active'(String) <== Total: 1
第一行显示了原始 SQL 模板,其中 `?` 是占位符。第二行显示了实际绑定的参数值及其类型,这对于检查参数是否正确传递至关重要。第三行显示了查询返回的行数。如果发生异常,日志中还会包含堆栈跟踪信息,帮助定位问题所在。需要注意的是,生产环境中不建议开启此日志,因为它会显著增加 I/O 开销并可能泄露敏感数据。

















