Laravel执行php artisan migrate时SQLSTATE[HY000] [2002]错误的解决方法

错误核心 #

执行php artisan migrate时出现的SQLSTATE[HY000] [2002] No such file or directory错误，本质是Laravel无法正常连接MySQL数据库；同时错误日志中出现vehicle_types表的查询，说明迁移过程中存在提前触发数据库查询的情况，或数据库连接本身配置/运行异常。

可能原因及对应解决步骤 #

1. 数据库连接配置错误 #

• 问题点：Mac环境下MySQL连接方式（套接字/TCP）配置不匹配，导致找不到连接文件。
• 解决：
  • 打开项目根目录的.env文件，将DB_HOST的值从localhost改为127.0.0.1（强制使用TCP连接，避免套接字路径问题）。
  • 若坚持使用套接字连接，确认DB_SOCKET路径是否正确：
    • 原生MySQL默认路径：/tmp/mysql.sock
    • MAMP环境路径：/Applications/MAMP/tmp/mysql/mysql.sock
  • 修改配置后执行php artisan config:clear清除配置缓存，确保新配置生效。

2. 迁移过程中提前触发数据库查询 #

• 问题点：项目中的服务提供者、模型启动逻辑（如boot方法）在迁移完成前就执行了vehicle_types表的查询，此时该表尚未被创建，叠加数据库连接异常导致报错。
• 解决：
  • 检查AppServiceProvider或其他自定义服务提供者的boot方法，以及VehicleType模型的boot方法，找出提前执行的查询代码。
  • 给查询逻辑添加判断，避免在迁移命令执行时运行：

    if (!app()->runningInConsole() || !app()->isCommand('migrate')) {
        // 原查询逻辑代码
    }
    

  • 临时注释掉该查询逻辑，完成迁移后再恢复。

3. MySQL服务未启动 #

• 问题点：本地MySQL服务处于停止状态，导致Laravel无法建立连接。
• 解决：
  • 终端执行mysql.server status查看服务状态，若未启动则执行mysql.server start启动。
  • 若使用MAMP/XAMPP等集成环境，打开对应工具启动MySQL服务。

内容的提问来源于stack exchange，提问作者Bite Softsolution