Laravel 中 env() 返回 null 或旧值，是因为执行 php artisan config:cache 后，配置被编译进 bootstrap/cache/config.php，env() 仅在 config 文件中有效，其他地方调用将失效；需清除缓存并重启进程。
改了 .env 文件却完全没反应，大概率不是配置写错了，而是 Laravel 根本没读它——或者读了但被缓存/覆盖/忽略掉了。
为什么 env() 返回 null 或旧值
执行 php artisan tinker 后输入 env('APP_NAME') 得到 null，或仍是修改前的值？这说明配置加载流程在某个环节断开了。
-
php artisan config:cache已运行过 → 此时所有config/*.php文件被编译进一个静态数组，env()调用被绕过，只返回缓存里的快照值 - 你正在 Tinker 或队列 worker 里测试 → 它们不自动重载
.env，除非手动清缓存并重启进程 -
.env文件权限为600且 Web 服务器用户（如 www-data）无读取权 → PHP 进程直接跳过加载，不报错也不警告
php artisan serve 修改后不生效
用内置服务器开发时，.env 变更不会热更新——PHP 进程启动时只读一次，之后全靠内存缓存。
- 必须终止当前
php artisan serve进程（Ctrl+C），再重新执行命令 - 某些旧版本（
v7之前）存在 bug：即使重启，仍可能沿用旧环境变量，可加--env=local强制指定 - 如果你用的是 VS Code 的 PHP Server 插件或 Laravel Homestead/Valet，它们不走
artisan serve流程，需单独确认其是否监听.env变更
Docker 部署下 .env 根本没进容器
本地改完上传，Docker 里还是老配置？别急着怀疑代码，先看文件有没有真正进去。
- 检查
docker-compose.yml的volumes是否显式包含.env：- ./.env:/var/www/html/.env（仅挂载单个文件更安全，避免意外覆盖） - 进入容器执行
ls -la /var/www/html/.env，确认文件存在且大小非零 - 运行
php -r "echo getcwd();"看当前工作目录是不是/var/www/html；如果不是，Dotenv类库会找不到.env - SELinux 或 rootless Docker 可能拦截读取 → 临时用
docker run --privileged测试是否权限问题
配置被高优先级文件覆盖
Laravel 本身不支持多 .env 文件叠加，但有些部署脚本、CI/CD 工具或自定义 bootstrap/app.php 逻辑会主动加载其他文件。
- 检查是否有
.env.local、.env.production等同级文件存在，它们可能被某些构建工具（如 Envoy、Forge 部署脚本）优先加载 - 搜索项目中是否调用了
Dotenv\Dotenv::createUnsafeImmutable()并传入了额外路径 - 运行
php artisan env（Laravel 9+）查看当前识别的环境名，再核对APP_ENV是否与预期一致 —— 错误的APP_ENV会导致加载错误的配置分支
最常被忽略的一点：缓存清除后，Nginx/Apache 的 opcache 或 PHP-FPM 的 APCu 缓存可能还存着旧的 config/cache.php 字节码。哪怕你清了 Laravel 缓存，Web 服务器仍可能返回上一轮编译的结果。遇到“明明清了却还是旧值”，别只盯 artisan 命令，顺手 sudo systemctl restart php-fpm 或 sudo nginx -s reload 才算真正落地。
