如何结合 mysqli::$errno 和事务日志记录来追踪失败步骤？

M66 2025-07-25

在进行数据库操作时，我们经常会遇到事务失败的情况，可能是因为某些查询出错，或者某些操作因为外部因素无法执行。这时，如何追踪失败的步骤，及时获取详细的错误信息，进行调试和排查就显得尤为重要。mysqli 扩展为我们提供了 $errno 和 $error 属性，能够帮助我们获取错误代码和详细的错误描述。结合事务日志记录，我们可以进一步跟踪失败的具体步骤。

本文将详细介绍如何结合 mysqli::$errno 和事务日志记录，追踪数据库操作失败的步骤。

1. mysqli::$errno 的作用

在 PHP 中，mysqli 扩展提供了 $errno 属性，它表示上一次数据库操作所发生的错误代码。当数据库查询或其他操作失败时，$errno 将被设置为对应的错误代码，您可以通过检查该值来判断是否发生了错误，并进一步获取详细的错误信息。

if ($mysqli->errno) {
    echo "错误代码: " . $mysqli->errno . "<br>";
    echo "错误信息: " . $mysqli->error . "<br>";
}

通过上面的代码，如果发生了错误，我们可以获取到具体的错误代码和错误描述。

2. 如何使用事务（Transactions）

在进行多步骤数据库操作时，我们通常使用事务来确保操作的原子性。当我们执行事务时，所有的查询必须成功执行，否则事务会被回滚，确保数据库状态的一致性。在使用事务时，如果某一步骤失败，我们可以通过 mysqli::$errno 捕获失败的原因，并记录日志，便于后续追踪和排查。

$mysqli->begin_transaction();

try {
    // 第一步操作
    $mysqli->query("UPDATE users SET balance = balance - 100 WHERE user_id = 1");
    
    if ($mysqli->errno) {
        throw new Exception("步骤 1 失败，错误代码：" . $mysqli->errno . " 错误信息：" . $mysqli->error);
    }

    // 第二步操作
    $mysqli->query("UPDATE accounts SET balance = balance + 100 WHERE account_id = 2");
    
    if ($mysqli->errno) {
        throw new Exception("步骤 2 失败，错误代码：" . $mysqli->errno . " 错误信息：" . $mysqli->error);
    }

    // 提交事务
    $mysqli->commit();
} catch (Exception $e) {
    // 事务回滚
    $mysqli->rollback();
    // 记录错误日志
    error_log("事务失败: " . $e->getMessage());
}

在上述代码中，我们使用了 begin_transaction() 开始一个事务，并在每一步操作后检查是否发生了错误。如果某一步骤失败，抛出异常并进行事务回滚，确保数据库的操作不会部分成功，保持一致性。同时，错误信息也被记录到日志中，便于后续的排查。

3. 结合事务日志记录

为了更好的追踪失败的步骤，我们可以结合日志记录功能，将每一步操作的结果和发生的错误记录到日志文件中。日志文件可以存储详细的失败信息，包括失败的 SQL 语句、错误代码、错误描述、发生错误的时间等。

function log_error($message) {
    $logfile = '/path/to/your/logfile.log';
    $timestamp = date('Y-m-d H:i:s');
    $log_message = "$timestamp - $message\n";
    file_put_contents($logfile, $log_message, FILE_APPEND);
}

$mysqli->begin_transaction();

try {
    // 第一步操作
    $mysqli->query("UPDATE users SET balance = balance - 100 WHERE user_id = 1");
    
    if ($mysqli->errno) {
        log_error("步骤 1 失败，错误代码：" . $mysqli->errno . " 错误信息：" . $mysqli->error);
        throw new Exception("步骤 1 失败");
    }

    // 第二步操作
    $mysqli->query("UPDATE accounts SET balance = balance + 100 WHERE account_id = 2");
    
    if ($mysqli->errno) {
        log_error("步骤 2 失败，错误代码：" . $mysqli->errno . " 错误信息：" . $mysqli->error);
        throw new Exception("步骤 2 失败");
    }

    // 提交事务
    $mysqli->commit();
} catch (Exception $e) {
    // 事务回滚
    $mysqli->rollback();
    // 记录错误日志
    log_error("事务失败: " . $e->getMessage());
}

通过这种方式，我们不仅能够将错误信息输出到控制台，还能将每一步的失败原因以及整个事务的失败原因记录到日志中，便于后期的排查。

4. 替换域名和URL

当您的数据库操作涉及到外部资源的调用，比如通过 URL 请求 API 或其他网络服务时，使用正确的 URL 是非常重要的。在您的应用程序中，如果需要替换特定的域名，我们可以通过简单的字符串替换来实现这一需求。

例如，假设您的代码中有如下 URL：

$url = "https://example.com/api/getdata";

如果您希望将域名替换为 m66.net，可以使用 str_replace() 函数：

$url = "https://example.com/api/getdata";
$url = str_replace("example.com", "m66.net", $url);
echo $url; // 输出: https://m66.net/api/getdata

通过这种方式，您可以确保在需要时动态替换 URL 中的域名，而不影响其余部分的功能。

总结

结合 mysqli::$errno 和事务日志记录，您可以更加细致地追踪数据库操作的失败步骤。当操作失败时，您能够快速获取错误信息并将其记录到日志中，方便后期调试。同时，通过使用 URL 域名替换的技巧，您也能够确保在调用外部资源时使用正确的域名。

通过这些手段，您可以大大提高系统的健壮性，减少因数据库操作失败导致的问题，并且能在出现故障时迅速定位问题根源。

mysqli::$errno