本文目录导读：
在PHP项目中,防止重复数据入库最直接有效的方法就是使用数据库的唯一约束，这不仅仅是一种代码逻辑，更是一种数据完整性保障。
下面从实现方式、代码处理、注意事项三个层面详细讲解。
核心：数据库层面设置唯一约束（最重要的防线）
这是最根本的保证,即使你的PHP代码有BUG，或者有并发请求，数据库也能从底层阻止重复数据。
单字段唯一约束
确保用户的 email 不重复。
-- 建表时设置
CREATE TABLE `users` (
`id` INT AUTO_INCREMENT PRIMARY KEY,
`email` VARCHAR(255) NOT NULL,
`username` VARCHAR(100),
UNIQUE KEY `unique_email` (`email`) -- 给约束起个名字，方便后续删除或修改
);
-- 如果表已存在，添加约束
-- ALTER TABLE `users` ADD UNIQUE INDEX `unique_email` (`email`);
多字段联合唯一约束
一个用户（user_id）不能对同一篇文章（post_id）重复点赞。
CREATE TABLE `likes` (
`id` INT AUTO_INCREMENT PRIMARY KEY,
`user_id` INT NOT NULL,
`post_id` INT NOT NULL,
`created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
UNIQUE KEY `unique_user_post` (`user_id`, `post_id`) -- 这两列组合起来必须唯一
);
PHP代码处理：捕获数据库异常并做友好响应
设置了唯一约束后,当试图插入重复数据时，数据库会抛出一个 Integrity constraint violation 错误（常见的SQLSTATE code是 23000，MySQL错误码通常是 1062）。
推荐的写法是： 直接执行插入，然后捕获该异常。
为什么推荐“先插后捕”而不是“先查后插”？
- 性能问题： 每次插入前都查一次数据库，多一次查询开销。
- 并发问题： 即使先查了，在查和插之间的一瞬间，另一个请求可能正好插入了相同数据，导致插入失败，这叫“竞态条件”。
- 捕获异常是原子且安全的。
代码示例（PDO方式，推荐）：
<?php
// 假设使用 PDO
try {
$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'root', 'password');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); // 开启异常模式
$email = $_POST['email'];
$username = $_POST['username'];
$stmt = $pdo->prepare("INSERT INTO users (email, username) VALUES (:email, :username)");
$stmt->execute([
':email' => $email,
':username' => $username
]);
echo "注册成功！";
} catch (PDOException $e) {
// 判断是否是因为唯一约束冲突导致的错误
// SQLSTATE[23000] 是完整性约束违反，MySQL error code 1062 是重复键
if ($e->getCode() == 23000) {
// 更精确地检查错误信息 (防止误判其他约束冲突)
// 或者使用 $e->errorInfo[1] == 1062 (MySQL专用)
if (str_contains($e->getMessage(), '1062 Duplicate entry')) {
echo "该邮箱已被注册，请使用其他邮箱。";
} else {
// 其他类型的约束冲突（如外键约束等）
echo "数据验证失败：" . $e->getMessage();
}
} else {
// 数据库连接或其他错误
echo "系统繁忙，请稍后再试。";
// 记录错误日志
error_log($e->getMessage());
}
}
代码示例（MySQLi方式）：
<?php
$mysqli = new mysqli('localhost', 'root', 'password', 'test');
if ($mysqli->connect_error) {
die('连接失败: ' . $mysqli->connect_error);
}
$email = $_POST['email'];
$username = $_POST['username'];
$stmt = $mysqli->prepare("INSERT INTO users (email, username) VALUES (?, ?)");
$stmt->bind_param("ss", $email, $username);
$stmt->execute();
if ($stmt->affected_rows > 0) {
echo "注册成功！";
} else {
// 如果插入失败，检查错误码
if ($mysqli->errno == 1062) { // MySQL特有的重复键错误码
echo "该邮箱已被注册。";
} else {
echo "插入失败：" . $mysqli->error;
}
}
$stmt->close();
$mysqli->close();
进阶：多一层应用层检查（防御性编程，可选但推荐）
虽然数据库约束是最终防线,但在某些高并发场景下（如秒杀、抢票），或者为了提供更好的用户体验（比如输入时实时提示），可以在写代码时增加一层应用层逻辑检查。
注意： 应用层检查不能替代数据库约束，只能作为补充，提高效率和体验。
思路：
- 插入前查询： 使用
SELECT ... FOR UPDATE进行行级锁，防止并发，但这会影响性能，一般用在关键业务。 - 事务 + 检查： 在一个事务里，先查询，确认没有重复，再插入，锁的粒度更可控。
// 事务加锁方式 (InnoDB引擎)
try {
$pdo->beginTransaction();
// 1. 加锁查询 (锁定可能冲突的行)
$stmt = $pdo->prepare("SELECT id FROM users WHERE email = :email FOR UPDATE");
$stmt->execute([':email' => $email]);
if ($stmt->fetch()) {
throw new Exception("该邮箱已被注册");
}
// 2. 执行插入
$stmt = $pdo->prepare("INSERT INTO users (email, username) VALUES (:email, :username)");
$stmt->execute([...]);
$pdo->commit();
echo "成功";
} catch (Exception $e) {
$pdo->rollBack();
echo "失败：" . $e->getMessage();
}
一定要避免的误区
-
完全依赖程序端
if (isset())检查，而不建唯一索引。
这是最大的错误，高并发下程序端的检查几乎无效，最终一定会有重复数据。 -
捕获异常后什么也不做，直接返回500错误或空白页。
用户不知道发生了什么，体验极差。永远要给出明确的错误提示（如“用户名已存在”）。 -
用
REPLACE INTO代替INSERT。
REPLACE会先删除再插入，如果唯一键冲突，它会把旧数据删掉，然后插入新的，这经常导致数据丢失，比如用户修改了邮箱，结果旧的用户记录被删除了，除非你明确知道你要做“覆盖”，否则慎用。
最佳实践
- 数据库： 在业务需要的字段（或多字段组合）上建立
UNIQUE INDEX。 - 代码：
- 使用
try-catch捕获PDOException或mysqli错误。 - 判断是否因为
重复键（Duplicate entry / 1062错误）导致失败。 - 给用户返回友好的错误信息（该邮箱已被注册”）。
- 使用
- 优化： 对于极高并发场景，考虑在事务中使用
SELECT ... FOR UPDATE进行行级锁检查，但这会降低吞吐量，一般用于核心业务（如支付、下单）。
一句话总结：数据库建好唯一约束，代码写好异常处理，这是防止重复数据入库最稳、最推荐的做法。
