“mysql连接被拒绝”在macos上主因是服务未启动、socket路径错位、认证插件不兼容或端口配置错误；需先执行brew services list | grep mysql确认服务状态，再用mysql -h 127.0.0.1 -p 3306 -u root -p验证tcp连通性，严格分离db_host与db_port，改localhost为127.0.0.1，检查pdo_mysql扩展是否启用，并针对mysql 8.0+执行alter user ... identified with mysql_native_password修复认证冲突。
ThinkPHP在macOS上运行时突然报“MySQL连接被拒绝”，不是代码写错了，而是客户端根本找不到可用的通信路径——可能服务没起、socket路径错位、认证插件不兼容，或配置里混进了非法端口。
确认MySQL服务是否真正在运行
别跳过这步。很多“连接被拒绝”其实是mysqld压根没启动，而不是权限或配置问题。
执行 brew services list | grep mysql，看状态是否为 started。如果显示 stopped 或没输出，说明服务未运行。
运行 brew services start mysql 启动服务；若提示 command not found，请先安装： brew install mysql。
启动后立刻验证：运行 mysql -h 127.0.0.1 -P 3306 -u root -p，能输入密码并进入 MySQL 命令行，才说明服务已就绪且监听 TCP 端口。
检查ThinkPHP数据库配置中的致命错误
常见低级但致命的错误是把端口写进 DB_HOST 字段，比如 'DB_HOST' => 'localhost:8080' —— 这会让 PDO 尝试连接 localhost 的 8080 端口，而 MySQL 根本不在那儿监听。
方法一：严格分离地址与端口
确保配置中 DB_HOST 只填地址（【127.0.0.1】），DB_PORT 单独设为 3306。绝对不要在 DB_HOST 后加冒号和数字。
方法二：用 IP 替代 localhost 避免 socket 解析歧义
将 DB_HOST 改为 '127.0.0.1'，而非 'localhost'。macOS 下 localhost 默认走 Unix socket，一旦 socket 路径不对就会静默失败；而 127.0.0.1 强制走 TCP，错误更明确、更易排查。
验证PHP是否加载了pdo_mysql扩展
第一步：运行 php -m | grep pdo_mysql。无任何输出，说明扩展未启用。
第二步：确认你正在编辑的是 Web SAPI 实际加载的 php.ini，不是 CLI 的配置文件。分别执行：
php --ini → 查 CLI 加载路径
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...
php -r "phpinfo();" | grep "Loaded Configuration File" → 查 Apache/Nginx 加载路径
第三步：打开对应 php.ini，在 extension 列表中取消注释或添加：extension=pdo_mysql（macOS Homebrew PHP 通常为 extension="pdo_mysql.so"）。
改完重启 Web 服务：sudo apachectl restart 或 brew services restart nginx。
修复MySQL 8.0+的caching_sha2_password认证冲突
ThinkPHP 6.x 默认用 PDO 连接，而 macOS 上较老版本的 PHP（尤其通过 Homebrew 安装的 8.1/8.2）自带的 pdo_mysql 驱动可能不支持 MySQL 8.0 默认的 caching_sha2_password 插件，导致连接直接被拒，错误日志里往往只显示“Connection refused”却无具体原因。
登录 MySQL（用 mysql -h 127.0.0.1 -u root -p）：
① 执行 SELECT user, host, plugin FROM mysql.user WHERE user = 'root';
② 如果 plugin 列显示 caching_sha2_password，执行：ALTER USER 'root'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY '你的密码';
③ 再执行 FLUSH PRIVILEGES; 生效。
注意：必须指定 @'127.0.0.1'，不能写 @'localhost'，否则修改的是另一个用户记录，对 TCP 连接无效。
定位并校准Unix socket实际路径
当 ThinkPHP 配置中误用 localhost 且 MySQL 没监听 socket，或 socket 文件权限异常时，PDO 会抛出类似 SQLSTATE[HY000] [2002] No such file or directory 的错误。
运行 mysql_config --socket，输出即为 mysqld 实际使用的 socket 路径。Apple Silicon 常见路径是 /opt/homebrew/var/mysql/mysql.sock，Intel 是 /usr/local/var/mysql/mysql.sock。
若该路径下不存在 mysql.sock 文件，说明 mysqld 没按此路径启动。查进程： ps aux | grep mysqld，找带 --socket= 的参数。
若 socket 文件存在但权限不对，执行：sudo chmod 775 /opt/homebrew/var/mysqlsudo chmod 660 /opt/homebrew/var/mysql/mysql.sock
再把当前用户加入 mysql 组：sudo dseditgroup -o edit -a $USER -t user mysql（macOS 专用命令）。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
