Laravel 8 的项目,本地 .env 指向 127.0.0.1,测试环境 .env.testing 指向 10.0.3.21。上线那天运维执行了 config:cache,结果线上读到的 DB_HOST 是测试库地址,写进去几条脏数据才发现。
查的过程不复杂,顺序要对。先进 tinker 打印 config('database.connections.mysql.host'),是 10.0.3.21;再看 .env,写的是内网正式库;最后发现部署脚本里 cp .env.testing .env 那一步因为文件属主是 root 失败了,脚本没加 set -e,静默跳过。
还有一个坑:代码里有几处直接调 env('DB_HOST'),config:cache 之后全部返回 null。文档写过缓存后 env 只在 config 文件里可用,团队里没人当回事,出事才回头翻。
加载顺序最后定成一条线:容器注入的系统环境变量优先级最高,再往下是 .env.{APP_ENV},最后 .env,后加载的不覆盖已存在的值。这个顺序跟 Dotenv 的默认行为一致,不用自己写合并逻辑,只要保证部署时环境变量真的注入进去。
还有一层容易忽略:PHP-FPM 的 env 缓存。改了 .env 不 reload,fpm 进程里还是旧值,artisan 命令行却是新的,两边对不上。我们后来在部署脚本里固定 clear、cache、reload 三步连着做。
php artisan config:clear
php artisan tinker
>>> config('database.connections.mysql.host')
>>> env('APP_ENV')
流水线里加了两道卡:config:cache 之前 diff 一次 APP_ENV 和 DB_HOST,对不上就中断;发布后跑 healthcheck,连一次库查 version()。上线三周,没再出现环境串台。
