最近在折腾wordpress博客，连接MySQL数据库时提示拒绝访问。经过排查，解决了问题。这里记录下解决问题的方案，以及解决的思路。如有遇到类似问题的读者可以参考下。

用wordpress搭博客，数据库采用MySQL。为了调试方便，创建账户my_account ，允许它从任意主机访问数据库。

修改 wp-config.php 相应配置，注意 DB_HOST 设置为 127.0.0.1。

部署到云服务器上，本地浏览器访问博客，提示数据库拒绝访问(本地连接远程数据没问题)，以下为错误日志。

简单排查后，解决了问题，这里记录下解决方案，以及出错的原因。

解决方案

1、方案一：删除 mysql.user表 中，Host字段为 localhost 的匿名账号(账户名为空)。

2、方案二：创建 my_account@localhost 账户，用于本地连接数据库。

笔者采用了方案 一。

首先，确认下 mysql.user 表中是否存在匿名账户。

接着，删除相应匿名账户，再次尝试登陆，成功。

问题分析

为什么匿名账户会导致数据库连接失败？

需要对MySQL的账户创建、客户端连接校验有一定的了解。

创建MySQL账户

基础语法如下：

注意点：(以下用 User 指代账户名，Host 指代 主机)

Host 表示 允许账户从哪台主机访问数据库。主要用于做安全限制，可以是 主机名、IP地址、%(通配符)；

User 允许重复，只要 Host 是不同的就行。

当 Host 设置为 % 时，表示允许从任意主机连接数据库。

比如，存在两个xiaoming账户，一个允许从本机连接数据库，一个允许从 14.215.177.39 连接数据库。

匿名账户

也就是 User 为空的账户，可以匹配任意用户名。如下指令创建了匿名账户。

身份校验

数据库服务器收到客户端连接，首先会进行身份校验，将 User、Host、Password 字段，跟 mysql.user 表里的记录进行比较，确认是否合法账户。

这里有个问题：如果 mysql.user表 中存在多条匹配记录，该以哪条记录为准？

答案是“优先级”。大致规则如下：

首先，检查 Host 字段。如果有多个 Host 符合条件，则选择匹配度最高的记录(IP地址 > 通配符%)。

其次，检查 User 字段。如果有多个 User 符合条件，则选择匹配度最高的记录。匿名用户可以匹配任何用户，因此匹配度最低。

优先级匹配例子

举例，假设本地数据库有如下两个账户(Password字段实际非明文)。

运行如下命令，最终登录的账户，匹配的是 第2条 记录。(读者可自行尝试，输入密码123登录失败，输入456登录成功)

为什么呢？回顾下匹配的优先级。

首先，检查 Host 字段。localhost、% 都符合要求。localhost 匹配度高于 %，因此匹配到第2条记录。

接着，检查 User 字段。第2条记录是匿名账户，可匹配任意User值，因此，第2条记录符合要求。

因此，虽然账户 my_account 的 Host字段 为%，但是在本地(数据库所在主机)连接数据库时，因为上述规则的存在，MySQL 会认为你是用匿名账户在登录。

my_account 跟匿名账户的密码是不同的，因此密码校验不通过，拒绝访问。

写在后面

因匿名用户存在，导致本地连接数据库拒绝连接，这个问题很常见，有不少人认为这是MySQL的设计缺陷，比如 这里。

了解了MySQL的身份验证逻辑，遇到类似问题也就有思路了。关于%通配符，匹配优先级，上文并没有详细展开，感兴趣的读者可以自行查看官方文档。

另外，MySQL拒绝访问的原因有多种，读者应具体问题具体分析。

如有错漏，敬请指出。