Laravel 5.4报错SQLSTATE[HY000][2002]：多种方案尝试无果

我明白你已经翻遍了相关讨论但还是卡在这里，这种情况确实让人头疼。先把你提供的配置整理清晰，然后咱们一步步排查可能的问题：

你的配置信息 #

.env 文件配置

APP_NAME=Neuralia
APP_ENV=local
APP_KEY=(key)
APP_DEBUG=true
APP_LOG_LEVEL=debug
APP_URL=http://127.0.0.1:8000
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=neuralia
DB_USERNAME=username
DB_PASSWORD=password

config/database.php 中的 MySQL 配置（补全常规默认项）

'mysql' => [
    'driver' => 'mysql',
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '3306'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'unix_socket' => env('DB_SOCKET', ''),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'strict' => true,
    'engine' => null,
]

排查步骤 #

• 先确保.env配置被正确加载
  本地环境经常会遇到配置缓存的问题，先执行以下命令清除旧缓存：

  php artisan config:clear
  php artisan cache:clear
  

  之后可以在任意路由里添加一行代码测试配置是否生效：

  Route::get('/test-db-config', function () {
      dd([
          'db_host' => env('DB_HOST'),
          'db_name' => env('DB_DATABASE'),
          'db_user' => env('DB_USERNAME')
      ]);
  });
  

  访问http://127.0.0.1:8000/test-db-config，看输出的是否和.env里的一致，如果不一致，说明.env没被正确读取（比如文件位置不对、权限问题）。

• 手动验证数据库连接
  不要依赖Laravel，直接用MySQL客户端测试连接：

  mysql -h 127.0.0.1 -P 3306 -u username -p neuralia
  

  输入密码后如果能成功登录数据库，说明数据库本身的账号密码、地址端口都没问题；如果报错，根据错误提示修复（比如密码错误就改.env里的DB_PASSWORD，权限不足就给MySQL用户授权）。

• 检查database.php是否有硬编码覆盖
  确保database.php里的MySQL配置项都是通过env()函数读取环境变量，没有硬写死的值。比如如果'database' => 'other_db'而不是env('DB_DATABASE', 'forge')，那.env里的设置就会被忽略。

• 查看具体报错信息
  你已经开启了APP_DEBUG=true，可以把页面上显示的完整报错信息贴出来——比如是连接超时、权限拒绝还是数据库不存在？不同的错误指向完全不同的解决方向，这是最关键的信息。

内容的提问来源于stack exchange，提问作者Amaury Leproux