laravel数据库连不上,屏幕上翻来覆去就那几句:SQLSTATE[HY000] [1045] Access denied for user、[2002] Connection refused、[2002] No such file or directory。看着像密码写错了,可我这些年查下来的情况里,密码背的锅真不多,更多是几个配置项互相打架——缓存把 .env 冻住了、DB_HOST 写成了另一个意思、账号建了但权限没给、又或者 default 连接根本指到了别处。别急着重置密码,顺着下面四处摸一遍就好。顺着往下看。

laravel数据库连不上,先看 .env 是不是被缓存冻住了
Laravel 启动的时候会把 .env 里的值读进 config,只要跑过一次 php artisan config:cache,这份结果就落在 bootstrap/cache/config.php 里,之后你再怎么改 .env,程序读的还是旧的那份,人在那儿对着用户名密码较劲半天,其实改的位置压根没生效。
遇到这种,先 php artisan config:clear,把缓存清掉再试一遍,顺手 cache:clear 也跑一下,省得别的东西串味儿嘛。
还有几个地方容易被忽略:.env 是不是真在项目根目录(不是 public 里面,也不是上一层),文件名有没有手滑写成 .env.example,部署脚本里权限设成 600 之后 php-fpm 那个用户读不读得到。都是随手一看的小事,出问题却特别费时间。先清缓存,再动别的。
localhost 和 127.0.0.1,差一个字差一条路
这俩名字看着像双胞胎嘛。浏览器里确实没差,进了 PDO 里,就是两条完全不同的路。DB_HOST 写 localhost,客户端会去找 Unix socket;写 127.0.0.1 才老老实实走 TCP。说白了,要是 PHP 编译时用的 socket 路径和 MySQL 实际监听的路径对不上,两边就像隔着两间隔音房互相喊话,谁都听不见谁。报错呢,还只甩你一句连不上。
在服务器上敲 mysqladmin variables | grep socket,或者登录后跑一句 show variables like ‘socket’,看它吐出来的路径是哪个,再对着 php.ini 里的 pdo_mysql.default_socket 核对。对不上就把 DB_HOST 换成 127.0.0.1,让它走 TCP,多数情况这一步就通了吧。改完记得清缓存。
端口、库名、账号权限,缺一样都白搭
密码对、主机对,还有几样在暗处等着呢。DB_PORT 默认 3306,可有些镜像或者安全加固过的机器会挪到别的端口,容器里跑 MySQL 忘了映射出来更是常见;云上安全组、本机 firewalld 没放行的时候,TCP 连过去就是超时,跟密码一点关系都没有啊。
DB_DATABASE 拼错一个字母会报 1049 Unknown database,错得低级但真常见,复制粘贴多带一个空格也算。
权限这块最容易栽。MySQL 的用户是带着 host 的,’app’@’localhost’ 和 ‘app’@’%’ 是两条不同的记录,你本机用 root 建了个账号,换台机器连过来照样被拒。show grants for ‘app’@’%’; 甩一下,它到底能碰哪个库、有没有 SELECT 权限,一目了然啊。别只盯着密码那一栏。
config/database.php 里那个 default 指到哪去了
‘default’ => env(‘DB_CONNECTION’, ‘mysql’) 这一行,决定了框架默认拿 connections 数组里的哪一项。DB_CONNECTION 被写成 sqlite,或者从别的项目抄 .env 时带过来一个 pgsql,报错就变成 could not find driver,或者连到一个空文件上,越查越糊涂呗。
连接名对不上的时候会报 Database connection [xxx] not configured,这种反倒好办,翻 config/database.php 对一下键名就完了嘛。多环境部署时 .env 还分好几份(.env.production 之类),改错文件是常事,我一般 grep DB_ .env* 扫一遍,谁覆盖谁看得清清楚楚。
MySQL 8 默认的 caching_sha2_password 在老版本 PHP 上也会认证失败,特征很好认:命令行 mysql 能登进去,PHP 连不上。要么升级扩展,要么把那个账号的认证方式调回 mysql_native_password,具体以官方文档和你手上镜像的说明为准,别照着一篇老帖子就动手。登得进去,不代表连得上。
连上过又掉线,往超时和长连接上想
还有一种不是连不上,是连一会儿就断。报 SQLSTATE[HY000] [2006] MySQL server has gone away,或者 1040 Too many connections,一般是 wait_timeout 太短、max_connections 被占满,再或者 Octane、Swoole 这类常驻进程里 PDO 连接早断了没人重连。
常驻进程里我一般加 DB::purge() 或者 DB::reconnect(),队列 worker 那种跑很久的更得留意,不然半夜挂掉,你还以为是数据库抽风。
我一般这么查:三条命令加一眼日志
php -m | grep -i pdo,先确认 pdo_mysql 在不在,扩展没装的话后面全是白忙活啊。
php artisan tinker 里跑一句 DB::connection()->getPdo(); 抛出来的异常比页面上那层包装详细得多,1045 还是 2002 一眼分得清;tail -n 50 storage/logs/laravel.log 看最近那条堆栈,异常类名和行号都在里面。报错会自己开口。
四处都看完还没头绪呢?那就先划条线。同一台机器上,用 mysql 命令行连同一个库:连得上,问题在 PHP 这边;连不上,就是网络或者账号那边。说白了,这一刀切下去,范围小一半,剩下的活儿就好办。端口、白名单、账号授权这些,控制面板和服务商文档里往往写得比你想的清楚。拿不准就按官方页面说明来,别自己瞎猜啊。
【版权声明】:本站内容若无意侵犯到您的权利,请及时与我们联系将尽快删除相关内容!
评论列表(1条)
[…] Laravel数据库连不上?4个配置在作怪 […]