报can't connect to local mysql server through socket错误，95%是客户端未找到socket文件，需按“服务进程→socket路径→权限→配置同步”顺序排查，而非密码或网络问题。
直接说结论：报 Can't connect to local MySQL server through socket 错误，95% 不是密码或网络问题，而是客户端根本没找到服务端监听的 socket 文件——要么路径不对，要么文件没生成，要么权限卡死。先别改配置，按顺序查。
确认 mysqld 进程是否真在运行
systemctl status mysql 显示 active (running) 不代表可靠。进程可能僵死、启动失败后自动退出，或被 OOM killer 杀掉。
- 用
ps aux | grep mysqld | grep -v grep看是否有真实进程存在 - 如果无输出，说明服务根本没跑；常见原因包括：
innodb_log_file_size配置不匹配、/var/lib/mysql目录被 chown 成 root、磁盘满、SELinux 拦截 - Homebrew 用户特别注意：升级后 socket 路径常从
/tmp/mysql.sock变为/opt/homebrew/var/mysql/mysql.sock，但客户端仍默认找旧路径
查清 socket 文件实际路径并让客户端对上
客户端和服务器必须“说同一种 socket 语言”。服务端路径由 [mysqld] 段决定，客户端默认只认编译时设定的路径（如 /tmp/mysql.sock），不自动读取服务端配置。
- 服务端路径优先查：
mysql --help | grep "socket"（看默认值），或启动后执行mysql -u root -p -e "SHOW VARIABLES LIKE 'socket';" - 常见路径差异：
/var/run/mysqld/mysqld.sock（Ubuntu/Debian）、/var/lib/mysql/mysql.sock（RHEL/CentOS）、/opt/homebrew/var/mysql/mysql.sock（macOS Homebrew） - 临时验证：用
mysql -u root -p --socket=/var/run/mysqld/mysqld.sock强制指定 - 永久修复：在
~/.my.cnf或/etc/mysql/my.cnf的[client]段写入socket = /var/run/mysqld/mysqld.sock—— 注意不是[mysqld]段
检查 socket 文件权限与父目录执行权
Unix socket 是特殊文件，权限要求比普通文件更严格：socket 文件本身需对运行用户（通常是 mysql:mysql）可读写，且其**父目录必须有执行（x）权限**——否则客户端无法进入目录完成连接 handshake。
- 用
ls -l /var/run/mysqld/mysqld.sock查看，正常应为srwxrwxrwx 1 mysql mysql（开头s表示 socket 类型） - 检查父目录：
ls -ld /var/run/mysqld，确保有x权限（如drwxr-xr-x），否则chmod 755 /var/run/mysqld - 属主错误常见于 Docker 或非 root 启动：用
sudo chown mysql:mysql /var/run/mysqld和sudo chown mysql:mysql /var/run/mysqld/mysqld.sock - 切勿用
chmod 777，生产环境应最小权限原则
PHP/Python/Docker 场景下 socket 路径不生效的真相
这些环境默认不读 my.cnf 的 [client] 段，只认硬编码或显式传参。localhost 在 PHP/Python 中不等于 127.0.0.1 —— 它会触发 socket 连接逻辑，而非 TCP。
- PHP 中绕过 socket：把 host 改成
127.0.0.1（强制走 TCP），或在php.ini中设mysqli.default_socket = /var/run/mysqld/mysqld.sock - Python 的 pymysql 必须显式传参：
pymysql.connect(unix_socket='/var/run/mysqld/mysqld.sock', user='root')，仅设host='localhost'无效 - Docker 宿主机和容器内路径天然隔离，映射
/var/run/mysqld卷极易出错；推荐容器内用host.docker.internal（Mac/Win）或服务名（Docker Compose 网络）走 TCP，避免 socket 同步问题
最易被忽略的一点：socket 文件本身不会“凭空出现”。它由 mysqld 进程启动时创建，若服务启动失败（比如 error log 里有 InnoDB: The log sequence number...），socket 就根本不会生成——此时查路径和权限全是白忙。务必先看 /var/log/mysql/error.log 或 Homebrew 的 /opt/homebrew/var/mysql/*.err，再动手。
