tableplus连接本地mysql失败的常见原因包括host填错（必须用127.0.0.1而非localhost）、认证插件不兼容（mysql 8.0+默认caching_sha2_password，tableplus可能不支持）、mysql服务未真正启动（需brew services list确认状态并ps aux | grep mysql验证进程），以及homebrew路径未加载进shell（apple silicon需export path="/opt/homebrew/bin:$path"）。
TablePlus连接本地MySQL失败时，常见原因包括host填错、认证插件不兼容、服务未启动或PATH未生效，必须逐项排查才能恢复连接。
确认MySQL服务已真正运行
打开终端，执行 brew services list，找到 mysql 一行，状态必须是 started；若显示 error 或 none，说明服务根本没跑起来。
运行 mysql.server start 尝试手动启动，再用 ps aux | grep mysql 查看是否有 mysqld 进程在运行。
如果提示 command not found: mysql，说明 Homebrew 的 bin 路径没加载进 shell：Apple Silicon Mac 执行 echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc；Intel Mac 则改用 /usr/local/bin。
TablePlus连接参数必须这样填
打开TablePlus → 左下角“+” → 选择 MySQL → 填写以下四项：
Host：127.0.0.1（不能填 localhost，否则会走 Unix socket，而 Homebrew 安装的 MySQL 默认禁用 socket 连接）
Port：3306（Homebrew 安装后默认端口，不要改）
User：root（初始化时设置的用户名）
Password：输入 mysql_secure_installation 过程中你亲手设的 root 密码
MySQL 9.6.0是面向Linux平台的2026年创新版本，核心架构迎来重大革新。其将外键约束与级联操作从InnoDB引擎层上移至SQL层，确保所有数据变更均被完整记录至Binlog，彻底解决了CDC（变更数据捕获）与主从复制中的数据不一致难题。此外，该版本引入container_aware启动选项以原生适配容器环境，并对审计日志进行了组件化重构，为追求极致数据一致性与云原生体验的开发者提供了全新选择。
Database：留空（首次连接不指定库更稳妥）
认证插件不匹配导致拒绝登录
如果测试连接报错 “Access denied for user 'root'@'localhost'”，大概率是 MySQL 8.0+ 默认使用 caching_sha2_password 插件，而 TablePlus 某些版本不兼容。
方法一：命令行修复认证方式
先用 mysql -u root -p 登录成功 → 执行：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';
方法二：临时启用 socket 连接（仅限调试）
编辑 MySQL 配置文件：brew --prefix 输出路径 + /etc/my.cnf，在 [mysqld] 下添加：socket = /tmp/mysql.sock
然后重启服务：brew services restart mysql，再在 TablePlus 中把 Host 改成 localhost 试试。
注意：方法二仅用于验证是否为插件问题，生产环境请优先用方法一。
快速验证连接是否真的通了
第一步：终端里执行 mysql -h 127.0.0.1 -P 3306 -u root -p，回车后输密码 —— 如果能进 MySQL 提示符，说明网络、端口、认证全都没问题；
第二步：如果上一步失败，但 mysql -u root -p（不带 host 和 port）能进，说明是 socket 路径或 host 解析问题；
第三步：如果两步都失败，返回第一个
