PHP PostgreSQL插入异常：脚本显示插入但数据库为空，try/catch处理重复项问题

嘿，我来帮你捋捋这个问题——脚本显示正在插入但数据库啥都没有，结合你用try/catch处理重复插入的场景，大概率是这几个地方出了问题，咱们一个个排查：

1. 事务没提交（最常见原因） #

PostgreSQL默认是开启事务的，如果你用PDO操作的话，默认自动提交是关闭的。也就是说，哪怕你执行了INSERT语句，只要没显式提交事务，数据就不会持久化到数据库里，只会在当前连接的事务中存在，连接断开就没了。

解决方法：在try块里执行完INSERT后，一定要调用commit()，异常时回滚事务：

<?php
// 假设已经建立了PDO连接
try {
    $pdo->beginTransaction(); // 显式开启事务（可选，PDO默认会自动开启）
    $sql = "INSERT INTO your_table (unique_col, other_col) VALUES (:unique_val, :other_val)";
    $stmt = $pdo->prepare($sql);
    $stmt->execute([
        ':unique_val' => 'test_unique_value',
        ':other_val' => 'test_content'
    ]);
    $pdo->commit(); // 关键！提交事务
    echo "数据插入成功";
} catch (PDOException $e) {
    $pdo->rollBack(); // 回滚事务
    // 只忽略唯一键冲突的异常
    if ($e->getCode() === '23505') { // PostgreSQL唯一键冲突的错误码是23505
        echo "数据已存在，跳过插入";
    } else {
        // 其他异常一定要打出来，方便排查
        die("插入失败：" . $e->getMessage() . " | 错误码：" . $e->getCode());
    }
}

2. catch块错误吞掉了所有异常 #

如果你在catch里不管什么异常都直接忽略，那可能插入过程中出现了其他错误（比如字段不匹配、权限不足、连接超时），但你误以为是重复数据的问题，导致脚本看似正常执行，实际根本没插入成功。

正确做法：只拦截处理重复键的异常，其他异常要输出错误信息——用PostgreSQL的错误码23505判断比匹配字符串更可靠，因为不同语言环境下错误提示可能不一样。

3. 脚本的“正在插入”是硬编码的，没关联实际执行结果 #

比如你可能在执行INSERT之前就echo了“正在向数据库插入内容”，但实际上INSERT被catch拦截了（或者执行失败），但你没更新输出内容。这种情况下，脚本的提示根本不能反映实际执行状态。

建议把输出放在INSERT成功之后，或者根据执行分支来输出：

// 不要这样：
echo "正在向数据库插入内容";
try {
    // 插入逻辑
} catch (...) {
    // ...
}

// 要这样：
try {
    // 插入逻辑
    $pdo->commit();
    echo "数据插入成功";
} catch (PDOException $e) {
    $pdo->rollBack();
    if ($e->getCode() === '23505') {
        echo "数据重复，跳过插入";
    } else {
        echo "插入失败：" . $e->getMessage();
    }
}

4. 连接的数据库不对 #

这个低级但超常见！检查下你的PHP代码里的数据库连接参数，是不是连到了测试库/另一个空库，而你查看的是生产库/目标库？比如主机、端口、数据库名有没有写错。

5. 字段约束导致插入失败 #

比如某个字段是NOT NULL但你传了NULL，或者字段类型不匹配（比如把字符串插到整数字段），这种情况下INSERT会失败，但如果你的catch没处理这类异常，又没输出错误，就会导致“看似执行但无数据”的情况。

用上面提到的错误码排查方法，把非重复键的异常信息打出来，就能很快定位这类问题。

内容的提问来源于stack exchange，提问作者sam scoot1900