MySQL 在 Linux 上使用 localhost 连接时，命令行客户端通常走 Unix Socket；改成 127.0.0.1 或显式指定 --protocol=TCP 才是在测试 TCP。先确认连接方式，再区分连接失败与认证拒绝，能避免把 Socket 路径错误误判成端口或密码问题。

适用版本与前提

本文依据 MySQL 8.4 官方手册，面向 Linux 上的 mysql 命令行客户端，不直接套用到 Windows、MySQL Shell 或其他数据库驱动。本文为 AI 辅助的官方资料整理，未在目标环境实测。需要已获授权的数据库账号，以及管理员提供的端口、Socket 路径；示例不修改账号、数据和服务配置。

一、先明确要测试哪一种连接

不要只改变端口而保留 localhost：Unix 下使用 Socket 时，TCP 端口参数可能被忽略。显式指定协议可消除这一歧义。参见 MySQL 官方连接方式说明。

mysql --version
mysql --protocol=SOCKET --socket=/实际路径/mysql.sock --user=app_user --password
mysql --protocol=TCP --host=127.0.0.1 --port=3306 --user=app_user --password

先记录客户端版本；后两条分别测试本地 Socket 与本机回环 TCP。将中文路径、app_user 和 3306 替换为实际值。--password 后不附密码，由客户端交互提示输入。两种连接成功与否分别记录，不要假设它们必然访问同一实例。

二、根据错误所在阶段缩小范围

  • ERROR 2002、Socket 相关错误：核对服务是否运行、Socket 路径与访问权限，不要删除 Socket 文件作为通用修复。
  • ERROR 2003、TCP 连接失败：核对目标地址、实际监听端口及网络路径；回环可达不代表远程可达。
  • Access denied：继续核对账号、连接来源和认证要求；不要直接认定只有密码错误。

服务未运行、客户端选错端口或 Socket，以及服务仅监听回环地址都可能造成连接问题。官方排查入口为 Troubleshooting Problems Connecting to MySQL。上述分类是排查线索，不是仅凭错误编号就能确定的根因。

三、远程连接保留 TLS 校验

远程目标应使用管理员提供、与证书身份一致的域名和可信 CA 文件。以下域名与文件均为占位示例：

mysql --protocol=TCP --host=db.example.com --port=3306 --user=app_user --password --ssl-mode=VERIFY_IDENTITY --ssl-ca=/实际路径/ca.pem

VERIFY_IDENTITY 要求加密连接并验证证书链及主机名；证书或名称不匹配时连接应失败。不要为使测试通过而改成 DISABLED。选项与限制见 MySQL TLS 连接选项。

四、连接成功后验证会话

进入 mysql 提示符后执行：

status

status 官方说明介绍了该命令的连接与服务器状态信息。检查客户端显示的连接方式、服务器版本与 SSL 信息是否符合预期；成功登录仍不证明业务数据库权限和应用功能正常。退出后，再由应用负责人使用真实业务客户端验证。不要把示例输出当成本站的实测结果。

常见疑问与记录建议

localhost 成功、127.0.0.1 失败，是否应该立即开放端口？不应直接据此改配置。先确认服务是否按设计只提供 Socket、本机 TCP 是否启用，以及应用原本需要哪种连接。容器中的 127.0.0.1 指向当前容器自身，也需核对测试位置。

建议记录时间、客户端版本、测试所在主机或容器、协议、目标和完整错误，并在共享记录前遮盖内部信息。一次只改变一个条件，便于比较结果；不以关闭防火墙、跳过认证或重置生产密码作为默认步骤。

相关阅读