Spring Boot嵌入式HSQLDB查询无结果，如何运行时查看数据？

我来帮你搞定这个问题！当Spring Boot整合嵌入式HSQLDB时，JPA查询返回空结果确实让人头疼，直接查看数据库里的实际数据是排查问题的关键，这里有几个实用的方案：

1. 启用HSQLDB Web控制台（最直观的方式） #

HSQLDB自带了一个Web管理控制台，开启后就能在浏览器里直接连接数据库执行查询：

• 在application.properties（或application.yml）里添加以下配置：

  spring.hsqldb.web.enabled=true
  spring.hsqldb.web.port=8082
  spring.hsqldb.web.path=/hsql-console
  

• 启动你的Spring Boot应用，访问http://localhost:8082/hsql-console
• 连接时注意：JDBC URL默认是jdbc:hsqldb:mem:testdb（如果你的嵌入式DB有自定义名称，要改成对应的URL），用户名填sa，密码留空，点击「Connect」即可进入控制台
• 现在就可以在输入框里执行SQL查询了，比如SELECT * FROM your_entity_table;，直接查看表内数据

2. 在代码中临时添加调试查询 #

如果不想开Web控制台，也可以在代码里直接执行查询并打印结果：

用JdbcTemplate的方式 #

@Autowired
private JdbcTemplate jdbcTemplate;

// 在某个服务类或测试方法中调用这个方法
public void checkDatabaseData() {
    // 替换成你的实体对应的表名
    List<Map<String, Object>> tableData = jdbcTemplate.queryForList("SELECT * FROM your_entity_table");
    System.out.println("=== 数据库表内容 ===");
    tableData.forEach(row -> System.out.println(row.toString()));
}

用EntityManager的方式 #

@Autowired
private EntityManager entityManager;

public void checkJpaEntities() {
    // 替换成你的实体类
    List<YourEntity> entities = entityManager.createQuery("SELECT e FROM YourEntity e", YourEntity.class)
                                             .getResultList();
    System.out.println("=== JPA查询到的实体 ===");
    entities.forEach(entity -> System.out.println(entity.toString()));
}

注意：调试完成后记得删除这些代码，避免留在生产环境里

3. 验证初始化脚本是否正确执行 #

有时候空结果可能是因为schema.sql或data.sql没正确执行，你可以开启日志查看脚本执行情况：

• 在application.properties中添加日志配置：

  logging.level.org.springframework.jdbc.datasource.init=DEBUG
  

• 启动应用后查看日志，确认脚本是否被加载执行，有没有报错。另外要注意HSQLDB的语法细节，比如字符串必须用单引号，表名大小写敏感（如果你的实体用了小写表名，脚本里也要对应）

4. 检查JPA实体映射是否正确 #

如果脚本执行正常但JPA查不到数据，可能是实体映射出了问题：

• 确认@Table(name = "xxx")指定的表名和schema.sql里创建的表名完全一致
• 检查@Column(name = "xxx")的字段名是否和数据库列名匹配
• 开启JPA的SQL日志，查看实际执行的SQL语句：

  logging.level.org.hibernate.SQL=DEBUG
  logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE
  

  这样能看到JPA实际发送给数据库的查询语句，就能快速定位是不是查错了表或者字段

内容的提问来源于stack exchange，提问作者Tuomas Toivonen