最常见原因是APP_ENV未设置导致框架fallback到production环境，仅加载config/app.php和config/prod/下的配置，而config/prod/app.php中未定义debug为true，即使.env中APP_DEBUG=true也无效。
为什么 config('app.debug') 总是 false？
最常见原因是环境配置根本没加载进来，而不是 .env 写错了。ThinkPHP 不靠 .env 文件决定环境，而是靠 APP_ENV 环境变量——它必须在 PHP 启动前就存在。
典型错误链：APP_ENV 没设 → 框架 fallback 到 production → 只加载 config/app.php 和 config/prod/ 下的文件 → 但 config/prod/app.php 里没写 'debug' => true → 即使 .env 有 APP_DEBUG=true，也完全没机会生效。
-
APP_ENV必须由 Web 服务器或 CLI 显式传入：Nginx 用fastcgi_param APP_ENV dev;，Apache 用SetEnv APP_ENV dev - CLI 下验证当前值：运行
php think env，不是var_dump($_ENV['APP_ENV'])（可能被覆盖） - 环境目录名必须全小写且与
APP_ENV值完全一致：dev✅，DEV❌，development❌ -
config/dev/app.php必须真实存在且可读，文件名大小写敏感：App.php或app.PHP都会静默跳过
动态设置 config() 为什么下次请求就失效？
config() 和 Config::set() 是运行时行为，只影响当前请求生命周期。它不修改任何配置文件，也不写入缓存，更不会影响其他并发请求。
这导致两个典型误用：
立即学习“PHP免费学习笔记（深入）”；
- 在中间件或控制器里调用
config('database.hostname', $_SERVER['HTTP_X_REAL_IP'])试图做连接隔离——实际只是临时改了本次请求的配置副本，数据库连接池、查询日志等底层逻辑早已初始化完毕 - 用
config('app.app_debug', true)绕过环境判断调试线上问题——无效，因为异常处理、模板编译、路由解析等关键流程在config()被调用前就已完成 - 真正需要“动态覆盖”的场景（如多租户切换数据库），应使用
Db::connect()显式传参，而非改全局config('database')
.env 的值为什么有时读不到？
.env 文件本身不直接参与 ThinkPHP 配置加载，它只是通过 vlucas/phpdotenv 提前注入 $_ENV 和 getenv()。是否能读到，取决于三个条件是否同时满足：
-
think\Env类必须已加载（通常在入口文件public/index.php中自动触发） -
.env文件路径必须正确：默认在项目根目录，不能放在config/或runtime/下 - CLI 模式下，
getenv()可能被禁用（php.ini中variables_order不含E），此时必须显式调用Env::get('DB_HOST')，不能依赖$_ENV['DB_HOST'] - Web 服务器层设置了同名环境变量（如 Nginx 的
fastcgi_param DB_HOST xxx），会覆盖.env中的值——这是设计行为，不是 bug
config/ 目录结构错位导致配置合并失败
ThinkPHP 的配置合并不是“按文件名拼接”，而是严格按路径层级执行：先载 config/app.php，再载 config/{APP_ENV}/app.php，最后用 .env 同名键覆盖。漏掉任一层，就会断链。
比如线上 config/prod/database.php 缺失，而 config/database.php 里又写了 'hostname' => '127.0.0.1'，结果就是生产库连到了本地——因为 config/prod/ 下无文件，框架不会尝试合并，直接沿用通用配置。
- 每个环境目录（
dev/、prod/、testing/）应包含完整子集：app.php、database.php、cache.php、log.php -
config/app.php只放真正与环境无关的内容：路由定义、中间件注册、命名空间映射 - 敏感值（密码、密钥）绝不能出现在
config/app.php或config/database.php中，必须下沉到环境目录或.env - 执行
php think optimize:config后，若配置仍不对，先删runtime/config.php再重试——缓存会固化错误的合并结果
APP_ENV 和 config/{env}/ 这两环一旦断裂，后面所有配置都成了空中楼阁。 
