java DAO数据访问对象如何调试

在 Java 中，DAO（Data Access Object）层的调试通常围绕SQL 是否正确、参数是否匹配、事务是否生效、框架映射是否准确这几个核心点。下面从通用思路 → 常见框架（JDBC / MyBatis / JPA）→ 实用技巧逐步说明。

一、DAO 调试的通用思路

无论使用什么框架，调试 DAO 都可以遵循以下步骤：

1. 确认调用链

   • Controller → Service → DAO 是否正确调用
   • 方法是否真的被执行（打断点）

2. 确认参数

   • 传入 DAO 的参数值是否符合预期
   • 是否为 null、类型是否匹配

3. 确认 SQL

   • 最终执行的 SQL 是什么
   • 参数绑定后的值是什么

4. 确认数据库

   • 数据库是否连接正确（库、表、字段）
   • 手动在数据库客户端执行 SQL 是否成功

二、不同 DAO 实现方式的调试方法

1️⃣ 原生 JDBC 调试

常见的问题

• SQL 写错
• 参数索引错误
• 忘记 commit
• 资源未关闭

调试方法

System.out.println(sql);
System.out.println("id=" + id + ", name=" + name);

✅ 推荐：

• 使用日志打印 SQL
• 使用 try-with-resources

try (PreparedStatement ps = conn.prepareStatement(sql)) {
    ps.setInt(1, id);
    System.out.println("Executing SQL: " + ps.toString());
    ps.execute();
}

2️⃣ MyBatis 调试（最常见）

✅ 开启 SQL 日志（非常重要）

方式一：logback / log4j

<logger name="com.xxx.mapper" level="DEBUG"/>

方式二：MyBatis 配置

<settings>
    <setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>

你会看到：

==>  Preparing: SELECT * FROM user WHERE id = ?
==> Parameters: 1(Integer)
<==      Total: 1

✅ 调试 Mapper 接口

• 在 Mapper 接口方法打断点
• 在 XML 的 SQL 节点检查 #{} 和 ${}

⚠️ 常见坑：

• #{} 防注入，${} 直接拼接
• 参数名不一致（尤其多参数）

User getUser(@Param("id") Integer id);

WHERE id = #{id}

✅ 使用 MyBatis Log Plugin（IDEA）

• 可以直接看到最终执行的 SQL + 参数
• 非常推荐

3️⃣ Spring Data JPA / Hibernate 调试

✅ 开启 SQL 打印

spring:
  jpa:
    show-sql: true
    properties:
      hibernate.format_sql: true

✅ 日志级别

<logger name="org.hibernate.SQL" level="DEBUG"/>
<logger name="org.hibernate.type" level="TRACE"/>

✅ 常见问题

• 实体字段和表字段不一致（@Column）
• 懒加载 LazyInitializationException
• 事务未开启导致只读

三、事务相关调试（非常重要）

常见问题

• 数据没插入
• 修改没生效
• 异常后未回滚

调试方式

@Transactional
public void test() {
    System.out.println("tx active: " + TransactionSynchronizationManager.isActualTransactionActive());
}

✅ 确认：

• 方法是否是 public
• 是否同类调用（事务失效）
• 异常是否被 catch 吞掉

四、实用调试技巧总结

✅ 必做

• 打印最终 SQL（不是代码里的 SQL）
• 打印参数值
• 手动在数据库执行 SQL

✅ 工具推荐

• IDEA Database 工具
• MyBatis Log Plugin
• p6spy（SQL 拦截）

✅ 常见错误速查

如果你愿意，可以：

• 贴一段 DAO 代码 / Mapper XML
• 说明 具体异常或现象

我可以帮你精确定位问题并给出修改方案。