config('app_debug') 返回 null 或 false 的根本原因是 app_debug 不参与常规配置加载流程，它仅由 APP_DEBUG 环境变量或常量决定，且不被写入 runtime/config.php 缓存。
config('app_debug') 返回 null 或 false 却实际已开启？
根本原因不是函数失效，而是 config() 读的是运行时合并后的配置，而 app_debug 这个键在框架启动早期就被抽离为常量或环境判断依据，**不参与常规配置加载流程**。你调用 config('app_debug') 时，它查的是 runtime/config.php 里缓存的键值——但该键在生产模式下压根不会被写入缓存文件。
常见错误现象：
- 修改
.env为APP_DEBUG=true，config('app_debug')仍返回false -
config/app.php明确写了'app_debug' => true，但var_dump(config('app_debug'))输出null - 页面报错显示 Trace 面板，但
config('app_debug')就是读不到
真正生效的路径只有两条：
-
define('APP_DEBUG', true)—— 必须写在public/index.php最顶部（任何 require 之前），否则框架启动时已错过时机 -
APP_DEBUG=true写在项目根目录的.env文件中，且确保该文件未被 Web 服务器直接暴露、未被 Git 忽略却实际缺失
为什么 config/app.php 里的 app_debug 设置无效？
ThinkPHP 8 的配置加载顺序是：.env → config/app.php → 运行时合并 → 缓存写入。但 app_debug 是个特例：它只在 APP_DEBUG === true 成立时，才作为上下文开关启用调试链路；一旦 APP_DEBUG 为 false（比如环境变量没设或设成 false），框架就跳过所有调试相关逻辑，config/app.php 里那个 'app_debug' 键根本不会被载入配置容器。
立即学习“PHP免费学习笔记（深入）”；
也就是说：config('app_debug') 不是“读配置”，而是“读缓存结果”；而这个结果只在调试模式激活后才可能被注入。
验证方法：
- 在
public/index.php顶部加var_dump(getenv('APP_DEBUG'), defined('APP_DEBUG') ? APP_DEBUG : null); die;，确认环境变量和常量是否真实生效 - 删掉整个
runtime/目录，再访问一次，看runtime/config.php是否生成——若没生成，说明框架判定当前非调试模式，app_debug不会被缓存 - 检查
APP_ENV是否为dev：TP8 中若APP_ENV=prod，即使APP_DEBUG=true也会被强制忽略
想安全读取调试状态，别用 config('app_debug')
正确做法是直接查环境变量或常量，因为这才是框架实际依赖的判断依据：
// 推荐：优先查环境变量
$debug = filter_var(getenv('APP_DEBUG'), FILTER_VALIDATE_BOOLEAN);
// 次选：查常量（仅当入口文件明确定义了 define('APP_DEBUG', ...)）
$debug = defined('APP_DEBUG') ? APP_DEBUG : $debug;
// 绝对不要依赖这个
$debug = config('app_debug'); // 可能为 null，不可靠
如果你在中间件、事件监听器或命令行任务里需要判断调试状态，getenv('APP_DEBUG') 是唯一稳定途径。框架内部也基本不用 config('app_debug') 做逻辑分支，而是直查 APP_DEBUG 常量或 $_ENV['APP_DEBUG']。
runtime/config.php 里为什么没有 app_debug 键？
因为 php think config:cache 命令在生成缓存时，会主动过滤掉 app_debug、debug、trace 等运行时敏感配置项——它们属于“启动态开关”，不是“可缓存配置”。所以即使你在 config/app.php 里硬写了 'app_debug' => true，只要 APP_DEBUG 环境变量没设为 true，这个键就不会出现在 runtime/config.php 中；而一旦 APP_DEBUG=true，框架又绕过缓存直接走调试流程，根本不会去读那个文件。
这导致一个隐蔽陷阱：你以为改了配置文件就能读到，其实框架早就在启动第一毫秒做了分流。最易被忽略的点，就是忘了检查 public/index.php 顶部有没有 define('APP_DEBUG', true)，以及 .env 是否真的被加载（比如 Docker 容器里漏挂载、CI 环境里没复制）。
