You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Laravel 8 Jetstream+Livewire迁移报错:SQLSTATE[HY000][2002]主机未知

解决Laravel 8 Jetstream+Livewire执行php artisan migrate时的数据库连接错误

嘿,这个问题我碰到过好多次了!你看到的SQLSTATE[HY000] [2002]错误,核心原因是Laravel配置的数据库主机地址无法被系统识别——从错误堆栈里能明确看到,你的代码正尝试连接名为mysql的主机,但你的开发环境是XAMPP本地服务,根本没有这个主机名对应的服务。

一步一步解决问题:

  1. 修改.env文件的数据库配置
    打开项目根目录下的.env文件,找到数据库相关配置项,把DB_HOST的值从mysql改成本地MySQL的地址:

    DB_CONNECTION=mysql
    DB_HOST=localhost  # 也可以填127.0.0.1,两者效果一致
    DB_PORT=3306
    DB_DATABASE=lweb
    DB_USERNAME=root
    DB_PASSWORD=       # XAMPP默认root密码为空,如果你改过密码就填自己设置的内容
    

    注意:要确保DB_DATABASE里的lweb已经在XAMPP的phpMyAdmin中创建好了,不然会触发“数据库不存在”的新错误。

  2. 清除Laravel的配置缓存
    Laravel会缓存环境配置,修改.env后必须清除缓存才能让新配置生效,在终端运行:

    php artisan config:clear
    php artisan cache:clear
    
  3. 确认MySQL服务正在运行
    打开XAMPP控制面板,检查MySQL模块的状态是否为Running,如果没启动就点击Start按钮启动服务。

  4. 重新执行迁移命令
    现在再运行:

    php artisan migrate
    

    应该就能正常执行数据库迁移了。

补充说明:为什么会出现这个问题?

这个错误大多出现在从Docker环境复制配置,或者默认使用了Laravel Sail的配置(Sail默认用mysql作为容器服务名),但你实际用的是XAMPP这类本地原生MySQL服务,两者的主机配置逻辑不同,所以才会出现“找不到主机”的报错。

内容的提问来源于stack exchange,提问作者mdmunirujjaman27

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.11 07:34:33