ThinkPHP 6+ 环境变量加载失败主因是 .env 文件未被正确加载，需同时满足：APP_DEBUG=true、文件位于项目根目录且严格命名为.env、无BOM和注释、键名全大写，并在Docker中通过env_file显式注入。
环境变量注入失败，核心是 .env 文件未被正确加载，不是“写错了”或“没放对”，而是加载时机、路径、格式、开关四者没对齐。ThinkPHP 6+ 的环境变量只在 APP_DEBUG = true 时才强制加载，且只认项目根目录下严格名为 .env（小写、点开头、无后缀）的文件。
确认 .env 文件位置和命名是否合规
必须放在项目根目录（与 think 命令同级），不能在 app/、config/ 或 public/ 下。文件名必须是 .env，不是 .env.production、env.php 或 ENV。Linux 下大小写敏感，Windows 也建议统一用小写避免容器内挂载错乱。
- 执行
ls -la确认根目录下有.env，且无 BOM 头（可用file .env查看编码） - 文件内禁止以
#开头的注释行，ThinkPHP 不解析注释，遇到就中断加载 - 键名必须全大写加下划线，如
APP_DEBUG=false，不能写成app_debug=false
检查 APP_DEBUG 是否为 true（加载前提）
ThinkPHP 6+ 默认只在调试模式开启时读取 .env。生产环境设为 false 后，.env 将被跳过——这不是 bug，是设计行为。临时排查请确保入口文件 public/index.php 中 define('APP_DEBUG', true) 已启用。
- 在控制器中加一行：
dump(env('APP_DEBUG'));，输出null就说明.env没加载 - 若需生产环境也加载，应改用 Docker 的
env_file或environment字段直接注入系统级环境变量，而非依赖框架层
验证环境变量是否真正生效
即使 .env 存在且 APP_DEBUG=true，仍可能因路径解析失败或配置覆盖而无效。最直接验证方式是绕过框架，用 PHP 原生函数读取：
立即学习“PHP免费学习笔记（深入）”；
- 在
public/index.php最顶部加：var_dump($_ENV); exit;，看是否包含你定义的变量 - 若为空，说明 Web 服务器（如 Nginx + PHP-FPM）未将环境变量透传进来；需在
php-fpm.conf或 Docker 的php.ini中显式设置：variables_order = "EGPCS"和register_argc_argv = On - 容器部署时，确保
.env是通过 volume 挂载进容器的，且挂载路径与应用运行路径一致（如/var/www/html/.env）
Docker 场景下必须用 env_file 注入根目录
容器里不能依赖框架自动读 .env，因为启动顺序和用户权限可能导致竞态。正确做法是在 docker-compose.yml 中用 env_file 显式声明：
-
env_file: [".env"]—— 注意路径是 Compose 文件所在目录下的.env，不是容器内路径 - 同时在
Dockerfile中确保工作目录为项目根目录：WORKDIR /var/www/html - 避免在容器内执行
php think命令时使用--env-file，该参数仅对命令行有效，不影响 Web 请求
