Linux服务器连接MySQL超时,如何排查监听端口与网络访问限制?

发布人:A5数据发布时间:2026-11-04 10:12阅读量:86

连接 MySQL 时长时间无响应,通常不是账号或密码问题,而是 TCP 连接没有在规定时间内完成。排查重点应放在四层:客户端是否连到了正确的地址和端口、云平台安全组或网络访问控制是否放行、服务器主机防火墙是否丢弃连接,以及 MySQL 是否监听了可被远程访问的地址。相比之下,Connection refused、Access denied 等错误通常已经说明网络路径至少走到了更后面的阶段。

运维排查时建议从客户端向数据库服务器逐层靠近:先确认实际目标 IP 和路由,再测试端口连通性;随后在服务器上检查 MySQL 进程与监听状态,最后核对安全组、防火墙、NAT 转发和 bind-address。每一步都要根据结果决定下一步,避免一开始就开放公网端口或修改多处配置,导致问题范围扩大。

先区分“连接超时”具体发生在哪一层

同样是“连不上 MySQL”,不同错误对应的排查方向并不相同。可以先记录应用日志中的完整错误码、目标地址、端口和发生时间,不要只保留“数据库连接失败”这一句概括信息。

现象或错误通常说明优先检查位置
长时间等待后提示 timeout、Connection timed out、错误码 110SYN 或返回包被丢弃,TCP 三次握手未完成安全组、网络 ACL、主机防火墙、NAT、路由
Connection refused、错误码 111目标主机可达,但端口没有可接受连接的监听,或被主动拒绝MySQL 服务、监听端口、绑定地址
No route to host、错误码 113路由、网段、网关或网络访问控制存在问题ip route、子网路由、ACL
Access denied for userTCP 连接已建立,问题进入 MySQL 账号、来源主机或权限层用户授权、密码、认证插件
SSL/TLS 握手或协议错误端口已接通,但客户端与服务端协议或加密参数不匹配SSL 配置、驱动版本、连接参数

例如,下面的测试只验证 TCP 端口,不会验证 MySQL 用户密码:

nc -vz -w 3 10.20.3.15 3306

如果返回 succeeded 或 open,说明从当前机器到 10.20.3.15:3306 的 TCP 连接可以建立。此时继续查账号、授权或应用连接池,不宜再反复修改防火墙。

如果返回 timed out,说明连接请求没有得到及时响应,但仍不能立即断定是服务器防火墙。目标地址错误、云安全组未放行、NAT 转发缺失、回程路由异常,都可能表现为超时。

准备排查信息,避免测错目标

正式修改配置前,先确认以下信息:

  • 发起连接的应用服务器 IP、网卡和所属网段;
  • 数据库服务器的实际内网 IP、可能的公网 IP 和端口;
  • 应用配置中使用的主机名、解析结果、端口及连接协议;
  • MySQL 实际服务单元名称,例如 mysql、mysqld 或 mariadb;
  • 云平台中的安全组、网络 ACL、NAT 或端口转发关系;
  • 当前是否有发布窗口、维护窗口和可用的控制台访问方式。

如果数据库主机无法通过 SSH 登录,最好先确认云平台控制台、串行控制台或带外管理方式可用。防火墙和监听地址调整都可能导致远程会话中断,不应只依赖当前 SSH 连接进行高风险修改。

应用主机上先确认域名解析和路由:

getent ahosts db.example.com
ip route get 10.20.3.15

getent ahosts 用于查看系统实际使用的解析结果。如果同时返回 IPv4 和 IPv6,而应用优先使用 IPv6,需要分别确认两条路径是否都可达。ip route get 会显示内核准备通过哪块网卡、哪个网关和哪个源地址访问目标。

如果路由结果指向错误网卡、默认网关,或者目标 IP 并不属于预期的私有网段,应先修正地址和路由,再进行端口排查。此时在错误 IP 上反复检查 MySQL 服务没有意义。

第一步:从客户端测试实际端口

使用 TCP 探测确认路径

在应用服务器上执行端口测试。端口不一定是 3306,必须以应用配置和 MySQL 运行时配置为准:

nc -vz -w 3 10.20.3.15 3306

常见结果可以这样解释:

  • succeeded:网络层端口已经打通,转向 MySQL 认证、SSL、连接池或应用配置;
  • Connection refused:目标 IP 可达,但没有合适的监听,或者服务端主动拒绝;
  • timed out:重点查看安全组、网络 ACL、NAT、主机防火墙和回程路径;
  • Name or service not known:先处理 DNS 或应用配置中的主机名问题;
  • No route to host:检查客户端路由、云网络路由表和目标网段关系。

如果系统没有 nc,可以直接使用 MySQL 客户端测试。该操作会进一步验证协议和认证,但不要把密码写在命令行中:

mysql --protocol=TCP \
  --connect-timeout=5 \
  -h 10.20.3.15 \
  -P 3306 \
  -u app_user \
  -p

出现 Access denied 或证书相关错误,反而说明 TCP 端口已经响应。不要因为登录失败就继续放大安全组或防火墙范围。

检查应用是否使用了错误地址

实际故障中常见一种情况:应用配置使用的是数据库公网地址,但应用服务器与数据库位于同一私有网络;或者配置仍指向旧服务器 IP。可以对照以下内容:

getent hosts db.example.com
grep -RInE 'mysql|jdbc|database|db_host|db_port' /etc/myapp /opt/myapp 2>/dev/null

配置文件路径仅作为示例,实际路径应根据应用部署方式调整。检查时重点确认:

  • 主机名解析结果是否发生变化;
  • 端口是否与数据库实际监听端口一致;
  • 应用是否配置了 IPv6 地址;
  • 是否存在多个环境配置,启动时加载的并不是正在编辑的文件;
  • 是否有容器环境变量覆盖了配置文件中的值。

如果应用运行在容器内,应从容器网络命名空间中测试,而不是只在宿主机上测试。以 Docker 为例:

docker ps
docker exec -it <应用容器名或ID> sh

进入容器后,再执行 getent hosts 和 nc。宿主机能访问数据库,并不代表容器的 DNS、路由或出站策略也正常。

第二步:在数据库服务器确认服务和监听状态

确认 MySQL 服务是否正在运行

先识别实际服务单元,不要直接假设所有发行版都使用同一个名称:

systemctl list-units --type=service --all | grep -Ei 'mysql|mariadb'

然后查看已经确认的服务单元:

sudo systemctl status mysql --no-pager
sudo journalctl -u mysql -n 100 --no-pager

如果系统显示的单元是 mysqld 或 mariadb,应将命令中的 mysql 替换为对应名称。状态为 failed、服务反复重启或日志中出现配置解析错误时,先处理服务本身,不要先修改安全组。

查看最近日志时,重点留意:

  • 端口被其他进程占用;
  • 配置文件无法解析;
  • 数据目录或权限错误;
  • 监听地址不存在;
  • 服务启动后立即退出;
  • 资源不足导致连接线程无法创建。

使用 ss 确认监听端口和绑定地址

sudo ss -lntp | grep -E '(:3306|mysqld|mariadbd)'

可能出现以下几种结果:

LISTEN 0 151 127.0.0.1:3306 0.0.0.0:* users:(("mysqld",pid=1234,fd=21))
LISTEN 0 151 10.20.3.15:3306 0.0.0.0:* users:(("mysqld",pid=1234,fd=21))
LISTEN 0 151 0.0.0.0:3306 0.0.0.0:* users:(("mysqld",pid=1234,fd=21))

它们的含义不同:

  • 127.0.0.1:3306:只接受本机回环连接,远程服务器无法连接;
  • 10.20.3.15:3306:只接受发往该私网地址的连接,通常比监听所有地址更容易控制;
  • 0.0.0.0:3306:监听所有 IPv4 地址,是否安全取决于安全组和主机防火墙;
  • 只有 :::3306:可能只监听 IPv6,IPv4 客户端连接会失败;
  • 没有任何输出:服务未监听 3306,可能使用其他端口、只启用了 Unix Socket,或者服务没有运行。

也可以使用 lsof 查看占用端口的进程:

sudo lsof -nP -iTCP:3306 -sTCP:LISTEN

如果发现监听端口属于其他程序,不能简单地重启 MySQL。先确认是否存在多实例、旧版本 MySQL 或其他数据库进程占用端口。

以 MySQL 运行时值为准

当本机可以通过 Unix Socket 登录时,可以直接查询实际运行参数:

mysql -uroot -p -e "SHOW VARIABLES WHERE Variable_name IN ('port','bind_address','skip_networking','socket');"

查询结果重点关注:

  • port:MySQL 实际 TCP 端口;
  • bind_address:服务绑定的地址;
  • skip_networking:启用后可能关闭 TCP 网络连接;
  • socket:本机 Unix Socket 路径。

本机通过 Socket 可以登录,并不代表远程 TCP 一定可用。例如:

mysql -uroot -p -S /var/lib/mysql/mysql.sock

该命令只证明本机 Socket 工作正常。之后仍应使用 -h 127.0.0.1 测试本机 TCP:

mysql --protocol=TCP --connect-timeout=3 -h 127.0.0.1 -P 3306 -uroot -p

如果 Socket 登录成功但本机 TCP 失败,优先检查 skip_networking、监听端口和绑定地址。

第三步:检查 bind-address 与配置来源

不同发行版和安装方式的配置路径可能不同,常见位置包括 /etc/mysql/、/etc/my.cnf 和 /etc/my.cnf.d/。可以先搜索有效配置项:

sudo grep -RInE '^[[:space:]]*(bind-address|port|skip-networking)' \
  /etc/mysql /etc/my.cnf /etc/my.cnf.d 2>/dev/null

还要留意配置文件中的 !includedir 或 !include,因为主配置文件中的设置可能被后加载的文件覆盖。不要只编辑搜索到的第一处内容。

绑定地址的处理原则

如果数据库只需要被同一台服务器上的应用访问,保持回环地址通常更安全,不应为了测试而改成 0.0.0.0。

如果应用位于同一私有网络的其他服务器,优先绑定数据库服务器的私网 IP,例如:

[mysqld]
bind-address = 10.20.3.15
port = 3306

只有在确实存在多网卡、多私网段或特殊网络需求,并且安全组和主机防火墙已经限制来源时,才考虑监听所有地址。监听地址放宽并不会自动解决路由或安全组问题,反而会扩大暴露面。

配置调整属于有影响的变更,建议按以下顺序进行:

  1. 记录当前监听结果、配置文件路径和服务状态;
  2. 备份准备修改的配置文件;
  3. 使用配置管理工具或编辑器修改单一配置项;
  4. 在维护窗口重启或按该版本支持情况重新加载服务;
  5. 立即执行本机和远程连接验证。

备份示例:

sudo cp --preserve=mode,ownership,timestamps \
  /etc/mysql/mysql.conf.d/mysqld.cnf \
  /etc/mysql/mysql.conf.d/mysqld.cnf.bak.$(date +%F-%H%M%S)

实际路径必须替换为前面核验过的文件。重启服务会中断现有数据库连接,影响范围包括正在运行的应用请求、连接池和事务,因此不能把重启当成无风险操作。

如果变更后服务未能启动,应先查看日志:

sudo journalctl -u mysql -n 100 --no-pager
sudo systemctl status mysql --no-pager

确认是本次配置造成后,用备份文件恢复原配置,再重启已核验的服务单元。不要在无法确认配置来源时连续修改多个文件。

第四步:由外到内检查安全组和主机防火墙

端口监听正常,只代表服务器内核有进程接收连接,不代表外部流量一定能到达。云服务器通常至少存在两层访问控制:

  1. 云平台安全组、网络 ACL 或子网级访问策略;
  2. Linux 主机上的 firewalld、UFW、nftables 或 iptables 规则。

先读取现有规则,不要直接放行

使用服务器当前发行版的工具查看规则:

sudo firewall-cmd --state
sudo firewall-cmd --list-all

如果使用 UFW:

sudo ufw status verbose

如果使用 nftables:

sudo nft list ruleset

旧系统或兼容层可能仍使用 iptables:

sudo iptables -L INPUT -n -v --line-numbers
sudo iptables -t nat -L -n -v --line-numbers

这些命令主要用于观察,不会主动改变规则。查看时要关注:

  • INPUT 链或对应 zone 是否默认丢弃;
  • 是否存在针对数据库端口的允许规则;
  • 来源网段是否包含应用服务器的实际源地址;
  • 规则命中计数是否在测试时增加;
  • 是否存在更靠前的 DROP 或 REJECT 规则;
  • IPv4 和 IPv6 是否使用了不同规则。

云安全组中应核对入方向规则的协议、目标端口和来源。数据库通常只需要允许应用服务器或应用网段访问 TCP 3306,不应直接对所有公网地址开放。特别要注意,应用服务器访问云数据库时,安全组看到的来源地址可能是出口 NAT 后的公网 IP,而不是应用主机的私网 IP。实际来源应以云网络架构和流量路径为准。

用抓包判断数据包到达了哪一层

在数据库服务器上执行短时抓包,同时从应用服务器发起一次测试:

sudo timeout 30 tcpdump -ni any -s 96 -c 30 'tcp port 3306'

如果系统没有 timeout,可以手动启动抓包,测试完成后使用 Ctrl+C 停止。抓包只观察 TCP 标志位和少量报文,不要在生产环境长时间捕获数据库流量。

结果可以按以下方式判断:

第四步:由外到内检查安全组和主机防火墙配图

  • 数据库服务器完全看不到客户端 SYN:优先检查目标地址、路由、安全组、网络 ACL、NAT 或上游防火墙;
  • 能看到 SYN,但没有 SYN-ACK:检查 MySQL 是否监听目标地址、主机防火墙是否丢弃,以及是否存在端口冲突;
  • 能看到 SYN 和 SYN-ACK,但客户端仍超时:重点检查回程路由、NAT 状态、防火墙返回规则和网络 ACL;
  • 三次握手完成,随后出现 MySQL 响应或认证错误:网络端口基本正常,转向账号、SSL、协议和应用连接参数。

抓包是判断“包有没有到服务器”的直接手段,但不能替代对云平台规则的检查。云安全组丢弃的数据包不会出现在目标主机的抓包结果中。

NAT、端口转发与私网地址问题

如果数据库服务器位于私有子网,外部连接必须经过明确的路由或端口转发。常见拓扑包括:

  • 应用服务器和数据库服务器位于同一私有网络,直接访问数据库私网 IP;
  • 应用服务器位于另一网段,通过云路由或专线访问数据库私网 IP;
  • 外部地址经过 DNAT 或云平台端口转发后,转到数据库私网 IP;
  • 客户端访问公网地址,但数据库和客户端实际在同一私网,产生回流或 NAT hairpin 问题。

先查看数据库服务器地址和路由:

ip -br addr
ip route
ip route get 10.20.3.15

如果数据库服务器是 NAT 网关或转发节点,还需确认已有转发配置:

sudo nft list ruleset | grep -nE 'dnat|snat|3306'
sudo iptables -t nat -S | grep -E '3306|DNAT|SNAT'

云平台提供的 NAT 或负载均衡规则不一定会出现在数据库主机上,应同时检查云控制台中的端口映射和后端目标状态。

NAT 场景中要特别关注回程路径。即使请求包到达了数据库服务器,如果数据库返回流量没有经过原来的 NAT 设备,客户端也可能一直等待。只修改入方向规则而不检查返回路径,通常无法解决超时。

如果应用和数据库同属一个私有网络,优先让应用使用数据库私网地址,避免不必要地绕行公网入口。不要为了快速验证而把 TCP 3306 映射到 0.0.0.0/0。需要临时开放时,也应限制到明确的应用出口 IP,并设置变更期限和回滚记录。

按结果选择修复动作

没有监听端口

如果 ss 没有显示目标端口,先确认 MySQL 端口配置和服务状态。服务停止时,查看日志后再启动已核验的服务单元:

sudo systemctl start mysql
sudo systemctl status mysql --no-pager

如果服务启动失败,不要反复执行 start。先处理配置、权限、磁盘空间或端口冲突问题。服务从停止状态启动可能使应用立即恢复连接,也可能暴露原先未发现的数据目录或配置问题,应在确认影响后操作。

只监听 127.0.0.1

这种结果通常可以解释远程连接超时或被拒绝。应根据访问范围把 bind-address 改为数据库私网 IP,而不是直接监听所有地址。修改后重启服务,再检查:

sudo ss -lntp | grep ':3306'

如果监听地址已变为私网 IP,但远程仍超时,下一步检查安全组和主机防火墙,不要继续扩大绑定范围。

监听正常,但抓包看不到 SYN

问题大概率位于数据库主机之外。依次核对:

  • 客户端使用的目标 IP 是否正确;
  • 客户端路由是否指向正确网关;
  • 云安全组入方向是否允许实际来源;
  • 子网 ACL 是否同时允许请求和返回;
  • NAT 或端口转发是否指向正确后端;
  • 客户端出口地址是否因 NAT 发生变化。

此时在数据库主机上修改 MySQL 配置通常不会产生效果。

抓包能看到 SYN,但没有响应

先确认监听地址是否覆盖该目标 IP,再检查主机防火墙。防火墙可能静默丢弃数据包,也可能主动返回拒绝。对照规则命中计数和测试时间,可以判断测试流量是否经过该规则。

端口接通但应用仍报错

如果 nc 成功,或 MySQL 客户端已经收到 Access denied、SSL 错误,就不应继续修改网络策略。此时核对:

  • 用户名和密码;
  • MySQL 用户的来源主机授权;
  • 客户端是否要求 TLS;
  • 驱动与 MySQL 版本的认证插件兼容性;
  • 应用连接池是否缓存了旧地址;
  • 连接超时参数、最大连接数和连接释放逻辑。

网络排查的目标是确认 TCP 通道,不应把账号授权问题误判为监听端口问题。

防火墙放行时的低风险做法

只有在已经确认监听地址和端口正确后,才考虑调整主机防火墙。变更前保存现有规则,并确保有控制台或带外访问。

以 firewalld 为例,下面是只允许单个应用服务器访问 TCP 3306 的示例。198.51.100.24 是文档示例地址,实际使用时应替换为应用的真实来源地址:

sudo firewall-cmd --list-all

sudo firewall-cmd --permanent \
  --add-rich-rule='rule family="ipv4" source address="198.51.100.24/32" port port="3306" protocol="tcp" accept'

sudo firewall-cmd --reload
sudo firewall-cmd --list-all

回滚时删除完全相同的规则:

sudo firewall-cmd --permanent \
  --remove-rich-rule='rule family="ipv4" source address="198.51.100.24/32" port port="3306" protocol="tcp" accept'

sudo firewall-cmd --reload

如果使用 UFW,可以采用同样的来源限制:

sudo ufw allow from 198.51.100.24 to any port 3306 proto tcp
sudo ufw status numbered

回滚时使用:

sudo ufw delete allow from 198.51.100.24 to any port 3306 proto tcp

不要同时用 firewalld、UFW 和手工 nftables 维护同一条规则,除非已经明确它们之间的管理关系。规则变更后必须从应用服务器重新测试,并查看抓包或规则命中计数,确认放行的确是目标流量,而不是误开了其他来源。

修复后的验证顺序

修复不能只看 systemctl restart 是否成功,应按实际业务路径逐层复测。

服务器本机验证

sudo ss -lntp | grep ':3306'

mysql --protocol=TCP \
  --connect-timeout=3 \
  -h 127.0.0.1 \
  -P 3306 \
  -u app_user \
  -p

如果 MySQL 绑定的是私网 IP,再使用该地址测试:

mysql --protocol=TCP \
  --connect-timeout=3 \
  -h 10.20.3.15 \
  -P 3306 \
  -u app_user \
  -p

本机成功只能证明服务和本机路径正常,不能替代应用服务器测试。

应用服务器验证

nc -vz -w 3 10.20.3.15 3306

mysql --protocol=TCP \
  --connect-timeout=5 \
  -h 10.20.3.15 \
  -P 3306 \
  -u app_user \
  -p

测试应使用应用实际解析出的地址、实际端口和实际网络位置。如果应用通过域名连接,还要再次使用域名测试,避免只验证了 IP。

应用侧验证

确认应用连接池能够建立新连接,并观察应用日志中是否仍有:

  • 连接超时;
  • 连接被拒绝;
  • DNS 解析失败;
  • TLS 握手失败;
  • 连接池耗尽;
  • 连接建立成功但认证失败。

如果应用有健康检查接口,应确认健康检查使用的也是同一数据库地址和端口,不要只查看进程存活状态。

持续观察

修复后的短时间成功不代表问题已经彻底消失。可以结合以下信息持续观察一个业务高峰或约定的观察周期:

ss -s
sudo journalctl -u mysql --since "30 min ago" --no-pager

同时关注云安全组命中、主机防火墙日志、应用连接超时次数、数据库连接数和网络丢包情况。若超时只在高峰期出现,还要进一步检查连接数上限、NAT 会话容量、负载均衡后端状态和应用连接池配置,而不能继续简单扩大端口放行范围。

最终应保留一份排查记录:实际目标地址和端口、监听地址、来源 IP、放行规则、NAT 路径、测试时间及回滚方式。这样下一次出现同类故障时,可以直接从已验证的网络层开始复核,并避免再次进行无范围限制的公网开放。

面向数据库与业务后台部署,A5idc数据提供中国香港、美国、日本等地区的物理服务器,配置覆盖不同CPU平台、内存容量与SSD或NVMe存储,并有多种网络线路方案可选。这些资源可用于承载MySQL及其应用服务,支持结合业务访问地区、数据规模和运行负载规划部署环境。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7465.html

相关推荐