本文详解如何解决jdbc执行insert时因重复主键导致的sqlintegrityconstraintviolationexception异常，重点介绍手动id管理的风险及推荐使用mysql auto_increment自动递增策略。
本文详解如何解决jdbc执行insert时因重复主键导致的sqlintegrityconstraintviolationexception异常，重点介绍手动id管理的风险及推荐使用mysql auto_increment自动递增策略。
java.sql.SQLIntegrityConstraintViolationException: Duplicate entry '4' for key 'employee.PRIMARY' 这一错误明确指出：尝试插入ID为4的员工记录时，数据库中已存在相同主键值，违反了employee表的主键约束（PRIMARY KEY）。根本原因在于——当前代码完全依赖用户手动输入ID，未校验其唯一性，也未启用数据库自增机制。
? 问题定位与分析
从堆栈可知，异常发生在EmployeeDaoImpl.createEmployee()方法第22行（pstm.executeUpdate()），而用户输入ID为4，恰好与数据库中已有记录冲突。查看DAO实现可发现两个关键问题：
- 重复执行executeUpdate()：代码中调用了两次pstm.executeUpdate()，第二次调用无意义且易引发逻辑混淆；
- 缺乏ID生成策略：ID由用户键盘输入（sc.nextInt()），既不可靠又无法保证全局唯一。
✅ 推荐解决方案：启用MySQL AUTO_INCREMENT
最健壮、标准的做法是将employee.id字段设为自增主键，由数据库自动分配唯一ID，彻底规避手动冲突风险。
步骤1：修改数据库表结构（执行一次即可）
ALTER TABLE employee MODIFY COLUMN id INT AUTO_INCREMENT PRIMARY KEY;
✅ 注意：若id列已存在数据，确保其值连续且无重复；若需重置自增值，可加 AUTO_INCREMENT = 1001（从1001开始）。
Java JDK 25下载Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
步骤2：更新Java代码（移除手动ID赋值）
-
DAO层：修改SQL语句，不显式插入id字段，让数据库自动生成：
@Override public void createEmployee(Employee emp) { try (Connection con = DBConnection.createDBConnetion(); PreparedStatement pstm = con.prepareStatement( "INSERT INTO employee (name, salary, age) VALUES (?, ?, ?)")) { pstm.setString(1, emp.getName()); pstm.setDouble(2, emp.getSalary()); pstm.setInt(3, emp.getAge()); int rowsAffected = pstm.executeUpdate(); if (rowsAffected > 0) { System.out.println("Employee inserted successfully."); } } catch (SQLException e) { throw new RuntimeException("Failed to insert employee", e); } } -
主程序：删除用户输入ID的逻辑，不再调用emp.setId(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); break;
⚠️ 补充说明与最佳实践
- 资源安全：使用try-with-resources自动关闭Connection和PreparedStatement，避免连接泄漏；
- 异常处理：捕获SQLException并包装为业务异常，便于上层统一处理；
- 如必须保留手动ID：需在插入前执行SELECT COUNT(*) FROM employee WHERE id = ?校验，但强烈不推荐——违背数据库设计原则，且并发场景下仍存在竞态风险；
- 验证效果：插入后可通过SELECT LAST_INSERT_ID()获取刚生成的ID（若需返回给业务层）。
通过启用AUTO_INCREMENT并重构DAO逻辑，不仅能彻底解决主键冲突问题，还能提升系统可靠性、简化代码逻辑，并符合关系型数据库的最佳实践。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
