dmg安装后命令行连不上,主因是path未配置或mysql服务未启动;需将/usr/local/mysql/bin加入~/.zshrc(或~/.bash_profile),执行source生效,并通过系统设置或mysql.server start启动服务。

DMG安装后命令行连不上:PATH没配对或服务没启动
装完DMG包,mysql -u root -p 报 command not found,八成是环境变量漏了。DMG默认装到 /usr/local/mysql,但终端根本不知道这个路径在哪。
执行这三步就能让命令生效:
- 用
sudo vim ~/.zshrc(M1/M2 或 macOS Catalina 及之后)或vim ~/.bash_profile(旧版 bash)打开配置文件 - 在末尾加一行:
export PATH="/usr/local/mysql/bin:$PATH" - 运行
source ~/.zshrc(或对应配置文件),再试mysql -V看是否输出版本号
如果 mysql -V 成功但 mysql -u root -p 连不上,先检查服务状态:sudo /usr/local/mysql/support-files/mysql.server status。常见情况是安装完没手动启动——去「系统设置」→ 底部「MySQL」点「Start MySQL Server」,或者终端里跑 sudo /usr/local/mysql/support-files/mysql.server start。
root密码输错或认证失败:caching_sha2_password插件惹的祸
DMG安装时你设的 root 密码,大概率没法直接用在 Navicat、DBeaver、甚至某些 Python 脚本里,报错通常是:
Access denied for user 'root'@'localhost' 或 Public Key Retrieval is not allowed
这不是密码错了,而是 MySQL 8.4 默认用 caching_sha2_password 插件,而很多客户端不支持或没开公钥获取。解决方法是登录后立刻切回兼容插件:
- 用安装向导里设的密码登录:
mysql -u root -p - 执行:
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的新密码'; - 再跑:
FLUSH PRIVILEGES;
注意:如果你忘了安装时设的密码,DMG方式**不会生成临时密码日志**(和 tar.gz 手动安装不同),只能重装或进偏好设置停服后删数据目录重来。
想从 Docker 或另一台机器连进来:bind-address必须改
DMG安装默认只监听 127.0.0.1,本地终端能连,但 Docker 容器、iOS 模拟器、甚至同一局域网的另一台 Mac 都连不上。要开放远程访问,得改配置文件。
DMG安装的配置文件不在 /etc/my.cnf,而在:/usr/local/mysql/my.cnf(首次不存在就新建)
编辑它,在 [mysqld] 段下加两行:
bind-address = 0.0.0.0 skip-networking = OFF
然后重启服务:sudo /usr/local/mysql/support-files/mysql.server restart
别忘了授权用户访问权限,比如允许 root 从任意 IP 连(仅开发环境):CREATE USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY '你的密码'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'%'; FLUSH PRIVILEGES;
卸载不干净导致重装失败:删掉隐藏的服务注册和数据目录
反复装卸 DMG 包容易出问题,典型现象是:点「Start MySQL Server」没反应、状态一直灰、或者 mysql.server start 报 Another MySQL daemon already running。
这是因为 DMG 安装会注册 launchd 服务(com.oracle.oss.mysql.mysqld)并保留数据目录,单纯删 .pkg 不起作用。
彻底清理步骤:
- 停服务:
sudo /usr/local/mysql/support-files/mysql.server stop - 删 launchd 注册:
sudo launchctl unload -w /Library/LaunchDaemons/com.oracle.oss.mysql.mysqld.plist - 删数据目录:
sudo rm -rf /usr/local/mysql/data - 删主目录:
sudo rm -rf /usr/local/mysql - 删偏好设置项:进「系统设置」→ 底部「MySQL」→ 右键移除
做完这些再重装 DMG,基本不会卡在“服务已存在”这类玄学错误上。最常被忽略的是 launchd plist 文件没卸载,它会让系统以为 MySQL 一直在后台跑着。











