90%的“can't connect to local mysql server through socket”错误源于客户端与服务器socket路径不一致或服务未成功启动导致socket文件未生成，需先确认mysqld进程真实运行状态、再查实际socket路径并统一客户端配置。
90% 的 Can't connect to local MySQL server through socket 错误，不是数据库坏了，而是客户端和服务器“约错了见面地点”——socket 路径不一致，或文件根本没生成出来。
确认 mysqld 进程是否真在运行
systemctl status 显示 active (running) 不代表 mysqld 进程活着。它可能卡在初始化阶段（比如磁盘满、/var/lib/mysql 权限被改成 root:root、或 innodb_log_file_size 与现有日志不兼容）。
- 执行
ps aux | grep mysqld | grep -v grep：无输出 = 服务根本没起来 - 若有进程但
mysql.sock仍不存在，说明启动失败但 systemd 没报错，此时查journalctl -u mysql -n 50 --no-pager - 常见错误提示如
Can't change dir to '/data/mysql'或Permission denied，直接指向目录权限或路径问题 - 若发现
/var/run/mysqld目录不存在（尤其重装后），手动建并赋权：sudo mkdir -p /var/run/mysqld && sudo chown mysql:mysql /var/run/mysqld
找到服务器实际使用的 socket 路径
不能猜，也不能信默认值。MySQL 启动时按配置写路径，你得去问它本人。
- 如果能用 TCP 连上（如
mysql -h 127.0.0.1 -P 3306 -u root -p），就直接执行：mysql -u root -p -e "SHOW VARIABLES LIKE 'socket';" - 如果连不上，查配置文件：
grep -r "socket=" /etc/mysql/ /etc/my.cnf 2>/dev/null，重点看[mysqld]段下的socket行 - Homebrew 安装的 MySQL 真实路径是：
mysql_config --socket，改my.cnf可能无效 - 快速扫一遍常见位置：
find /var /tmp /usr -name "mysql.sock" 2>/dev/null；找不到 ≠ 不存在，可能服务根本没成功写入
让客户端和服务器用同一个 socket 路径
客户端默认只认 /tmp/mysql.sock，而服务器很可能写了别的位置——这是最常踩的坑。
- 临时验证：用
mysql --socket=/var/run/mysqld/mysqld.sock -u root -p测试；能连说明路径错，不能连再查其他 - 永久解决：在
~/.my.cnf或/etc/my.cnf的[client]段写入socket = /var/run/mysqld/mysqld.sock，且确保[mysqld]段也配了完全相同的路径 - PHP/Python 不读
my.cnf的[client]段：PHP 要么改host为127.0.0.1（强制走 TCP），要么在php.ini中设mysqli.default_socket；Python 必须显式传参，如pymysql.connect(unix_socket='/var/run/mysqld/mysqld.sock', user='root') - Docker 场景下别映射错目录；宿主机和容器内 socket 路径天然不同，优先用
host.docker.internal或容器名走 TCP
区分 Permission denied 和 No such file or directory
错误信息里明确含 Permission denied（错误码 13），不是路径错了，而是目录或 socket 文件的权限/属组不匹配。
- 用
strace mysql -u root -S /path/to/mysql.sock 2>&1 | grep connect看是否返回EACCES -
ls -l /var/run/mysqld/显示目录权限是drwxr-x---、属组是mysql，但当前用户不在mysql组里 → 执行sudo usermod -aG mysql $USER，然后完全退出终端重登 - socket 文件本身权限应为
srw-rw---- 1 mysql mysql；如果不是，重启mysqld（不要手动chmod或touch它） - PHP/Python 连接时绕过权限问题最稳妥的方式是切 TCP：
host='127.0.0.1'，前提是mysqld配了bind-address = 127.0.0.1且没设skip-networking
真正麻烦的从来不是路径本身，而是路径背后隐含的服务状态、权限继承链、以及客户端是否真的读你写的配置——尤其是 PHP 和 Python 这类不自动加载 my.cnf 的环境，最容易在“以为配好了”的地方卡住。
