APP_ENV常量未生效是因为ThinkPHP的Env类优先读取系统环境变量而非PHP常量；配置未按环境加载是因env目录下缺少对应配置文件；Env::get()返回null是因默认白名单限制；CLI与Web环境变量相互隔离。
APP_ENV 常量没生效，think\Env 读出来的还是 production
ThinkPHP 启动时会通过 think\Env 类自动检测并设置环境，但这个过程依赖于 PHP 的 getenv() 或 $_SERVER，而不是你手动 define 的常量。如果你在 index.php 里写了 define('APP_ENV', 'dev');，它会被后续的 think\Env::init() 覆盖——因为框架优先读取系统级环境变量。
实操建议：
- 用系统环境变量方式设置：Linux/macOS 下启动前执行
export APP_ENV=testing；Windows CMD 用set APP_ENV=testing；Docker 则在docker run -e APP_ENV=testing中传入 - 如果必须代码控制（如本地调试），在
index.php中 调用think\Env::init()之前 设置putenv('APP_ENV=dev')，而非define() - 验证是否生效：在任意控制器里打印
Env::get('APP_ENV')，不是APP_ENV常量本身
配置文件没按环境加载，config/app.php 总是被加载
ThinkPHP 的多环境配置机制不是“覆盖”，而是“合并”：基础配置（config/） + 环境配置（config/<code>env/） → 最终配置。但前提是目录结构和命名严格匹配，且 env 目录下必须有对应文件。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
-
config/testing/存在，但config/testing/app.php缺失 → 框架不会报错，而是静默跳过该环境配置 -
APP_ENV=testing，但config/testing/下只有database.php，没有app.php→app.php仍用默认的config/app.php - 用了
.env文件但未启用 dotenv 支持（5.1+ 默认关闭）→.env完全不解析
实操建议：
- 确保
config/{APP_ENV}/下至少有一个同名配置文件（如app.php），哪怕内容为空数组 - 检查
think\App::initConfig()是否被重写或跳过（某些自定义入口会绕过默认流程） - 想用
.env？需手动安装vlucas/phpdotenv并在index.php开头加载，否则框架根本不看它
Env::get() 返回 null，但 getenv('XXX') 能取到
这是 ThinkPHP 5.1+ 的一个隐藏行为：think\Env::get() 默认只读取白名单内的环境变量，比如 APP_ENV、APP_DEBUG、APP_HOST 等几个固定键。你自定义的 DB_PORT 或 REDIS_URL 不在默认白名单里，就会返回 null。
原因在于 think\Env 内部做了键过滤，避免污染配置空间。这不是 bug，是设计选择。
实操建议：
- 直接用原生
getenv('DB_PORT')或$_ENV['DB_PORT']（需开启variables_order包含E） - 若坚持用
Env::get()，需在应用初始化前调用Env::setAllowList(['DB_PORT', 'REDIS_URL']) - 注意：5.0 和 5.1 的白名单逻辑不同，5.0 是全量读取，升级后容易踩这个坑
命令行下 php think 用的是 production，Web 请求却是 testing
CLI 和 Web 是两个独立的 PHP 进程，环境变量互不影响。你在 Apache/Nginx 里设置了 SetEnv APP_ENV testing，对 CLI 完全无效；反过来，在 shell 里 export APP_ENV=testing，也不会影响 Web 服务器进程。
性能与兼容性影响：
- 不要在
public/index.php里根据PHP_SAPI === 'cli'自动切换环境——这会让命令行任务失去环境隔离能力 - Docker 场景下尤其明显：Web 容器和 CLI 容器通常分开部署，必须分别配置
APP_ENV - CI 流水线中运行
php think optimize:config时，若没显式指定环境，会按 CLI 默认值走，导致缓存配置与运行时不一致
实操建议：
- 所有 CLI 命令统一加
--env=testing参数（支持该选项的版本），或提前APP_ENV=testing php think xxx - 在
think命令入口脚本顶部加判断，强制从.env或固定配置读取 CLI 环境（需自行扩展）
环境切换真正难的不是写法，而是变量作用域的边界意识——CLI/Web/Worker/FPM 子进程各自有一套环境变量空间，ThinkPHP 只读它“认为当前进程该读”的那一份。漏掉任何一个入口点的配置，就等于在生产环境里埋了个静默开关。
