SQL 語法寫錯了怎麼辦？用PDO::errorCode 精准定位錯誤原因

gitbox 2025-09-08

<span><span><span class="hljs-meta"><?php</span></span><span>
</span><span><span class="hljs-comment">// 這裡的代碼只是佔位，與正文內容無關</span></span><span>
</span><span><span class="hljs-variable">$foo</span></span><span> = </span><span><span class="hljs-string">"bar"</span></span><span>;
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"這個部分與文章無關，僅作演示用。"</span></span><span>;
</span><span><span class="hljs-meta">?></span></span><span>

<hr>

<h1>SQL 語法寫錯了怎麼辦？用 PDO::</span><span><span class="hljs-variable constant_">errorCode</span></span><span> 精准定位錯誤原因</h1>

<p>
在使用 PHP 進行數據庫操作時，SQL 語法錯誤是開發過程中常見的“坑”。尤其是當 SQL 較為複雜時，錯誤信息如果不夠明確，很容易讓我們花大量時間排查。幸運的是，PDO 提供了 <code>PDO::</span><span><span class="hljs-variable constant_">errorCode</span></span><span>

在這個例子中，我們故意將SELECT寫成了SELEC 。運行時， $pdo->errorCode()會返回42000 ，而$pdo->errorInfo()則會給出更詳細的錯誤描述，比如"You have an error in your SQL syntax..." 。

結合errorInfo 獲取更多細節

雖然errorCode能幫助快速定位錯誤類型，但它的粒度有限。更常見的做法是同時使用errorInfo ，因為它返回一個數組：

SQLSTATE 錯誤碼
驅動程序特定的錯誤碼
驅動程序特定的錯誤消息

調試小技巧

開發環境中，開啟PDO::ERRMODE_EXCEPTION ，讓錯誤直接拋出異常，便於調試。
生產環境中，可以捕獲異常並記錄日誌，避免直接暴露數據庫結構給用戶。

總結

當SQL 語法寫錯時，不必盲目翻查代碼。利用PDO::errorCode和errorInfo ，我們可以快速、精準地定位錯誤類型和具體原因，大幅提高排錯效率。這是每個使用PHP + PDO 的開發者都應該熟練掌握的技巧。

PDO::errorCode