Laravel10+Breeze+MAMP登录注册时数据库连接被拒绝求助

核心原因 #

命令行（CLI）执行php artisan migrate时使用的PHP环境，和Web服务器处理登录/注册请求时使用的PHP环境不一致，导致两者加载的数据库连接配置不同——CLI用了正确的配置成功迁移，而Web端用了错误的配置触发SQLSTATE[HY000] [2002]错误。

排查与解决步骤 #

1. 对比CLI和Web端的PHP配置 #

• CLI端：在终端执行php --ini，找到加载的php.ini路径，打开后查找mysqli.default_socket的值，通常MAMP的socket路径是/Applications/MAMP/tmp/mysql/mysql.sock。
• Web端：在项目根目录新建phpinfo.php，内容如下：

  <?php phpinfo(); ?>
  

  访问该文件，找到mysqli模块下的default_socket值，和CLI端的结果对比。

2. 统一数据库Socket配置 #

如果两者的socket路径不一致，按以下方式统一：

• 在.env文件中明确指定MAMP的socket路径：

  DB_SOCKET=/Applications/MAMP/tmp/mysql/mysql.sock
  

• 确保config/database.php中的MySQL连接配置引用了这个变量：

  'mysql' => [
      // 其他配置...
      'socket' => env('DB_SOCKET', ''),
  ],
  

3. 清除配置缓存 #

CLI执行迁移后可能生成了配置缓存，但Web端未加载最新配置，执行以下命令清除缓存：

php artisan config:clear
php artisan cache:clear

注意：开发环境避免使用php artisan config:cache，否则会强制缓存配置，修改.env后需重新清除缓存。

4. 统一CLI和Web端的PHP版本 #

如果MAMP安装了多个PHP版本，CLI可能默认使用系统PHP而非MAMP的PHP，导致配置不兼容：

• 在终端切换到MAMP的PHP版本（以PHP 8.2为例）：

  export PATH=/Applications/MAMP/bin/php/php8.2.0/bin:$PATH
  

• 执行php -v确认版本切换成功，再重新清除缓存并测试。

5. 调整DB_HOST配置 #

尝试将.env中的DB_HOST从localhost改为127.0.0.1，避免localhost在不同PHP环境下解析为socket而非TCP连接：

DB_HOST=127.0.0.1
DB_PORT=3306 # MAMP默认MySQL端口，若修改过则填对应值

内容的提问来源于stack exchange，提问作者Robin Thijsen