在香港VPS服务器上，MySQL 数据库连接失败是常见的问题，可能导致网站或应用程序无法正常运行。排查和修复此问题需要从多方面入手，包括网络配置、MySQL 服务状态、权限设置等。

一、MySQL 数据库连接失败的常见原因

1. 数据库服务未启动

   • MySQL 服务未运行或已停止。

2. 用户权限问题

   • 数据库用户没有正确的访问权限或密码错误。

3. 网络问题

   • 防火墙、网络端口未开放，导致无法连接。

4. 绑定地址错误

   • MySQL 配置文件中绑定的 IP 地址限制了连接来源。

5. 超过最大连接数

   • MySQL 达到最大连接数限制，无法接受新的连接。

6. MySQL 配置文件错误

   • 配置文件（my.cnf 或 my.ini）中存在错误配置。

7. 数据库损坏或崩溃

   • 数据库文件损坏或 MySQL 服务崩溃。

二、香港VPS排查和修复方法

1. 检查 MySQL 服务状态

首先确认 MySQL 服务是否正在运行。

(1) 检查服务状态

运行以下命令：

sudo systemctl status mysqld

输出示例：

● mysqld.service - MySQL Server
   Loaded: loaded (/usr/lib/systemd/system/mysqld.service; enabled)
   Active: active (running) since Mon 2024-12-30 10:00:00 UTC; 5min ago

• 如果状态是 inactive 或 failed，重新启动服务：
  bash

  复制

  sudo systemctl start mysqld
  

(2) 检查服务是否自动启动

确保 MySQL 服务已设置为开机启动：

sudo systemctl enable mysqld

2. 验证 MySQL 的端口监听

MySQL 默认监听端口是 3306，确认端口是否开放。

(1) 查看端口监听状态

运行以下命令检查 MySQL 是否在监听：

sudo netstat -tuln | grep 3306

输出示例：

tcp        0      0 127.0.0.1:3306          0.0.0.0:*               LISTEN

• 如果没有输出，说明 MySQL 未正确监听端口，检查 MySQL 配置文件（详见步骤 4）。

(2) 检查防火墙规则

确保防火墙允许 MySQL 的默认端口 3306：

sudo firewall-cmd --list-all

如果未开放，添加规则：

sudo firewall-cmd --zone=public --add-port=3306/tcp --permanent
sudo firewall-cmd --reload

(3) 检查是否被安全组限制（云服务器）

如果使用的是香港云服务器，检查云服务商的安全组规则，确保 3306 端口已开放。

3. 检查 MySQL 用户权限

(1) 登录 MySQL

使用 root 用户登录 MySQL：

mysql -u root -p

(2) 查看用户权限

检查用户是否有远程访问权限：

SELECT host, user FROM mysql.user;

输出示例：

+-----------+------+
| host      | user |
+-----------+------+
| localhost | root |
| %         | test |
+-----------+------+

• localhost 表示仅允许本地访问。
• % 表示允许所有远程访问。

(3) 添加或修改用户权限

• 如果用户需要远程访问，确保用户的 host 是 %：
  sql

  复制

  GRANT ALL PRIVILEGES ON *.* TO 'username'@'%' IDENTIFIED BY 'password';
  FLUSH PRIVILEGES;
  

• 如果需要限制到特定 IP（如 192.168.1.100）：
  sql

  复制

  GRANT ALL PRIVILEGES ON *.* TO 'username'@'192.168.1.100' IDENTIFIED BY 'password';
  FLUSH PRIVILEGES;
  

(4) 检查用户密码是否正确

尝试用客户端连接 MySQL：

mysql -u username -p -h <server_ip>

确保密码正确。如果密码错误，可以重置密码：

ALTER USER 'username'@'%' IDENTIFIED BY 'newpassword';
FLUSH PRIVILEGES;

4. 检查 MySQL 配置文件

(1) 检查绑定地址

编辑 MySQL 的配置文件（通常位于 /etc/my.cnf 或 /etc/mysql/my.cnf）：

sudo nano /etc/my.cnf

找到以下配置项：

bind-address = 127.0.0.1

• 如果是 127.0.0.1，表示只允许本地访问。
• 修改为：
  ini

  复制

  bind-address = 0.0.0.0
  

  表示允许任何 IP 地址访问。

重启 MySQL 服务以应用配置：

sudo systemctl restart mysqld

(2) 检查最大连接数

如果 MySQL 达到最大连接数，可能会拒绝新的连接。

• 查看当前最大连接数：
  sql

  复制

  SHOW VARIABLES LIKE 'max_connections';
  

• 修改最大连接数（临时）：
  sql

  复制

  SET GLOBAL max_connections = 200;
  

• 永久修改：
  编辑 /etc/my.cnf 文件，添加或修改：
  ini

  复制

  [mysqld]
  max_connections = 200
  

  然后重启 MySQL 服务。

5. 测试网络连通性

如果 MySQL 配置正确，但仍无法连接，检查网络连通性。

(1) Ping 测试

测试客户端与服务器之间的网络连通性：

ping <server_ip>

(2) Telnet 测试

测试 MySQL 端口是否可以访问：

telnet <server_ip> 3306

• 如果无法连接，可能是防火墙或安全组未正确配置，需检查相关配置。

6. 检查 MySQL 错误日志

MySQL 错误日志可以提供更详细的信息，帮助排查问题。

(1) 查看错误日志路径

运行以下命令查看 MySQL 配置中的日志路径：

SHOW VARIABLES LIKE 'log_error';

输出示例：

+---------------+------------------------+
| Variable_name | Value                  |
+---------------+------------------------+
| log_error     | /var/log/mysqld.log    |
+---------------+------------------------+

(2) 查看日志内容

使用 tail 查看日志的最新内容：

sudo tail -f /var/log/mysqld.log

• 查找与连接失败相关的错误信息。

7. 数据库文件损坏检查

如果VPS服务器日志中显示数据库表或文件损坏，可以尝试修复：

(1) 检查表状态

登录 MySQL 后运行：

CHECK TABLE <table_name>;

(2) 修复损坏的表

REPAIR TABLE <table_name>;

(3) 检测 InnoDB 文件

如果使用 InnoDB 存储引擎，可能需要重建事务日志：

1. 停止 MySQL 服务：
   bash

   复制

   sudo systemctl stop mysqld
   

2. 删除事务日志文件（ib_logfile0 和 ib_logfile1）：
   bash

   复制

   sudo rm /var/lib/mysql/ib_logfile*
   

3. 重启 MySQL 服务：
   bash

   复制

   sudo systemctl start mysqld
   

三、总结

当 MySQL 数据库连接失败时，可以按照以下步骤进行排查和修复：

1. 检查服务状态：确保 MySQL 服务正在运行。
2. 检查网络端口：确认 3306 端口是否开放，防火墙和安全组是否配置正确。
3. 检查用户权限：确保用户有正确的访问权限。
4. 验证配置文件：检查 bind-address 和 max_connections 等配置是否正确。
5. 查看错误日志：检查 MySQL 错误日志获取详细信息。
6. 测试网络连通性：使用 ping 和 telnet 确保网络正常。