如何解决Java JDBC中SQL UPDATE语句无法更新数据库的问题？

• 数据库查询操作可正常执行，能成功打印查询结果集，但所有数据更新、修改操作均不生效
• 已尝试使用prepareStatement、createStatement两种方式执行更新SQL，均未看到数据变更
• 现有更新逻辑代码如下：

public void update() throws SQLException {
    try {
        PreparedStatement preparedStatement = connection.prepareStatement(
            "UPDATE main_table SET status=? WHERE ID=1"
        );
        preparedStatement.setInt(1, 1);
        preparedStatement.executeUpdate();
    }
    catch (SQLException e) {
        System.out.println("Could not update data to the database " + e.getMessage());
    }
}

按优先级从高到低排查以下问题：

1. 未手动提交事务（最高发原因） #

JDBC连接如果关闭了自动提交（autoCommit=false），执行完executeUpdate()后更新操作仅在当前事务内生效，不会持久化到磁盘，只要连接关闭、事务回滚，所有变更都会消失，这也是能正常查询（当前事务内可以读到临时变更数据）但实际库表数据没更新的最常见原因。
修复逻辑：执行更新后判断自动提交状态，手动提交事务，异常时回滚，同时正确释放资源：

public void update() throws SQLException {
    PreparedStatement preparedStatement = null;
    try {
        preparedStatement = connection.prepareStatement(
            "UPDATE main_table SET status=? WHERE ID=1"
        );
        preparedStatement.setInt(1, 1);
        // 先获取受影响行数，判断SQL是否实际命中数据
        int affectedRows = preparedStatement.executeUpdate();
        System.out.println("更新影响行数：" + affectedRows);
        // 非自动提交模式下必须显式提交
        if (!connection.getAutoCommit()) {
            connection.commit();
        }
    } catch (SQLException e) {
        // 异常时回滚，避免脏数据残留
        if (connection != null && !connection.getAutoCommit()) {
            connection.rollback();
        }
        System.out.println("数据库更新失败：" + e.getMessage());
        throw e;
    } finally {
        // 必须关闭Statement资源，连接池场景下资源泄漏也会导致操作异常
        if (preparedStatement != null) {
            preparedStatement.close();
        }
    }
}

2. SQL未命中目标行 #

executeUpdate()返回值为本次操作实际影响的行数：

• 如果返回值为0：说明WHERE ID=1没有匹配到任何数据，或者你查询和更新操作连接的不是同一个数据库实例、同一个schema
• 如果返回值大于0但查询不到变更：优先检查事务提交逻辑，同时确认查询操作是否用了独立连接、事务隔离级别过高导致读不到已提交数据

3. 账号权限不足 #

部分数据库的账号权限是拆分配置的：如果当前连接使用的账号只有SELECT权限，没有UPDATE权限，部分JDBC驱动不会直接抛出权限异常，只会返回0行受影响，实际不会执行变更。可以直接用同一个账号在数据库客户端执行同一条UPDATE语句，验证权限是否正常。

4. 自动提交配置被意外修改 #

如果其他业务逻辑中曾手动调用connection.setAutoCommit(false)，执行完操作后没有改回true，也没有提交事务，后续所有写操作都会停留在事务临时状态，不会持久化。

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