MacOS下Homebrew安装MySQL8无法被Java程序连接的问题

问题根源 #

MySQL客户端能本地连接但Java程序无法通过3306端口连接，且mysql server status显示port为0、lsof -i :3306无监听进程，说明MySQL未以TCP/IP模式启动，大概率是配置文件未被正确加载或被其他配置覆盖。

分步解决方案 #

1. 确认MySQL实际加载的配置文件 #

执行以下命令查看MySQL读取配置的优先级顺序：

mysql --help | grep "Default options"

输出会显示MySQL加载配置文件的顺序，比如：

Default options are read from the following files in the given order:
/etc/my.cnf /etc/mysql/my.cnf ~/.my.cnf /usr/local/etc/my.cnf

如果/etc/my.cnf或~/.my.cnf存在，里面的配置会优先于你修改的/usr/local/etc/my.cnf，导致port=3306和bind-address=0.0.0.0不生效。

2. 清理冲突的配置文件 #

• 检查/etc/my.cnf、~/.my.cnf是否存在，若存在且包含skip-networking、port=0或未设置port的内容，直接删除这些文件（或注释掉冲突配置）。
• 确保/usr/local/etc/my.cnf中的核心配置正确：

  [mysqld]
  bind-address=0.0.0.0
  port=3306
  # 其他保留配置...
  

3. 手动验证配置文件有效性 #

先停止MySQL服务：

brew services stop mysql

手动指定配置文件启动MySQL：

mysqld --defaults-file=/usr/local/etc/my.cnf

保持终端窗口打开，新开一个终端执行：

mysql -u root -p -e "SHOW GLOBAL VARIABLES LIKE 'port';"

若输出port值为3306，再执行lsof -i :3306确认有mysqld进程监听该端口，说明配置文件有效。

4. 修复Homebrew服务的启动参数 #

如果手动启动有效，但brew services start mysql后port仍为0，说明Homebrew的服务配置未指定你的配置文件：

1. 找到MySQL的plist配置文件（路径对应你的版本）：

   open /usr/local/Cellar/mysql/8.3.0/homebrew.mxcl.mysql.plist
   

2. 在<array>节点的启动参数中添加--defaults-file=/usr/local/etc/my.cnf，修改后类似：

   <array>
     <string>--defaults-file=/usr/local/etc/my.cnf</string>
     <string>--user=_mysql</string>
     <string>--datadir=/usr/local/var/mysql</string>
     <!-- 其他原有参数 -->
   </array>
   

3. 重新加载服务：

   brew services restart mysql
   

5. 验证Java连接与权限 #

• 将Java连接URL改为jdbc:mysql://localhost:3306/zri?serverTimezone=UTC（localhost比0.0.0.0更适配本地TCP/IP连接）。
• 确保MySQL连接用户允许本地访问：
  登录MySQL客户端执行：

  GRANT ALL PRIVILEGES ON zri.* TO '你的用户名'@'localhost' IDENTIFIED BY '你的密码';
  FLUSH PRIVILEGES;
  

  若需要允许其他IP访问，可替换localhost为%。

6. 排查启动日志 #

若以上步骤无效，查看MySQL启动日志排查错误：

tail -f /usr/local/var/mysql/你的主机名.err

日志中会显示配置加载失败、端口被占用等具体错误信息。

内容的提问来源于stack exchange，提问作者Berlin Brown