使用mysqli::debug 比對開發環境和線上環境行為差異

M66 2025-06-06

在Web 開發中，尤其是在使用PHP + MySQL 的項目裡，開發環境和線上環境的數據庫行為差異往往會引起一系列詭異問題。比如某些查詢在本地飛快，而線上卻慢如蝸牛；或者在本地沒報錯，線上卻執行失敗。這種情況，如果沒有明確的線索去追踪，可能會浪費大量時間。

好在PHP 的mysqli擴展提供了一個非常實用的調試工具—— mysqli::debug()方法。雖然這個方法不太為人所知，但在某些場景下，它可以提供關鍵性的幫助，尤其是在定位問題和優化性能方面。

一、什麼是mysqli::debug()？

mysqli::debug()是mysqli類的一個靜態方法，用於啟用調試輸出。它允許你將libmysqlclient的調試信息記錄下來。格式如下：

 mysqli::debug("d:t:o,/tmp/client.trace");

參數說明：

d ：打開調試
t ：為每個線程建立一個調試文件
o,/tmp/client.trace ：指定輸出文件路徑

?? 注意：該方法只在使用libmysqlclient的情況下有效，且通常只在調試階段開啟，生產環境應避免默認開啟。

二、如何應用到開發vs 線上環境對比中？

以下是一個典型的使用場景：

開發環境代碼示例：

 <?php
mysqli::debug("d:t:o,/tmp/dev_trace.log");

$mysqli = new mysqli("localhost", "user", "password", "database");

if ($mysqli->connect_error) {
    die("連接失敗: " . $mysqli->connect_error);
}

$result = $mysqli->query("SELECT * FROM users WHERE status = 'active'");

while ($row = $result->fetch_assoc()) {
    echo $row['name'] . "<br>";
}

$mysqli->close();
?>

你可以通過查看/tmp/dev_trace.log文件，了解SQL 執行過程、連接過程等細節。

線上環境開啟調試（短時間開啟即可）：

 <?php
mysqli::debug("d:t:o,/tmp/prod_trace.log");

$mysqli = new mysqli("127.0.0.1", "user", "password", "database");

// 一般我們建議記錄訪問接口，比如：
$url = "https://m66.net/api/user/status"; // 示例 URL
file_put_contents("/tmp/trace_log_access.log", "訪問了: $url\n", FILE_APPEND);

$result = $mysqli->query("SELECT * FROM users WHERE status = 'active'");

while ($row = $result->fetch_assoc()) {
    // 簡化處理
}

$mysqli->close();
?>

你可以將開發和生產環境的trace 文件進行對比，比如用diff 工具或IDE 的對比功能，查看哪些行為不一致：

查詢執行時間差異
是否發生了隱式轉換（如字符串轉數字）
是否有連接重試
SQL 優化器是否選擇了不同的索引

三、優化性能的關鍵思路

通過比對兩個環境的trace 文件，你可以：

識別慢查詢的原因：
- 查詢邏輯沒變，但線上慢？可能是索引沒同步。
確認連接配置差異：
- max_allowed_packet、timeout 設置不同可能會影響行為。
識別數據庫版本差異的影響：
- 某些SQL 寫法在5.7 和8.0 中執行計劃可能大相徑庭。
輔助定位“線上無法復現”問題：
- trace 日誌可以清晰顯示整個執行過程，避免“代碼沒錯但出錯”的盲點。

四、小結

mysqli::debug()雖然不是開發者日常必用的工具，但在排查復雜的數據庫問題時，它能提供關鍵線索。將其用於開發環境與線上環境的行為對比，是一種非常低成本、高回報的調試策略。

只要掌握好使用時機，控制好權限與文件位置， mysqli::debug()就能成為你優化性能、排查差異的秘密武器。

mysqli::debug