PHP插入数据遇重复键错误的解决方法有七种：一、INSERT IGNORE自动忽略冲突；二、ON DUPLICATE KEY UPDATE转为更新；三、先SELECT再INSERT/UPDATE（需防并发）；四、REPLACE INTO删除后插入；五、应用层预生成并校验主键；六、INSERT...SELECT结合WHERE NOT EXISTS原子插入；七、捕获SQLSTATE=23000异常处理。
如果在PHP中向数据库插入数据时提示重复键错误，通常是因为尝试插入的记录违反了主键或唯一索引约束。以下是解决此问题的步骤：
一、使用INSERT IGNORE语句
INSERT IGNORE会在遇到主键或唯一索引冲突时自动忽略当前插入操作，不报错也不影响后续SQL执行，适用于允许跳过重复数据的场景。
1、在PDO中构造SQL语句，将INSERT INTO替换为INSERT IGNORE INTO。
2、执行该语句并检查返回的受影响行数，若为0则说明被忽略。
立即学习“PHP免费学习笔记（深入）”；
3、根据业务需要决定是否记录日志或触发其他逻辑分支。
二、使用ON DUPLICATE KEY UPDATE语法
该语法在检测到主键或唯一索引冲突时，自动转为更新操作，适合需保持数据最新性的场景。
1、编写包含ON DUPLICATE KEY UPDATE子句的INSERT语句，例如：INSERT INTO users (id, name) VALUES (1, 'Alice') ON DUPLICATE KEY UPDATE name = VALUES(name)。
2、确保UPDATE部分只修改非主键字段，避免覆盖关键标识信息。
3、通过PDO::exec()或execute()执行后，检查返回值判断是插入还是更新生效。
三、先SELECT再INSERT或UPDATE
通过显式查询确认记录是否存在，再决定执行插入或更新操作，逻辑清晰且可控性强，但存在并发写入时的竞态风险。
1、使用SELECT语句查询目标主键或唯一字段是否已存在。
2、若未查到结果，则执行INSERT语句；若已存在，则执行UPDATE语句。
3、在高并发环境下，应配合事务与行级锁（如SELECT ... FOR UPDATE）保障一致性。
四、使用REPLACE INTO语句
REPLACE INTO会先尝试删除已存在的冲突记录，再插入新记录，等效于DELETE + INSERT，适用于可接受ID重置的场景。
1、将INSERT INTO语句替换为REPLACE INTO，并确保表结构支持自增主键的重新分配。
2、注意该操作会触发DELETE和INSERT两个事件，可能影响外键关联及触发器行为。
3、执行后检查返回的受影响行数，若为2则表示发生了删除与插入，若为1则为纯插入。
五、在应用层校验主键生成逻辑
针对自定义主键（如UUID、业务编码），应在PHP代码中预先生成并验证其唯一性，避免依赖数据库报错兜底。
1、使用uniqid()、random_bytes()或ramsey/uuid库生成高概率唯一的主键值。
2、在插入前调用SELECT COUNT(*)检查该值是否已在数据库中存在。
3、若存在则重新生成，循环至获得唯一值为止，同时设置最大重试次数防止死循环。
六、启用INSERT ... SELECT结合WHERE NOT EXISTS
利用子查询在SQL层面完成存在性判断与插入动作的原子组合，规避应用层竞态，适合单条插入且需强一致性的场景。
1、构造形如INSERT INTO t1 (a,b) SELECT 'val1','val2' FROM DUAL WHERE NOT EXISTS (SELECT 1 FROM t1 WHERE a = 'val1')的语句。
2、确保DUAL表在目标数据库中可用（MySQL支持，其他数据库需适配虚拟表语法）。
3、执行后检查受影响行数，0表示因条件不满足未插入，1表示成功插入。
七、捕获并解析PDO异常中的SQLSTATE码
当必须依赖数据库报错反馈时，可通过捕获PDOException并比对SQLSTATE值精准识别重复键错误，实现差异化处理。
1、在try-catch块中执行INSERT语句，捕获PDOException异常。
2、调用$e->getCode()获取SQLSTATE码，MySQL重复主键对应23000，唯一索引冲突也返回23000。
3、根据SQLSTATE码分支处理：记录告警、切换插入策略或抛出自定义业务异常。
