在Linux服务器上部署应用或者操作数据库时，经常会遇到数据库连接失败的问题，这类问题可能涉及多个层面的配置，需要按照一定的逻辑逐步排查才能快速定位根源。常见的数据库连接失败原因包括数据库服务未正常运行、网络端口不通、用户权限配置错误、防火墙规则拦截、连接参数填写错误等。
常见连接失败场景及排查步骤
1. 检查数据库服务是否正常运行
首先确认目标数据库的服务是否已经启动，不同数据库的服务检查命令略有差异，以MySQL为例，可以通过以下命令查看服务状态：
# 查看MySQL服务运行状态 systemctl status mysqld # 如果服务未启动，执行启动命令 systemctl start mysqld # 设置开机自启避免后续重启后服务失效 systemctl enable mysqld
如果服务状态显示为active (running)，说明服务正常运行，可以继续排查其他层面的问题。
2. 检查数据库监听端口是否可达
数据库默认会监听特定端口，比如MySQL默认端口是3306，PostgreSQL默认端口是5432，需要确认端口是否正常监听，并且从客户端侧可以访问到该端口。
首先在数据库所在的Linux服务器上检查端口监听情况：
# 查看3306端口监听情况，MySQL默认端口为3306 netstat -tlnp | grep 3306 # 如果使用的是ss命令，也可以执行 ss -tlnp | grep 3306
如果执行命令后没有输出，说明数据库没有监听对应端口，需要检查数据库的配置文件，确认监听地址是否正确。以MySQL为例，配置文件通常是/etc/my.cnf，需要确认bind-address的配置，如果是本地连接可以设置为127.0.0.1，如果需要远程连接可以设置为0.0.0.0，修改后重启服务生效。
确认端口监听正常后，从客户端机器测试端口是否可达，可以使用telnet或者nc命令：
# 测试目标服务器3306端口是否可达，替换为实际的服务器IP telnet 192.168.0.10 3306 # 如果没有telnet，也可以用nc命令 nc -zv 192.168.0.10 3306
如果端口不通，大概率是防火墙规则拦截了对应端口。
3. 检查防火墙规则是否放行端口
Linux系统默认会开启防火墙，可能会拦截数据库的监听端口，需要根据使用的防火墙工具添加放行规则。
如果是firewalld防火墙：
# 查看当前防火墙放行的端口 firewall-cmd --list-ports # 永久放行3306端口，替换为实际数据库端口 firewall-cmd --add-port=3306/tcp --permanent # 重新加载防火墙规则使配置生效 firewall-cmd --reload
如果是iptables防火墙：
# 放行3306端口的入站请求 iptables -A INPUT -p tcp --dport 3306 -j ACCEPT # 保存iptables规则，不同系统保存命令可能有差异 service iptables save
4. 检查数据库用户权限配置
如果是远程连接数据库，需要确认数据库用户是否允许从客户端IP登录，很多用户创建时默认只允许本地登录，会导致远程连接失败。
以MySQL为例，登录数据库后执行以下命令查看用户权限：
-- 查看所有用户的host配置，root为需要检查的用户名，替换为实际用户名 SELECT user, host FROM mysql.user WHERE user = 'root';
如果对应的host是localhost或者127.0.0.1，说明只允许本地登录，需要修改用户权限允许远程登录：
-- 允许用户root从任意IP登录，替换为实际用户名和密码 GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'your_password' WITH GRANT OPTION; -- 刷新权限使配置生效 FLUSH PRIVILEGES;
如果仅允许特定IP段登录，可以把%替换为对应的IP或者IP段，比如'root'@'192.168.0.%'。
5. 检查连接参数是否正确
最后需要确认应用或者客户端填写的连接参数是否正确，包括数据库IP地址、端口、用户名、密码、数据库名称等，避免因为参数填写错误导致连接失败。如果是使用代码连接数据库，可以参考以下示例检查参数配置：
import pymysql
# 连接参数配置，替换为实际的信息
db_config = {
'host': '192.168.0.10', # 数据库服务器IP
'port': 3306, # 数据库端口
'user': 'root', # 数据库用户名
'password': 'your_password', # 数据库密码
'database': 'test_db', # 要连接的数据库名称
'charset': 'utf8mb4'
}
try:
# 尝试建立数据库连接
conn = pymysql.connect(**db_config)
print('数据库连接成功')
conn.close()
except Exception as e:
print(f'数据库连接失败，错误信息：{e}')
常见问题汇总表
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 提示连接拒绝 | 数据库服务未启动 | 启动数据库服务 |
| 提示连接超时 | 端口被防火墙拦截 | 防火墙放行对应端口 |
| 提示用户无权限 | 用户仅允许本地登录 | 修改用户host权限为允许远程登录 |
| 提示访问的数据库不存在 | 连接的数据库名称错误 | 修正连接参数中的数据库名称 |
排查问题时建议按照服务状态、端口监听、防火墙、用户权限、连接参数的顺序逐步检查，大部分连接问题都可以快速定位解决。如果以上步骤都排查后仍然无法连接，可以查看数据库的日志文件，获取更详细的错误信息，进一步定位问题。