修改 .env 文件是最直接的数据库配置方式，需正确设置 DB_CONNECTION、DB_HOST 等参数，并执行 php artisan config:clear 清除缓存，否则配置不生效；切勿硬编码 config/database.php。
修改 .env 文件是最直接的数据库配置方式
Laravel 启动时默认从 .env 文件读取数据库连接参数，而不是直接改 config/database.php。改配置前先确认项目根目录下存在 .env 文件（若没有，复制 .env.example 并重命名）。
关键配置项如下：
-
DB_CONNECTION=mysql—— 必须为mysql，否则即使装了 MySQL 也会报Driver [mysql] not supported -
DB_HOST=127.0.0.1—— 不建议用localhost，PHP 的 MySQL 扩展会尝试走 socket 连接，容易因权限或路径失败 -
DB_PORT=3306—— 如果 MySQL 装在 Docker 或非标端口，必须显式写对 -
DB_DATABASE=your_db_name—— 数据库需已手动创建，Laravel 不会自动建库 -
DB_USERNAME=root和DB_PASSWORD=—— 密码含特殊字符（如@、/）时，整个值要用双引号包裹，例如DB_PASSWORD="p@ss/w0rd"
php artisan config:clear 是验证修改是否生效的关键步骤
改完 .env 后不能直接刷新网页看效果——Laravel 会缓存配置。不清理缓存，哪怕 .env 写错了也还是旧连接。
执行以下命令：
php artisan config:clear
如果使用了配置缓存（比如线上环境跑过 php artisan config:cache），还需补一句：
php artisan config:cache
常见误操作：
- 只改了
.env就去访问页面，报SQLSTATE[HY000] [1045] Access denied却以为是账号错，其实是缓存没清 - 在 Homestead/Valet 等环境里改了宿主机的
.env，但实际运行的是虚拟机里的代码，该改的是 VM 里的文件 - 用 IDE 自带终端执行命令，但当前工作目录不是项目根目录，导致命令无效
连接失败时优先检查 MySQL 服务状态和用户权限
Laravel 报 Connection refused 或 Access denied，大概率不是 Laravel 配置问题，而是底层连不上。
快速排查顺序：
- 终端执行
mysql -h 127.0.0.1 -P 3306 -u root -p，能登录说明服务正常、账号可用；连不上则先查 MySQL 是否运行、防火墙是否放行端口 - 确认用户有对应数据库的权限：
GRANT ALL ON your_db_name.* TO 'root'@'%'; FLUSH PRIVILEGES;（本地开发用'root'@'127.0.0.1'更安全） - Docker 环境注意网络模式：如果 Laravel 容器和 MySQL 容器不在同一 network，
DB_HOST不能填127.0.0.1，得填 MySQL 容器名（如mysql） - Mac M1 用户若用 Homebrew 装 MySQL，
mysqld默认绑定::1（IPv6），而 PHP MySQL 扩展可能只走 IPv4，此时DB_HOST改成127.0.0.1比localhost更可靠
config/database.php 里不要硬编码数据库参数
这个文件只是配置的“模板”，所有真实值应来自 .env。比如 MySQL 相关部分长这样：
'mysql' => [
'driver' => 'mysql',
'url' => env('DATABASE_URL'),
'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', ''),
// ...
],如果你把 'host' => '192.168.1.100' 这样写死在这里，.env 的 DB_HOST 就完全失效了。多人协作或部署到不同环境时，这种写法会导致配置无法隔离。
唯一合理修改 config/database.php 的场景是：需要动态切换连接（比如按租户路由到不同库）、或启用 PDO 层级选项（如 'options' => [PDO::ATTR_EMULATE_PREPARES => false]）。
真正容易被忽略的是：有些团队把 .env 提交到 Git，导致测试库密码泄露；或者在 CI/CD 中忘了注入 .env 变量，结果跑测试时连的是本地空库。
