Java 中 JDBC 插入数据时出现主键冲突异常的解决方案-java教程-PHP中文网

Java 中 JDBC 插入数据时出现主键冲突异常的解决方案

本文详解如何解决 JDBC 执行 INSERT 时因重复主键导致的 SQLIntegrityConstraintViolationException 异常，重点介绍手动 ID 管理的风险与自动递增（AUTO_INCREMENT）的正确配置及代码适配方法。

本文详解如何解决 jdbc 执行 insert 时因重复主键导致的 `sqlintegrityconstraintviolationexception` 异常，重点介绍手动 id 管理的风险与自动递增（auto_increment）的正确配置及代码适配方法。

该异常 Duplicate entry '4' for key 'employee.PRIMARY' 明确指出：尝试插入 ID=4 的员工记录时，数据库中已存在相同主键值。根本原因在于当前逻辑由用户手动输入 ID，而未校验其唯一性，也未启用数据库层面的自增机制。

✅ 正确做法：启用 MySQL 主键 AUTO_INCREMENT

首先，在数据库中修改 employee 表结构，确保 id 字段为 PRIMARY KEY 且启用自动递增：

ALTER TABLE employee 
MODIFY COLUMN id INT AUTO_INCREMENT PRIMARY KEY;

⚠️ 注意：若表中已有数据，执行前需确认 id 列无重复值，且建议先清空或备份数据。如需保留现有数据，可使用 ALTER TABLE employee CHANGE id id INT AUTO_INCREMENT; 并显式设置 AUTO_INCREMENT = N（N 为当前最大 ID + 1）。

✅ 代码适配：移除手动设 ID，由数据库生成

修改 Java 实体类与 DAO 层，不再由用户输入或程序设置主键 ID，而是让数据库自动生成：

Java JDK 25

Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。

下载

Employee 类中，id 字段应允许为 null 或默认为 0，且 setter 不强制调用；
INSERT SQL 语句显式指定列名，排除 id 字段；
使用 getGeneratedKeys() 获取数据库生成的 ID（可选，用于后续业务）；

更新后的 createEmployee 方法如下：

@Override
public void createEmployee(Employee emp) {
    String query = "INSERT INTO employee (name, salary, age) VALUES (?, ?, ?)";
    try (Connection con = DBConnection.createDBConnetion();
         PreparedStatement pstmt = con.prepareStatement(query, Statement.RETURN_GENERATED_KEYS)) {

        pstmt.setString(1, emp.getName());
        pstmt.setDouble(2, emp.getSalary());
        pstmt.setInt(3, emp.getAge());

        int affectedRows = pstmt.executeUpdate();
        if (affectedRows == 0) {
            throw new SQLException("Creating employee failed, no rows affected.");
        }

        // 可选：获取数据库生成的 ID
        try (ResultSet generatedKeys = pstmt.getGeneratedKeys()) {
            if (generatedKeys.next()) {
                int generatedId = generatedKeys.getInt(1);
                emp.setId(generatedId); // 同步回写到对象
                System.out.println("Employee inserted successfully with ID: " + generatedId);
            }
        }
    } catch (SQLException e) {
        throw new RuntimeException("Failed to insert employee", e);
    }
}

同时，主程序中应删除用户输入 ID 的逻辑：

case 1:
    Employee emp = new Employee();
    System.out.print("Enter Name: ");
    String name = sc.next();
    System.out.print("Enter Salary: ");
    double salary = sc.nextDouble();
    System.out.print("Enter Age: ");
    int age = sc.nextInt();

    emp.setName(name);
    emp.setSalary(salary);
    emp.setAge(age);
    dao.createEmployee(emp); // ID 由数据库自动生成
    break;

? 补充建议

永远避免“先查后插”（SELECT + INSERT）防重逻辑：在高并发下仍可能产生竞态条件，应依赖数据库约束（如 UNIQUE）+ 妥善捕获异常处理；
异常处理增强：可针对 SQLIntegrityConstraintViolationException 单独捕获，提示“ID 已存在，请检查输入或启用自增”；
连接资源管理：务必使用 try-with-resources（如上所示），避免连接泄漏；
ORM 替代方案：长期项目建议引入 MyBatis 或 Hibernate，其主键策略（如 @GeneratedValue(strategy = GenerationType.IDENTITY)）可自动适配 AUTO_INCREMENT。

通过以上调整，即可彻底规避手动 ID 冲突问题，提升系统健壮性与可维护性。