首先在 https://mysql.net.cn/doc/上搜索 MySQL 在线手册。我们通过经常更新新发现问题的解决方案来努力使手册保持最新状态。此外，手册随附的发行说明可能特别有用，因为较新的版本很可能包含针对您的问题的解决方案。发行说明可在刚刚为手册指定的位置获得。

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

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

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

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

您还可以使用http://www.mysql.com/search/搜索位于 MySQL 网站的所有网页（包括手册）。

您正在使用的 MySQL 发行版的版本号（例如，MySQL 5.7.10）。您可以通过执行mysqladmin version找出您正在运行的版本。mysqladmin程序可以在 MySQL bin安装目录下的目录中找到。

您遇到问题的机器的制造商和型号。

操作系统名称和版本。如果您使用 Windows，通常可以通过双击“我的电脑”图标并下拉 “帮助/关于 Windows ”菜单来获取名称和版本号。对于大多数类 Unix 操作系统，您可以通过执行命令来获取此信息uname -a。

有时内存量（真实和虚拟）是相关的。如有疑问，请包括这些值。

docs/INFO_BINMySQL 安装文件 的内容。该文件包含有关如何配置和编译 MySQL 的信息。

如果您使用的是 MySQL 软件的源代码分发，请包括您使用的编译器的名称和版本号。如果您有二进制发行版，请包括发行版名称。

如果问题发生在编译过程中，请在发生错误的文件中包括确切的错误消息以及围绕违规代码的几行上下文。

如果mysqld死了，还应该报告导致mysqld意外退出的语句。您通常可以通过在启用查询日志记录的情况下运行 mysqld来获取此信息，然后在mysqld退出后查看日志。参见 第 5.9 节，“调试 MySQL”。

如果数据库表与问题相关，请在错误报告中 包含该语句的输出。这是获取数据库中任何表的定义的一种非常简单的方法。这些信息帮助我们创造一种与您所经历的情况相匹配的情况。 SHOW CREATE TABLE db_name.tbl_name

问题发生时有效的 SQL 模式可能很重要，因此请报告 sql_mode系统变量的值。对于存储过程、存储函数和触发器对象，相关sql_mode值是创建对象时有效的值。对于存储过程或函数，SHOW CREATE PROCEDUREorSHOW 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 变量扩展状态进程列表的输出，以提供有关系统执行情况的一些信息。

如果你不能生成只有几行的测试用例，或者如果测试表太大而无法包含在错误报告中（超过 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并尝试连接给你带来麻烦的程序。

如果您有针对错误的补丁，请务必包含它。但是，如果您没有提供一些必要的信息，例如显示您的补丁修复的错误的测试用例，请不要假设补丁就是我们所需要的，或者我们可以使用它。我们可能会发现您的补丁有问题，或者我们可能根本不理解它。如果是这样，我们就不能使用它。

如果我们无法验证补丁的确切用途，我们将不会使用它。测试用例在这里帮助我们。显示补丁处理所有可能发生的情况。如果我们发现补丁不起作用的临界情况（即使是罕见的情况），它可能就没用了。

对 bug 是什么、为什么会出现或者它依赖什么的猜测通常是错误的。如果不首先使用调试器来确定错误的真正原因，即使是 MySQL 团队也无法猜测这些事情。

在您的错误报告中表明您已经检查了参考手册和邮件存档，以便其他人知道您已尝试自己解决问题。

如果您的数据出现损坏或在访问特定表时出现错误，请首先使用 CHECK TABLE. 如果该语句报告任何错误：

如果您运行的是 Windows，请验证 lower_case_table_names使用SHOW VARIABLES LIKE 'lower_case_table_names'语句的值。此变量会影响服务器处理数据库和表名称的字母大小写的方式。它对给定值的影响应如 第 9.2.3 节“标识符区分大小写”中所述。

如果您经常遇到损坏的表，您应该尝试找出发生这种情况的时间和原因。在这种情况下，MySQL 数据目录中的错误日志可能包含有关所发生情况的一些信息。（这是.err 名称中带有后缀的文件。）请参阅第 5.4.2 节，“错误日志”。请在您的错误报告中包含此文件中的任何相关信息。通常mysqld应该 永远不会破坏一个表，如果在更新过程中没有任何东西杀死它的话。如果您能找到 mysqld死机的原因，我们就可以更轻松地为您提供问题的修复程序。看 第 B.3.1 节，“如何确定导致问题的原因”。

如果可能，请下载并安装最新版本的 MySQL 服务器并检查它是否能解决您的问题。所有版本的 MySQL 软件都经过全面测试，应该可以正常工作。我们相信让一切都尽可能向后兼容，你应该能够毫无困难地切换 MySQL 版本。请参阅 第 2.1.2 节，“安装哪个 MySQL 版本和发行版”。