在使用 Spring 的 `
JdbcTemplate` 进行数据库操作时，有时会遇到执行的 SQL 语句没有输出到
控制台的情况，这可能会影响调试和问题排查。以下是可能导致 SQL 语句未输出的原因及解决方法。
### 1.
日志级别未设置为 `
DEBUG`
Spring 的 `
JdbcTemplate` 本身并不会直接
打印 SQL 语句，而是通过
日志框架（如 Logback 或 Log4j）记录 SQL 的执行信息。通常情况下，SQL 语句会在 `
DEBUG` 级别下输出，如果
日志级别未设置为 `
DEBUG`，则无法看到 SQL 输出。
#### 解决方法
在
日志配置文件中（如 `logback-spring.xml` 或 `application.properties`），将 `org.springframework.jdbc.core` 包的
日志级别设置为 `
DEBUG`。
##### 使用 `logback-spring.xml` 配置
```xml
<configuration>
<include resource="org/springframework/boot/logging/logback/base.xml"/>
<logger name="org.springframework.jdbc.core" level="
DEBUG"/>
</configuration>
```
##### 使用 `application.properties` 配置
```properties
logging.level.org.springframework.jdbc.core=
DEBUG
```
这样配置后，`
JdbcTemplate` 执行 SQL 时会将语句输出到
控制台[^3]。
---
### 2. SQL 语句被参数化处理，未显示完整语句
当使用 `
JdbcTemplate` 的 `update` 或 `query` 方法时，SQL 语句通常以参数化形式传递（如 `?` 占位符）。此时，
日志中可能只会显示带有占位符的 SQL，而不是完整的 SQL 语句。
#### 解决方法
可以使用
日志拦截工具（如 **P6Spy**）来捕获并
打印完整的 SQL 语句。
##### 配置 P6Spy
1. 添加 P6Spy 依赖到 `pom.xml`：
```xml
<dependency>
<groupId>p6spy</groupId>
<artifactId>p6spy</artifactId>
<version>3.9.1</version>
</dependency>
```
2. 修改数据源配置：
```properties
spring.datasource.url=jdbc:p6spy:mysql://localhost:3306/your_database
spring.datasource.driver-class-name=com.p6spy.engine.spy.P6SpyDriver
```
3. 创建 `spy.properties` 文件：
```properties
appender=com.p6spy.engine.logging.appender.StdoutLogger
logMessageFormat=com.p6spy.engine.logging.format.Slf4JPrettySqlFormatter
customLogMessageFormat=%(currentTime) | %(executionTime) | %(category) | connection %(connectionId): %(sql)
```
配置完成后，P6Spy 会拦截所有 SQL 语句并
打印完整的 SQL 到
控制台。
---
### 3.
日志框架未正确配置或冲突
如果项目中存在多个
日志实现（如同时使用 Logback 和 Log4j），可能会导致
日志输出不正常。
#### 解决方法
确保项目中只使用一个
日志框架，并检查依赖冲突。可以通过以下方式排除冲突的
日志依赖：
##### 在 `pom.xml` 中排除 Log4j
```xml
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
```
---
### 4. 使用 `
JdbcTemplate` 时未启用
日志输出
某些情况下，`
JdbcTemplate` 可能未启用
日志输出功能，尤其是在自定义配置中。
#### 解决方法
确保 `
JdbcTemplate` 实例正确注入，并且未
禁用日志输出功能。可以通过以下方式检查：
```
java
@Autowired
private
JdbcTemplate jdbcTemplate;
```
确认 `
JdbcTemplate` 的配置中未设置
禁用日志的选项。
---
### 5.
控制台日志被过滤或未正确显示
在某些开发工具（如 IntelliJ IDEA 或 Eclipse）中，
控制台可能未正确显示所有
日志信息，或者
日志被过滤。
#### 解决方法
检查开发工具的
日志过滤设置，确保没有过滤掉 `
DEBUG` 级别的
日志。此外，可以尝试将
日志输出到文件，以确认是否为
控制台显示问题。
---
### 示例代码：验证 SQL 输出
以下是一个简单的 `
JdbcTemplate` 查询示例，用于验证 SQL 是否输出到
控制台：
```
java
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jdbc.core.
JdbcTemplate;
import org.springframework.stereotype.Repository;
import
java.util.List;
import
java.util.Map;
@Repository
public class UserRepository {
@Autowired
private
JdbcTemplate jdbcTemplate;
public List<Map<String, Object>> getAllUsers() {
String sql = "SELECT * FROM users";
return
jdbcTemplate.queryForList(sql);
}
}
```
如果配置正确，执行该方法时会在
控制台看到类似以下的输出：
```
DEBUG o.s.jdbc.core.
JdbcTemplate - Executing SQL query [SELECT * FROM users]
```
---
###
本文介绍了一种有效解决Spring Boot项目启动后控制台Debug信息过多的问题。通过调整依赖设置，快速解决了由JdbcTemplate和RestTemplate导致的日志输出过多的情况。
扫一扫
2万+
到【灌水乐园】发言
