天天看点

《MySQL排错指南》——1.1 语法错误

本节书摘来自异步社区出版社《mysql排错指南》一书中的第1章,第1.1节,作者:【美】sveta smirnova(斯维特 斯米尔诺娃),更多章节内容可以访问云栖社区“异步社区”公众号查看。

这个错误听起来十分简单,但仍可能很难发现。我建议你像处理其他问题一样,非常细心地查找可能出现的sql语法错误。

类似如下错误,很容易被发现:

《MySQL排错指南》——1.1 语法错误

在这个示例中,很显然用户少转入了个“m”,错误消息也很清楚(输出结果根据页面设置进行宽度调整):

《MySQL排错指南》——1.1 语法错误

遗憾的是,不是所有的语法错误都这么显而易见。我曾经处理过一个问题,它的查询语句是这样的:

《MySQL排错指南》——1.1 语法错误

这是一个版本迁移导致的问题;该语句在5.0版本中运行正常,但是在5.1版本中出现错误。问题的原因在于,在5.1版本中,“accessible”是一个保留字。给该语句加上引号(反引号还是双引号取决于你的sql格式),即可重新正常运行:

 

《MySQL排错指南》——1.1 语法错误

实际场景中的查询语句看起来可能十分繁琐,包括大段的join和复杂的where条件。所以,即使是简单的错误在其他大量语句的干扰下也很难被查找出来。我们当时第一步的任务就是简化复杂的查询,使它变成像刚才看到的那样只有一行select的语句。这就是一个最简化测试的示例。当我们看到简化后只有一行的语句也有同样的bug时,我们就能很快意识到原有程序是因为保留字的问题而产生了错误。

第一教训就是教你把检查查询的语法错误作为排错的第一步。

但是,当你不知道查询是什么样的时候该怎么办?比如,查询是由应用程序自动生成的,或是在存储库中由第三方库动态生成的。

考虑如下php代码:

《MySQL排错指南》——1.1 语法错误

从这段脚本中很难直接定位错误。幸运的是,我们可以通过调整代码,使用输出函数打印查询语句。在php语言中,可以使用echo运算符。因此,修改代码,如下所示:

《MySQL排错指南》——1.1 语法错误

当程序输出将要提交的语句的时候,问题暴露出来了:

《MySQL排错指南》——1.1 语法错误

如果你仍然没有发现错误,你可以在mysql命令行客户端中尝试执行这个查询:

《MySQL排错指南》——1.1 语法错误

问题在于每一行都少了一个右单引号。返回php代码,需要把:

《MySQL排错指南》——1.1 语法错误

改为:

《MySQL排错指南》——1.1 语法错误

即可。

因此,一个重要的调试技巧是,始终尝试查看mysql服务器最终接收到的查询。不要仅调试应用程序代码,要获取查询语句!

遗憾的是,你不可能始终使用输出函数。比如,我之前提到的那个场景,sql语句是在编译好的第三方库中生成的。你的应用程序可能只是使用了库提供的高级的抽象接口,比如crud(新建、读、更新、删除)接口。或者在生产环境下,你不希望用户看到在使用特定参数对特定查询进行测试时的查询。在这种情况下,可以检查mysql的通用查询日志。这里用一个新示例来说明其是如何工作的。

这是一段有问题的php代码:

《MySQL排错指南》——1.1 语法错误

这段代码更新了例1.1中定义的表。

**

例1.1 一般问题情形的示例表**

《MySQL排错指南》——1.1 语法错误

现在启用通用查询日志。该日志包含mysql服务器接收到的每条独立查询。很多产品不会在日常运行中使用该日志,因为它在高负载的情况下增长十分迅速,并且写入日志会消耗mysql服务器的资源,这些资源很可能用于更重要的用途。从5.1版本开始,你可以临时打开通用查询日志,方便随时记录你需要的查询。可以通过下面命令打开日志:

《MySQL排错指南》——1.1 语法错误

也可以将日志记录在表中,这可以帮你方便地分类索引日志文件项,因为你可以像查询其他表一样访问查询日志表:

《MySQL排错指南》——1.1 语法错误

现在可以运行应用程序。经过迭代地执行问题代码后,查询通用日志记录表,以查找有问题的查询:

《MySQL排错指南》——1.1 语法错误

注意上述代码中2.row中的查询语句:

《MySQL排错指南》——1.1 语法错误

错误再次显而易见:在语句的结尾有个多余的逗号。这个问题是由下面这部分php代码产生的:

《MySQL排错指南》——1.1 语法错误

如果字符串确实是以逗号结尾的,那么rtrim函数本应移除结尾的逗号。但是现在这行实际上是以空格结尾的,因此rtrim函数没有移除任何字符。

既然我们已经发现了应用程序中产生错误的原因,我们就可以关闭通用查询日志:

《MySQL排错指南》——1.1 语法错误

在这节,我们学到一些重要的东西:

语法错误可能是导致一些现实问题的原因;

你应该测试与mysql服务器接收到的请求完全一致的查询;

编程语言的输出函数和通用查询日志可以帮助你快速定位由应用程序发送到mysql服务器的查询的问题。