从OCI实例通过Java连接PostgreSQL 15.3插入数据时返回自增键报错

核心矛盾定位 #

你遇到的关键矛盾是：本地连接新PostgreSQL 15.3实例插入数据完全正常，但OCI实例内的Java程序插入时报错Returning autogenerated keys is only supported for 8.2 and later servers——这说明OCI环境中的JDBC驱动误认为自己连接的是低于8.2的PostgreSQL版本，但实际目标是15.3，问题本质是「驱动感知的服务器版本」与「实际服务器版本」不匹配。

可能原因及对应解决步骤 #

1. OCI实例的Java程序实际连接旧PG8.4服务器 #

• 检查应用的数据库配置文件（如application.properties、jdbc.properties），确认url字段指向OCI上PG15.3实例的IP/域名，而非旧服务器地址。
• 在OCI实例上手动验证连接版本：执行psql -h <PG15地址> -U <用户名> -d <数据库名>，然后输入SELECT version();，确认返回结果为PostgreSQL 15.3而非8.4。

2. OCI环境存在JDBC驱动版本冲突 #

• 尽管你升级到了42.6.0版本，但OCI实例的应用运行环境（如Tomcat、容器镜像）可能残留旧版postgresql驱动jar（9.x及以下）并被优先加载。
• 排查操作：
  • 找到应用依赖目录，搜索所有postgresql-*.jar，删除除postgresql-42.6.0.jar外的所有旧包。
  • 若用Maven，执行mvn dependency:tree检查间接依赖，在pom.xml中排除旧驱动：

    <dependency>
        <!-- 示例：排除MyBatis starter中的旧PG驱动 -->
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>xxx</version>
        <exclusions>
            <exclusion>
                <groupId>org.postgresql</groupId>
                <artifactId>postgresql</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    

  • 重启应用，在日志中搜索PostgreSQL JDBC Driver，确认版本为42.6.0。

3. 连接URL强制指定错误的serverVersion参数 #

• 检查JDBC连接URL是否包含serverVersion参数，例如：

  jdbc:postgresql://xxx:5432/dbname?serverVersion=8.4
  

• 若存在该参数，直接删除，让驱动自动检测服务器版本。

4. ORM框架的主键配置不兼容 #

• 如果你使用MyBatis、JPA等框架，检查插入语句的主键配置是否强制使用旧逻辑：
  • MyBatis中，确认<insert>标签的useGeneratedKeys和keyProperty配置正确，或尝试显式使用PG原生语法：

    <insert id="insertBuyerCart">
        insert into t_buyer_cart (...) values (...) RETURNING id
    </insert>
    

  • JPA中，确认@GeneratedValue的策略适配PG版本（如GenerationType.IDENTITY）。

极简验证步骤 #

在OCI实例上编写极简Java测试类，排除框架干扰，直接验证JDBC插入：

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;

public class TestPGInsert {
    public static void main(String[] args) {
        String url = "jdbc:postgresql://你的PG15地址:5432/数据库名";
        String user = "用户名";
        String password = "密码";
        try (Connection conn = DriverManager.getConnection(url, user, password)) {
            String sql = "insert into t_buyer_cart (visitorno, chartno, lineno, thingno, flag, added_by, added_on, updated_by, updated_on, del_flag) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)";
            PreparedStatement pstmt = conn.prepareStatement(sql, PreparedStatement.RETURN_GENERATED_KEYS);
            // 填充测试参数
            pstmt.setString(1, "test_visitor");
            pstmt.setString(2, "test_chart");
            pstmt.setInt(3, 1);
            pstmt.setString(4, "test_thing");
            pstmt.setInt(5, 0);
            pstmt.setString(6, "test_user");
            pstmt.setTimestamp(7, new java.sql.Timestamp(System.currentTimeMillis()));
            pstmt.setString(8, "test_user");
            pstmt.setTimestamp(9, new java.sql.Timestamp(System.currentTimeMillis()));
            pstmt.setInt(10, 0);
            
            pstmt.executeUpdate();
            System.out.println("插入成功");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

• 编译运行后，若成功则问题出在应用框架配置；若仍报错，回到前面的步骤排查连接地址和驱动版本。

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