首先在 https://dev.mysqlserver.cn/doc/ 搜索 MySQL 在线手册。我们会通过频繁更新手册来解决新发现的问题，以保持手册的最新状态。此外，手册附带的发行说明可能特别有用，因为新版本很可能包含您的问题的解决方案。您可以在手册的相同位置找到发行说明。

如果您收到 SQL 语句的解析错误，请仔细检查您的语法。如果您找不到任何错误，则极有可能您当前版本的 MySQL 服务器不支持您正在使用的语法。如果您正在使用当前版本，并且手册中未涵盖您正在使用的语法，则 MySQL 服务器不支持您的语句。

如果手册涵盖了您正在使用的语法，但是您使用的是较旧版本的 MySQL 服务器，则应查看 MySQL 更改历史记录，以了解该语法何时实现。在这种情况下，您可以选择升级到较新版本的 MySQL 服务器。

有关一些常见问题的解决方案，请参阅第 B.3 节，“问题和常见错误”。

在 http://bugs.mysql.com/ 搜索错误数据库，以查看该错误是否已报告并修复。

您还可以使用 https://www.mysqlserver.cn/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 等语言编写的程序，请包含语言处理器版本号以及程序使用的任何模块版本号。例如，如果您有一个使用 DBI 和 DBD::mysql 模块的 Perl 脚本，请包含 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 版本和发行版”。