NamedParameterJdbcTemplate返回1但PostgreSQL未新增数据问题排查

我是后端开发新手，使用Spring DAO的NamedParameterJdbcTemplate向PostgreSQL插入数据时遇到异常情况：

DAO代码：

public int addCompany(CompanyDto companyDto) throws DataAccessException {
        MapSqlParameterSource namedParams = new MapSqlParameterSource();
        namedParams.addValue("name", companyDto.getName());

        return namedParameterJdbcTemplate.update(
            CompanyQueries.ADD_COMPANY,
            namedParams
    );
}

SQL常量类：

public class CompanyQueries {
    public static final String ADD_COMPANY = "INSERT INTO company (name) values (:name);";
}

异常现象： #

• 调用接口触发addCompany()时，update方法返回值为1（按预期应为插入成功）
• 表的ID序列已递增，但数据库中无新增数据行
• PostgreSQL的csv日志无任何错误记录
• 使用NamedParameterJdbcTemplate执行查询功能完全正常
• 在DataGrip控制台执行相同SQL语句可正常插入数据

环境信息： #

• PostgreSQL 15
• Java 17
• Spring 6
• Spring Boot 3

可能的原因及解决办法 #

1. 事务未提交 #

Spring Boot默认事务传播行为下，若接口方法未被事务管理覆盖，或事务配置为手动提交但未执行提交操作，会出现"假成功"：SQL执行但事务回滚，而序列是独立对象不会回滚，因此序列递增但数据未保存。

解决：

• 检查接口所在类是否添加@Transactional注解，确保插入操作在事务中执行并自动提交。
• 若手动管理事务，确认执行update后调用了transactionManager.commit()。

2. 连接池自动提交配置异常 #

部分连接池默认关闭自动提交，若Spring事务管理未接管，会导致SQL执行后未提交到数据库。

解决：

• 检查application.properties/yaml中的数据库连接配置，若使用HikariCP，确保spring.datasource.hikari.auto-commit设置为true，或交由Spring事务管理统一控制。

3. 验证SQL执行的真实性 #

可以修改SQL为返回插入数据ID的形式，确认插入操作是否真实执行：

INSERT INTO company (name) values (:name) RETURNING id;

改用namedParameterJdbcTemplate.queryForObject执行，查看是否能返回ID，进一步排查问题。

4. 隔离级别导致的不可见性（低概率） #

PostgreSQL默认隔离级别为REPEATABLE READ，若插入后用同一连接查询，可能因快照读无法看到新数据，但新连接查询应能看到。可通过以下方式验证：

• 用新的数据库会话（比如DataGrip新开窗口）查询数据，确认是否真的无插入。
• 临时将隔离级别调整为READ COMMITTED测试是否正常。

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