在 MyBatis 中获取最终可执行的 SQL 语句（即包含实际参数值、而非 `?` 占位符的完整 SQL）是开发和调试中的常见需求。MyBatis 默认的日志输出只会打印带占位符的 SQL 和参数列表，无法直接复制到数据库客户端中执行。

以下是几种主流且实用的方法：

---

## 方法一：使用 MyBatis 拦截器（Interceptor）【推荐】

这是最灵活、可控性最强的方式，适用于原生 MyBatis 或 MyBatis-Plus。

### 步骤 1：创建 SQL 拼接工具类

```java
import org.apache.ibatis.mapping.BoundSql;
import org.apache.ibatis.mapping.ParameterMapping;
import org.apache.ibatis.reflection.MetaObject;
import org.apache.ibatis.reflection.SystemMetaObject;
import org.apache.ibatis.type.TypeHandlerRegistry;

import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.List;

public class SqlUtils {

    public static String getCompleteSql(BoundSql boundSql, Object parameterObject) {
        String sql = boundSql.getSql().replaceAll("[\\s]+", " "); // 去除多余空白
        List<ParameterMapping> parameterMappings = boundSql.getParameterMappings();
        TypeHandlerRegistry typeHandlerRegistry = boundSql.getConfiguration().getTypeHandlerRegistry();

        if (parameterMappings != null && !parameterMappings.isEmpty()) {
            MetaObject metaObject = parameterObject == null ? null : SystemMetaObject.forObject(parameterObject);
            for (ParameterMapping parameterMapping : parameterMappings) {
                if (parameterMapping.getMode() != ParameterMapping.Mode.OUT) {
                    Object value;
                    String propertyName = parameterMapping.getProperty();
                    if (boundSql.hasAdditionalParameter(propertyName)) {
                        value = boundSql.getAdditionalParameter(propertyName);
                    } else if (parameterObject == null) {
                        value = null;
                    } else if (typeHandlerRegistry.hasTypeHandler(parameterObject.getClass())) {
                        value = parameterObject;
                    } else if (metaObject != null && metaObject.hasGetter(propertyName)) {
                        value = metaObject.getValue(propertyName);
                    } else {
                        value = null;
                    }

                    // 处理 null
                    if (value == null) {
                        sql = sql.replaceFirst("\\?", "NULL");
                    } else {
                        // 根据类型处理引号
                        if (value instanceof String || value instanceof Date || value instanceof Character) {
                            String strValue = value.toString();
                            if (value instanceof Date) {
                                strValue = "'" + new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format((Date) value) + "'";
                            } else {
                                strValue = "'" + strValue.replace("'", "''") + "'"; // 转义单引号
                            }
                            sql = sql.replaceFirst("\\?", strValue);
                        } else if (value instanceof Number) {
                            sql = sql.replaceFirst("\\?", value.toString());
                        } else {
                            sql = sql.replaceFirst("\\?", "'" + value.toString() + "'");
                        }
                    }
                }
            }
        }
        return sql;
    }
}
```

> **注意**：上述代码对常见类型做了基本处理，实际项目中可能需要根据你的数据类型（如枚举、自定义对象、List 等）进一步完善。

### 步骤 2：创建拦截器

```java
import org.apache.ibatis.executor.statement.StatementHandler;
import org.apache.ibatis.mapping.BoundSql;
import org.apache.ibatis.plugin.*;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.sql.Connection;
import java.util.Properties;

@Intercepts({
    @Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class, Integer.class})
})
public class SqlPrintInterceptor implements Interceptor {

    private static final Logger log = LoggerFactory.getLogger(SqlPrintInterceptor.class);

    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        StatementHandler statementHandler = (StatementHandler) invocation.getTarget();
        BoundSql boundSql = statementHandler.getBoundSql();
        Object parameterObject = boundSql.getParameterObject();

        String completeSql = SqlUtils.getCompleteSql(boundSql, parameterObject);
        log.info("【最终可执行SQL】: {}", completeSql);

        return invocation.proceed();
    }

    @Override
    public Object plugin(Object target) {
        return Plugin.wrap(target, this);
    }

    @Override
    public void setProperties(Properties properties) {
        // 可配置是否开启等
    }
}
```

### 步骤 3：注册拦截器

#### XML 配置（mybatis-config.xml）
```xml
<configuration>
    <plugins>
        <plugin interceptor="com.yourpackage.SqlPrintInterceptor"/>
    </plugins>
</configuration>
```

#### Spring Boot 注解方式
```java
@Bean
@ConditionalOnMissingBean
public SqlPrintInterceptor sqlPrintInterceptor() {
    return new SqlPrintInterceptor();
}

// 在 SqlSessionFactory Bean 中注册
@Bean
public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {
    SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
    factoryBean.setDataSource(dataSource);
    factoryBean.setPlugins(new Interceptor[]{sqlPrintInterceptor()});
    return factoryBean.getObject();
}
```

---

## 方法二：使用第三方库（如 p6spy）

无需修改代码，通过代理 JDBC 驱动实现。

### 1. 添加依赖（Maven）
```xml
<dependency>
    <groupId>p6spy</groupId>
    <artifactId>p6spy</artifactId>
    <version>3.9.1</version>
</dependency>
```

### 2. 修改数据源配置
将 JDBC URL 前缀改为 `jdbc:p6spy:`，驱动类改为 `com.p6spy.engine.spy.P6SpyDriver`

例如：
```properties
# 原来
spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# 改为
spring.datasource.url=jdbc:p6spy:mysql://localhost:3306/test
spring.datasource.driver-class-name=com.p6spy.engine.spy.P6SpyDriver
```

### 3. 添加 `spy.properties`
在 `src/main/resources` 下创建 `spy.properties`：
```properties
appender=com.p6spy.engine.spy.appender.Slf4JLogger
logMessageFormat=com.p6spy.engine.spy.appender.CustomLineFormat
customLogMessageFormat=%(currentTime) | %(executionTime) ms | %(category) | connection %(connectionId) | %(sqlSingleLine)
filter=true
excludecategories=info,debug,result,batch,resultset
```

> ✅ **优点**：零代码侵入，自动输出完整 SQL  
> ❌ **缺点**：影响性能，仅适合开发/测试环境

---

## 方法三：断点调试（临时查看）

在开发时快速查看：

1. 在 `org.apache.ibatis.executor.SimpleExecutor.doQuery()` 方法中打上断点
2. 运行程序，触发 SQL 执行
3. 查看 `PreparedStatement stmt` 对象
   - 对于 **MySQL / PostgreSQL**，直接调用 `stmt.toString()` 即可看到完整 SQL（含参数）
   - 示例：`com.mysql.cj.jdbc.ClientPreparedStatement: SELECT * FROM user WHERE id = 123`

> ⚠️ 注意：Oracle 等数据库的 `toString()` 可能不支持此功能。

---

## 方法四：MyBatis-Plus 用户专属方案

如果你使用 **MyBatis-Plus**，可使用其内置的 `InnerInterceptor`：

```java
@Configuration
public class MybatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 添加其他拦截器...
        return interceptor;
    }

    // 自定义 SQL 打印拦截器
    @Bean
    public InnerInterceptor sqlLogInterceptor() {
        return new InnerInterceptor() {
            @Override
            public void beforePrepare(Executor executor, MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) throws SQLException {
                String sql = SqlUtils.getCompleteSql(boundSql, parameter);
                System.out.println("【MP 完整SQL】: " + sql);
            }
        };
    }
}
```

---

## 总结对比

| 方法 | 侵入性 | 是否需改代码 | 性能影响 | 适用场景 |
|------|--------|-------------|---------|----------|
| **MyBatis 拦截器** | 中 | 是 | 低 | 生产/开发均可，高度可控 |
| **p6spy** | 无 | 否（改配置） | 高 | 仅开发/测试环境 |
| **断点调试** | 无 | 否 | 无 | 临时排查问题 |
| **MP InnerInterceptor** | 低 | 是 | 低 | MyBatis-Plus 项目 |

> **推荐**：  
> - 开发阶段：使用 **p6spy** 快速查看  
> - 生产或长期使用：采用 **自定义拦截器** 方案，安全可控

通过以上任一方法，你都可以轻松获取 MyBatis 最终执行的、可直接在数据库中运行的完整 SQL 语句。

在 MyBatis 中获取最终可执行的 SQL 语句（即包含实际参数值、而非 ? 占位符的完整 SQL）是开发和调试中的常见需求。MyBatis 默认的日志输出只会打印带占位符的 SQL 和参数列表，无法直接复制到数据库客户端中执行。

MyBatis 调试必备：4 种方法获取最终带参数的完整可执行 SQL

前端

掌握MyBatis完整SQL语句获取的4种方法：自定义拦截器（推荐）、p6spy代理驱动、断点调试和MyBatis-Plus专属方案。开发调试必备技巧，轻松查看带参数值的可执行SQL，提升开发效率。

PostgreSQL

数据库

MySQL

腾讯云数据库特惠，新用户首单0.5折起


2026采购季 | AI焕新·智启新局

tencentdb-catalog

postgres

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

MyBatis 调试必备：4 种方法获取最终带参数的完整可执行 SQL-腾讯云开发者社区-腾讯云

MyBatis 调试必备：4 种方法获取最终带参数的完整可执行 SQL

MyBatis 调试必备：4 种方法获取最终带参数的完整可执行 SQL

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐