Webmin管理Linux服务器时Web应用无法连接已授权MySQL数据库的排查
Webmin管理场景下MySQL应用登录失败排查思路
核心排查步骤
- 核对MySQL用户的允许登录主机范围
- 通过MySQL命令行执行
SELECT user, host FROM mysql.user WHERE user = '你的应用用户名';,核对输出的host字段必须完全匹配Web应用实际发起连接的来源地址 - 如果Web应用和MySQL部署在同一台服务器,必须确认授权条目包含
localhost、127.0.0.1两个回环地址:很多人在Webmin创建用户时,误将允许主机设为服务器公网IP、外部域名,完全漏掉本机回环地址的授权,导致同机应用发起的连接被直接拦截 - 如果Web应用部署在其他服务器,必须确认授权条目的host段匹配应用服务器的实际出口IP,不要随意用全通配符
%开放所有来源的访问权限
- 通过MySQL命令行执行
- 校验权限与配置的匹配精度
- 核对Webmin中为用户分配的数据库权限条目,确认数据库名称拼写、大小写、特殊字符完全和应用实际使用的库名一致,避免因为库名匹配错误导致权限校验不通过
- 可在MySQL命令行执行权限重置操作快速排除权限配置问题:
GRANT 应用所需的最小操作权限 ON 对应数据库名.* TO '应用用户名'@'实际允许的host段';,执行后运行FLUSH PRIVILEGES;刷新MySQL权限缓存
- 逐字段核对应用的数据库连接配置
- 打开应用的
config.php配置文件,逐字段匹配实际的连接参数:重点排查几个高频踩坑点- 端口号:MySQL默认监听3306端口,如果之前修改过默认端口但未同步写入应用配置,会直接出现连接超时
- 密码特殊字符:如果设置的数据库密码包含
#、$等特殊符号,要确认配置文件中没有因为转义规则、注释规则导致密码被截断、解析错误 - 同机部署场景下,优先将数据库主机地址设为
127.0.0.1,不要填写服务器公网IP——多数服务器的防火墙规则不允许通过公网IP回环访问本机端口,会出现无响应的连接超时
- 打开应用的
- 排查系统层的连接拦截点
- 虽然已设置
bind-address = 0.0.0.0,仍需检查几类容易遗漏的拦截规则- 核对MySQL配置中是否误开启
skip-networking参数:如果存在该配置,MySQL只会响应本地socket连接,所有通过TCP协议发起的应用连接都会被拒绝,找到该配置项注释或删除后重启MySQL即可 - 检查服务器本地防火墙(firewalld/ufw)是否放行对应3306端口的访问来源
- 云服务器场景下,确认云平台的安全组规则没有拦截对应端口的访问请求
- 核对MySQL配置中是否误开启
- 虽然已设置
- 抓取真实连接报错定位根因
- 不要只依赖应用抛出的模糊提示,直接在Web应用所在的服务器上执行连接测试命令,拿到MySQL返回的原始错误
- 执行
mysql -u 应用用户名 -p -h 数据库实际连接地址 -P 对应端口号,输入密码后根据返回结果定向排查:如果返回Access denied类错误,回头核对用户名、密码、授权host的匹配性;如果返回连接超时、无法连接类错误,回头排查端口、防火墙、网络连通性问题
内容的提问来源于stack exchange,提问作者Alpha Aurigae
相关产品推荐
相关产品推荐

