Laravel无视.env配置使用错误MySQL用户（SQLSTATE[HY000] [1698]）

环境配置 #

• Laravel版本：Laravel Framework 11.41.3
• 数据库：MySQL
• 操作系统：Ubuntu 22.04

.env 文件配置 #

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=react_breeze
DB_USERNAME=other_username_than_root
DB_PASSWORD=password

问题现象 #

执行php artisan migrate或php artisan cache:clear命令时，抛出以下错误：

SQLSTATE[HY000] [1698] Access denied for user 'root'@'localhost' (Connection: mysql, SQL: delete from cache)

已尝试以下操作，但问题未解决：

rm -rf bootstrap/cache/config.php

php artisan config:clear
php artisan cache:clear
php artisan config:cache

排查与解决步骤 #

1. 验证.env配置加载情况
   执行php artisan env查看当前生效的环境变量，确认DB_USERNAME是否为配置的指定用户。如果显示root，说明.env未被正确读取，检查是否存在.env.local等环境专属配置文件，这类文件会覆盖主.env的设置。

2. 检查数据库配置文件
   打开config/database.php，确认mysql连接的用户名和密码是否通过env()函数读取环境变量：

'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', ''),
    // 其他配置项...
],

如果这里直接写死了'username' => 'root'，将其改为env('DB_USERNAME', 'forge')即可。

3. 排查系统级环境变量冲突
   执行printenv | grep DB_查看系统中是否存在DB_USERNAME等环境变量，若存在会覆盖.env配置，需删除或修改这些系统变量。

4. 重启PHP-FPM服务
   若使用Nginx或Apache部署项目，修改.env后需重启PHP-FPM使配置生效：

sudo systemctl restart php8.2-fpm  # 根据实际PHP版本调整

5. 修复缓存目录权限
   确保bootstrap/cache目录有正确的读写权限：

sudo chown -R www-data:www-data bootstrap/cache
sudo chmod -R 755 bootstrap/cache

内容的提问来源于stack exchange，提问作者Mensour Fekhar