使用 $errno 捕捉 INSERT 重复主键错误（错误号 1062）

M66 2025-06-02

在 PHP 中使用 MySQL 数据库时，插入数据时有可能会遇到一些常见的错误。其中之一就是主键冲突错误，也就是当你尝试插入一个已经存在的主键值时，MySQL 会返回一个错误，通常是错误号 1062。

在使用 mysqli 扩展时，我们可以通过 mysqli::$errno 来捕获这些错误。mysqli::$errno 属性会存储最近一次 MySQL 查询返回的错误号。通过这个属性，我们可以轻松地检测到主键冲突并进行相应的处理。

下面是一个简单的示例，展示了如何在插入数据时捕捉重复主键错误（错误号 1062）：

示例代码：

<?php
// 数据库连接配置
$servername = "localhost";
$username = "root";
$password = "password";
$dbname = "my_database";

// 创建连接
$conn = new mysqli($servername, $username, $password, $dbname);

// 检查连接是否成功
if ($conn->connect_error) {
    die("连接失败: " . $conn->connect_error);
}

// 插入数据的 SQL 语句
$sql = "INSERT INTO users (id, username) VALUES (1, 'new_user')";

// 执行 SQL 查询
if ($conn->query($sql) === TRUE) {
    echo "新记录插入成功";
} else {
    // 检查是否为重复主键错误（错误号 1062）
    if ($conn->errno == 1062) {
        echo "错误: 重复的主键值。";
    } else {
        echo "错误: " . $conn->error;
    }
}

// 关闭连接
$conn->close();
?>

代码解析：

数据库连接：首先，我们使用 new mysqli() 创建数据库连接。我们提供数据库的主机名、用户名、密码和数据库名。如果连接失败，程序将会退出并显示错误信息。
SQL 插入语句：我们编写了一个简单的插入语句，将一条新记录插入到 users 表中。假设 id 列是主键，并且尝试插入的 id 值是 1。
执行 SQL 查询：通过 $conn->query($sql) 执行 SQL 插入操作。如果插入成功，返回值为 TRUE，并输出插入成功的提示信息。
捕捉错误：如果插入失败（例如主键冲突），$conn->errno 将会返回一个错误号。在这个例子中，我们检查 $conn->errno 是否为 1062，这是 MySQL 中重复主键错误的错误号。如果是重复主键错误，我们输出特定的错误信息：“重复的主键值”。如果是其他类型的错误，我们将显示 MySQL 返回的错误信息。
关闭连接：操作完成后，我们使用 $conn->close() 关闭数据库连接，释放资源。

小结：

通过使用 mysqli::$errno，我们可以方便地捕捉和处理 MySQL 错误，尤其是常见的重复主键错误（错误号 1062）。这种方式有助于提高程序的健壮性，避免因重复主键导致的程序崩溃或错误。

如果你还想进一步改进处理逻辑，可以在捕捉到重复主键错误时采取更合适的操作，例如跳过插入、更新现有记录，或者返回更详细的错误信息。