如何正确实现 PDO 错误处理：统一异常捕获与最佳实践-php教程-PHP中文网

如何正确实现 PDO 错误处理：统一异常捕获与最佳实践

PDO 不支持通过 if (!$connection) 检测连接失败，因其构造函数默认不抛异常；正确做法是启用 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，并用 try-catch 全局包裹业务逻辑，统一处理所有运行时异常（包括连接、查询、绑定等环节）。

pdo 不支持通过 `if (!$connection)` 检测连接失败，因其构造函数默认不抛异常；正确做法是启用 `pdo::attr_errmode => pdo::errmode_exception`，并用 `try-catch` 全局包裹业务逻辑，统一处理所有运行时异常（包括连接、查询、绑定等环节）。

PDO 的错误处理机制与传统的 MySQL/MySQLi 有本质区别：它不依赖返回值判断错误（如 !$conn），而是基于异常驱动（exception-based） 设计。这意味着，若未显式配置异常模式，PDO 在连接失败或查询出错时静默失败（返回 false 或触发 PHP 警告），而非抛出可捕获的异常——这正是 if (!$database_connection) 失效的根本原因。

✅ 正确配置 PDO 异常模式

在创建 PDO 实例时，必须通过选项启用异常模式：

$data_source_name = "mysql:host=$db_host;dbname=$db_name;charset=utf8mb4";
$options = [
    PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION, // 关键：启用异常
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES   => false, // 禁用模拟预处理，确保真实参数绑定
];

try {
    $database_connection = new PDO($data_source_name, $db_username, $db_password, $options);
} catch (PDOException $e) {
    // 连接失败时立即捕获（如主机不可达、认证失败、数据库不存在）
    error_log("Database connection failed: " . $e->getMessage());
    die("服务暂时不可用，请稍后重试。");
}

⚠️ 注意：charset=utf8mb4 和 PDO::ATTR_EMULATE_PREPARES => false 是安全与兼容性必备项，避免乱码和 SQL 注入绕过风险。

✅ 统一 `try-catch` 包裹完整业务流程

不应仅对连接做异常处理，而应将整个数据操作链（准备 → 执行 → 业务后续）置于同一 try 块中，并捕获最通用的 Throwable（兼容 PHP 7+ 的所有可抛出类型）：

try {
    // 已建立的 $database_connection（异常模式已启用）

    $sql = "INSERT INTO users (name, email) VALUES (?, ?)";
    $stmt = $database_connection->prepare($sql);
    $stmt->execute([$name, $email]); // 若 name 含 'fish'h'chips'，此处将抛出异常！

    // ✅ 后续关键操作也纳入保护范围（如发邮件、写日志、跳转）
    sendWelcomeEmail($email);
    logUserRegistration($name);

    echo "注册成功！";

} catch (PDOException $e) {
    // 专用于数据库层异常（连接、语法、约束冲突等）
    error_log("DB Error: " . $e->getMessage() . " | SQL: " . $sql);
    http_response_code(500);
    echo "数据保存失败，请检查输入或稍后重试。";

} catch (Throwable $e) {
    // 捕获所有其他错误（文件读取失败、邮件发送异常、自定义逻辑错误等）
    error_log("Unexpected error: " . $e->getMessage());
    http_response_code(500);
    echo "系统发生未知错误，请联系管理员。";
}

❌ 常见误区与规避建议

不要只包裹 prepare() 或 execute()：单点捕获无法覆盖连接失败、后续业务异常，违背“关注结果而非环节”的设计哲学。
不要手动拼接 SQL 或跳过参数化：$sql = "INSERT ... '$name'" 会使预处理失效，且 fish'h'chips 类输入直接导致语法错误（非异常，而是静默失败或警告）。
避免高频邮件告警：生产环境切勿在 catch 中直接 mail() —— 可能被刷爆。推荐接入 Sentry、Logstash 或写入结构化日志文件，配合监控告警系统。