Java中executeUpdate向PostgreSQL添加记录成功但表未更新问题

这种情况我之前排查过好几次，看起来是代码层面返回了操作成功，但数据实际没落地到数据库，大概率是事务、配置或者SQL的问题，咱们一步步来定位：

1. 事务未提交是最常见的原因 #

Spring Boot默认用声明式事务管理，如果你的addReview方法没有被@Transactional注解修饰，或者事务配置不正确，就可能导致插入操作停留在内存中，没有真正提交到数据库。

• 解决方法：在执行插入逻辑的addReview方法（或者它所在的类）上加上@Transactional注解，确保操作在事务上下文里执行，Spring会在方法正常结束时自动提交事务：

@Transactional
public void addReview(String comment, Double longitude, Double latitude, String address, String username) {
    // 你的插入逻辑代码
}

• 如果是用原生JDBC而非JdbcTemplate，一定要确认Connection的自动提交是否开启，或者手动调用connection.commit()：

Connection conn = ...;
try {
    conn.setAutoCommit(false); // 手动开启事务时需设置
    // 执行executeUpdate插入操作
    conn.commit(); // 手动提交事务
} catch (SQLException e) {
    conn.rollback(); // 异常时回滚事务
}

2. 检查数据源是否指向正确的数据库 #

别笑，这种低级错误真的很容易犯！你可能代码里连接的是测试库，但一直在查看生产库的数据，或者url里的数据库名、端口写错了。

• 核对application.yml（或application.properties）里的数据源配置：

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/your_target_db
    username: your_db_user
    password: your_db_pwd
    driver-class-name: org.postgresql.Driver

确认url中的数据库名称、IP、端口都是你正在查看的那个实例。

3. 验证SQL语句的正确性 #

虽然executeUpdate返回了成功的行数，但可能SQL本身存在隐性问题，比如字段名不匹配、类型不一致，或者PostgreSQL的大小写敏感问题（比如表字段是Comment但你写的是comment，如果创建表时加了双引号，就会严格区分大小写）。

• 建议在代码中打印完整的SQL和参数，方便排查：

public void addReview(String comment, Double longitude, Double latitude, String address, String username) {
    String sql = "INSERT INTO review (comment, longitude, latitude, address, username) VALUES (?, ?, ?, ?, ?)";
    // 生产环境建议用日志框架而非System.out
    System.out.printf("执行SQL: %s，参数：%s, %s, %s, %s, %s%n", sql, comment, longitude, latitude, address, username);
    jdbcTemplate.update(sql, comment, longitude, latitude, address, username);
}

把打印出来的SQL复制到pgAdmin或psql中手动执行，如果手动执行也插不进去，那就是表结构或SQL的问题，比如字段类型不匹配（比如longitude是NUMERIC类型，你传了字符串）、字段长度不够被截断等。

4. 排除数据库客户端缓存或读写分离的问题 #

有时候不是数据没插入，而是你查看的方式有问题：

• 刷新pgAdmin的表数据（右键表 -> 查看数据 -> 刷新），或者用psql命令行直接查询，避免客户端缓存导致的显示延迟。
• 如果你的系统用了读写分离架构，写操作提交到主库，但你查询的是从库，可能存在同步延迟，此时可以直接查询主库确认数据是否存在。

5. 检查是否有隐藏的异常导致事务回滚 #

如果代码里有try-catch块捕获了异常但没有重新抛出，可能会导致Spring无法触发事务回滚，但executeUpdate却返回了成功（比如异常发生在插入之后的逻辑）。

• 查看日志中是否有SQL相关的报错信息，或者在catch块中重新抛出RuntimeException，确保异常能被事务管理器捕获：

public void addReview(...) {
    try {
        // 插入逻辑代码
    } catch (SQLException e) {
        // 打印日志记录异常
        log.error("插入评论失败", e);
        // 重新抛出RuntimeException，触发事务回滚
        throw new RuntimeException("插入评论失败", e);
    }
}

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