首先在 https://mysqldev.dev.org.tw/doc/ 搜尋 MySQL 線上手冊。 我們會盡力保持手冊的最新狀態，並經常更新以解決新發現的問題。此外，手冊隨附的發行說明特別有用，因為較新的版本很有可能包含您問題的解決方案。 發行說明可從手冊的相同位置取得。

如果您收到 SQL 陳述式的語法錯誤，請仔細檢查您的語法。如果您找不到任何語法錯誤，則極有可能是您目前版本的 MySQL 伺服器不支援您使用的語法。如果您使用的是最新版本，且手冊未涵蓋您使用的語法，則表示 MySQL 伺服器不支援您的陳述式。

如果手冊涵蓋您使用的語法，但您使用的是舊版本的 MySQL 伺服器，您應該查看 MySQL 變更記錄以了解該語法何時實作。 在這種情況下，您可以選擇升級到較新版本的 MySQL 伺服器。

如需某些常見問題的解決方案，請參閱 第 B.3 節， 「問題與常見錯誤」。

在 http://bugs.mysql.com/ 搜尋錯誤資料庫，以查看該錯誤是否已回報和修正。

您也可以使用 https://mysql.dev.org.tw/search/ 來搜尋 MySQL 網站上的所有網頁 (包括手冊)。

您正在使用的 MySQL 發行版本號碼（例如，MySQL 5.7.10）。您可以執行 mysqladmin version 來找出您正在執行的版本。mysqladmin 程式可以在您的 MySQL 安裝目錄下的 bin 目錄中找到。

您遇到問題的電腦的製造商和型號。

作業系統的名稱和版本。如果您使用 Windows，通常可以透過雙擊「我的電腦」圖示，然後下拉「說明/關於 Windows」選單來取得名稱和版本號碼。對於大多數類 Unix 作業系統，您可以執行 uname -a 命令來取得此資訊。

有時記憶體容量（實體和虛擬）也很重要。如果不確定，請包含這些值。

您的 MySQL 安裝目錄中 docs/INFO_BIN 檔案的內容。此檔案包含有關 MySQL 如何配置和編譯的資訊。

如果您使用的是 MySQL 軟體的原始碼發行版本，請包含您使用的編譯器的名稱和版本號碼。如果您使用的是二進位發行版本，請包含發行版本名稱。

如果問題發生在編譯期間，請包含確切的錯誤訊息，以及發生錯誤的檔案中，錯誤程式碼周圍的幾行上下文。

如果 mysqld 停止運作，您還應回報導致 mysqld 意外退出的陳述式。您通常可以透過啟用查詢記錄的方式執行 mysqld，然後在 mysqld 退出後查看記錄來取得此資訊。請參閱第 7.9 節，「偵錯 MySQL」。

如果資料庫表格與問題相關，請在錯誤報告中包含 SHOW CREATE TABLE db_name.tbl_name 陳述式的輸出。這是取得資料庫中任何表格定義的非常簡單的方法。此資訊可協助我們建立符合您所經歷情況的情境。

問題發生時生效的 SQL 模式可能很重要，因此請回報 sql_mode 系統變數的值。對於預存程序、預存函數和觸發程序物件，相關的 sql_mode 值是在建立物件時生效的值。對於預存程序或函數，SHOW CREATE PROCEDURE 或 SHOW CREATE FUNCTION 陳述式會顯示相關的 SQL 模式，或者您可以查詢 INFORMATION_SCHEMA 以取得資訊。

SELECT ROUTINE_SCHEMA, ROUTINE_NAME, SQL_MODE
FROM INFORMATION_SCHEMA.ROUTINES;

對於觸發程序，您可以使用此陳述式。

SELECT EVENT_OBJECT_SCHEMA, EVENT_OBJECT_TABLE, TRIGGER_NAME, SQL_MODE
FROM INFORMATION_SCHEMA.TRIGGERS;

對於與效能相關的錯誤或 SELECT 陳述式的問題，您應始終包含 EXPLAIN SELECT ... 的輸出，以及 SELECT 陳述式產生的至少行數。您還應包含每個相關表格的 SHOW CREATE TABLE tbl_name 的輸出。您提供的有關您情況的資訊越多，有人能夠幫助您的可能性就越高。

以下是一個很好的錯誤報告範例。這些陳述式是使用 mysql 命令列工具執行的。請注意，對於否則會提供難以閱讀的非常長輸出行的陳述式，使用了 \G 陳述式終止符號。

mysql> SHOW VARIABLES;
mysql> SHOW COLUMNS FROM ...\G
       <output from SHOW COLUMNS>
mysql> EXPLAIN SELECT ...\G
       <output from EXPLAIN>
mysql> FLUSH STATUS;
mysql> SELECT ...;
       <A short version of the output from SELECT,
       including the time taken to run the query>
mysql> SHOW STATUS;
       <output from SHOW STATUS>

如果在執行 mysqld 時發生錯誤或問題，請嘗試提供可重現該異常的輸入腳本。此腳本應包含任何必要的原始程式碼檔案。腳本可以越接近重現您的情況越好。如果您可以建立可重現的測試案例，您應該將其上傳以附加到錯誤報告。

如果您無法提供腳本，您至少應在報告中包含 mysqladmin variables extended-status processlist 的輸出，以提供有關您系統效能的一些資訊。

如果無法產生只有幾行的測試案例，或者測試表格太大而無法包含在錯誤報告中（超過 10 行），您應該使用 mysqldump 轉儲您的表格，並建立一個描述您問題的 README 檔案。使用 tar 和 gzip 或 zip 建立您的檔案的壓縮封存檔。在您於 http://bugs.mysql.com/ 啟動我們錯誤資料庫的錯誤報告後，按一下錯誤報告中的「檔案」索引標籤，以取得有關將封存檔上傳至錯誤資料庫的指示。

如果您認為 MySQL 伺服器從某個陳述式產生了奇怪的結果，請不僅包含結果，還應包含您認為結果應該是什麼，以及說明您觀點依據的解釋。

當您提供問題範例時，最好使用您實際情況中存在的表格名稱、變數名稱等等，而不是想出新的名稱。問題可能與表格或變數的名稱相關。這些情況可能很少見，但謹慎總比後悔好。畢竟，對您來說，提供使用您實際情況的範例應該更容易，而且無論如何對我們來說都更好。如果您有不想在錯誤報告中對其他人公開的資料，您可以按照先前的說明使用「檔案」索引標籤上傳。如果資訊確實是最高機密，您甚至不想向我們顯示，請繼續提供使用其他名稱的範例，但請將此視為最後的選擇。

如果可能，請包含提供給相關程式的所有選項。例如，請指出您在啟動 mysqld 伺服器時使用的選項，以及您執行任何 MySQL 用戶端程式時使用的選項。mysqld 和 mysql 等程式，以及 configure 腳本的選項通常是解決問題的關鍵，而且非常重要。包含它們絕不是壞主意。如果您的問題涉及使用 Perl 或 PHP 等語言編寫的程式，請包含語言處理器的版本號碼，以及程式使用的任何模組的版本。例如，如果您的 Perl 腳本使用 DBI 和 DBD::mysql 模組，請包含 Perl、DBI 和 DBD::mysql 的版本號碼。

如果您的問題與權限系統相關，請包含 mysqladmin reload 的輸出，以及您在嘗試連線時收到的所有錯誤訊息。當您測試您的權限時，您應執行 mysqladmin reload version 並嘗試使用給您帶來麻煩的程式進行連線。

如果您有錯誤的修補程式，請務必包含。但是，不要假設修補程式是我們需要的全部，或者如果沒有提供一些必要的資訊（例如顯示修補程式修正錯誤的測試案例），我們可以使用它。我們可能會發現您的修補程式存在問題，或者我們可能根本不理解它。如果這樣，我們就無法使用它。

如果我們無法驗證修補程式的確切目的，我們將不會使用它。測試案例在這裡可以幫助我們。證明修補程式可以處理可能發生的所有情況。如果我們發現修補程式無法運作的邊緣案例（即使是很罕見的案例），它也可能毫無用處。

關於錯誤是什麼、為什麼發生或它取決於什麼的猜測通常是錯誤的。即使是 MySQL 團隊，在沒有先使用偵錯工具來確定錯誤的真正原因之前，也無法猜測這些事情。

在您的錯誤報告中指出您已檢查參考手冊和郵件封存，以便其他人知道您已嘗試自行解決問題。

如果您的資料出現損毀，或是在存取特定表格時發生錯誤，請先使用 CHECK TABLE 檢查您的表格。如果該語句回報任何錯誤

如果您執行的是 Windows，請使用 SHOW VARIABLES LIKE 'lower_case_table_names' 語句驗證 lower_case_table_names 的值。此變數會影響伺服器如何處理資料庫和表格名稱的大小寫。其對於給定值的影響應如第 11.2.3 節，「識別符號大小寫敏感度」中所述。

如果您經常遇到表格損毀的情況，您應該嘗試找出這種情況發生的時間和原因。在這種情況下，MySQL 資料目錄中的錯誤日誌可能會包含一些關於發生情況的資訊。（這是在名稱中帶有 .err 後綴的檔案。）請參閱第 7.4.2 節，「錯誤日誌」。請在您的錯誤報告中包含此檔案中的任何相關資訊。正常情況下，如果 mysqld 在更新過程中沒有被強制終止，絕對不應該損毀表格。如果您可以找到 mysqld 停止運作的原因，我們將更容易為您提供問題的修復方案。請參閱第 B.3.1 節，「如何判斷問題的原因」。

如果可以，請下載並安裝最新版本的 MySQL 伺服器，並檢查是否能解決您的問題。所有版本的 MySQL 軟體都經過徹底測試，應能正常運作。我們致力於盡可能地實現向後相容性，您應該可以順利切換 MySQL 版本。請參閱第 2.1.2 節，「要安裝哪個 MySQL 版本和發行版本」。