ThinkPHP在macOS上“MySQL连接被拒绝”的主因是TCP与Unix socket协议错位、MySQL未监听TCP端口、认证插件不兼容（如caching_sha2_password）或pdo_mysql扩展未启用；需依次验证服务状态、强制统一连接方式、修正my.cnf绑定地址、降级认证插件并确认PHP扩展加载。
ThinkPHP在macOS上运行时提示“MySQL连接被拒绝”，不是配置写错了就是环境没对齐——Mac下MySQL默认走Unix socket，而PHP常按TCP方式发起连接，两者错位直接导致Connection refused。
确认MySQL服务真实状态
打开终端，执行：
systemctl status mysql
如果报错“Unit mysql.service not found”，说明你用的是Homebrew安装的MySQL，改用：
brew services list | grep mysql
看到状态是started才代表服务在跑。若显示stopped或error，先执行：
brew services start mysql
立即学习“PHP免费学习笔记（深入）”；
启动后别急着测PHP，立刻验证端口监听情况：
lsof -i :3306
无任何输出？说明mysqld根本没监听TCP端口——这是Mac常见陷阱，【必须手动开启TCP监听】。编辑MySQL配置文件（通常为/opt/homebrew/etc/my.cnf），在[mysqld]段落下添加两行：
bind-address = 127.0.0.1
skip-networking = OFF
保存后重启服务：
brew services restart mysql
绕过localhost解析歧义
ThinkPHP配置里写'hostname' => 'localhost'，在macOS下PHP会尝试走Unix socket路径，但MySQL可能只开了TCP；或者反过来，MySQL监听socket但PHP硬连127.0.0.1。二者不匹配就报Connection refused。
方法一：强制走TCP
把database.php中的hostname从localhost改成127.0.0.1，hostport保持3306不变。
方法二：强制走socket（仅当确认MySQL启用了socket）
先登录MySQL终端执行STATUS，找到UNIX socket一行的路径，例如：
/opt/homebrew/var/mysql/mysql.sock
然后在ThinkPHP的database.php中增加socket配置项：
'params' => [
'unix_socket' => '/opt/homebrew/var/mysql/mysql.sock'
]
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
注意：socket路径必须和STATUS命令输出的完全一致，多一个字符都连不上。
修复MySQL 8.0+认证插件冲突
第一步：用mysql -u root -p登录MySQL命令行
第二步：查当前用户认证方式：
SELECT user, host, plugin FROM mysql.user WHERE user = 'root';
第三步：若plugin列为caching_sha2_password，执行降级命令：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';
第四步：刷新权限表：
FLUSH PRIVILEGES;
这一步做完，PHP底层PDO才能正常握手。旧版ThinkPHP和多数PHP扩展都不支持caching_sha2_password。
检查PHP是否加载了pdo_mysql扩展
在终端运行：
php -m | grep pdo_mysql
没输出？说明扩展没启用。打开php.ini（位置可用php --ini查到），取消这一行的注释：
extension=pdo_mysql
如果是M1 Mac且用Homebrew装的PHP，扩展名可能是pdo_mysql.so，路径可能需手动指定：
extension="/opt/homebrew/lib/php/pecl/20230831/pdo_mysql.so"
改完重启Web服务器：
sudo apachectl restart
或如果你用的是PHP内置服务器，直接Ctrl+C停掉再重起即可。
