Mac Vagrant环境下CakePHP Bake模型/模板报错SQLSTATE[HY000][2002]求助

针对你在Vagrant+Mac环境下遇到的问题，以下是几个针对性的排查和解决方法：

1. 修正数据库主机配置逻辑 #

• 若MySQL安装在虚拟机内部：确保config/app.php里的host设为127.0.0.1，同时检查MySQL配置文件（my.cnf）里的bind-address是否为127.0.0.1或0.0.0.0，修改后重启MySQL服务。
• 若MySQL安装在主机（Mac）：虚拟机内的127.0.0.1指向自身，无法访问主机数据库。需将host改为Vagrant的主机映射IP（通常是10.0.2.2，或查看Vagrantfile里的host-only配置），同时确保主机MySQL允许外部连接（授权用户my_app@'虚拟机IP'访问，或临时用my_app@'%'测试）。

2. 处理MySQL套接字路径问题 #

Mac上MySQL默认套接字路径是/tmp/mysql.sock，但Vagrant虚拟机无法直接访问主机的/tmp目录。如果你的数据库配置用的是套接字连接（host设为localhost或未指定）：

• 若MySQL在虚拟机内：直接在config/app.php里指定虚拟机内的套接字路径（通常是/var/run/mysqld/mysqld.sock）：

  'Datasources' => [
      'default' => [
          'host' => 'localhost',
          'unix_socket' => '/var/run/mysqld/mysqld.sock',
          // 其他配置项...
      ],
  ]
  

• 若MySQL在主机：在虚拟机内创建指向主机套接字的软链接（需先配置Vagrant共享主机/tmp目录到虚拟机）：

  sudo ln -s /vagrant/tmp/mysql.sock /tmp/mysql.sock
  

3. 核实MySQL服务状态与用户权限 #

• 在虚拟机内检查MySQL是否运行：

  sudo systemctl status mysql  # systemd系统适用
  # 或
  sudo service mysql status    # init.d系统适用
  

  未运行则启动服务：sudo systemctl start mysql
• 确认数据库用户权限：登录MySQL执行

  SHOW GRANTS FOR 'my_app'@'你的连接IP';
  

  若无权限，执行授权命令：

  GRANT ALL PRIVILEGES ON my_app.* TO 'my_app'@'你的连接IP' IDENTIFIED BY 'secret';
  FLUSH PRIVILEGES;
  

4. 直接测试数据库连接 #

在虚拟机内用MySQL客户端直接测试，排除CakePHP本身的问题：

mysql -h 127.0.0.1 -u my_app -psecret my_app

如果该命令也报错，说明是数据库连接本身的问题，优先解决这个基础问题。

内容的提问来源于stack exchange，提问作者Nur Arrianna Md Rafiee