ThinkPHP修改配置后不生效的核心原因是“改了但没被读到”，即框架缓存（如runtime/config.php）、OPcache、.env加载失败或PHP多配置文件冲突导致新配置未加载。
ThinkPHP 修改配置文件后不生效，核心原因不是改错了，而是“改了但没被读到”——框架或 PHP 层级的缓存、加载机制屏蔽了新配置。常见于开发调试阶段反复刷新却无变化，尤其在 APP_DEBUG = false 时更明显。
缓存未清干净
ThinkPHP 的缓存是分层的，只删 Runtime/Cache 往往不够：
- Runtime/Cache/：存模板编译、行为钩子、配置合并结果
- Runtime/Temp/：生成 ~runtime.php 等中间 PHP 文件，改了模板却还在跑旧编译逻辑
-
Runtime/Data/：字段缓存（如
_fields/下的表结构缓存），改了数据库字段却不生效就卡在这儿 -
Runtime/Config/（TP6+）或 Runtime/config.php（TP8）：框架配置缓存文件，
config()读的就是它，不是 config/app.php 原文
配置加载被跳过或覆盖
你以为改的是最终生效的配置，其实可能根本没走到那一步：
- APP_DEBUG = false 时，框架会优先加载缓存文件（如 runtime/config.php），完全忽略 config/ 目录下的源文件
- .env 文件位置错误：不在项目根目录、文件名写成 env 或 .env.txt、含 BOM 头、权限不足（非 644）
-
入口文件没加载 .env：TP6/TP8 需要 public/index.php 中显式调用
Env::load()，否则 .env 形同虚设 -
环境变量冲突：.env 中
APP_DEBUG=true被系统级环境变量或 Apache/Nginx 配置覆盖，导致实际运行仍是 debug 模式
PHP 层级干扰（常被忽略）
即使 ThinkPHP 缓存全清，PHP 自身也可能“锁住”旧配置：
立即学习“PHP免费学习笔记（深入）”；
- OPcache 未刷新：TP8 中 runtime/config.php 是 PHP 文件，被 OPcache 缓存后，哪怕文件内容已更新，PHP 还在执行旧字节码
- 多个 php.ini 共存：CLI 和 Web SAPI 使用不同 php.ini；WAMP/XAMPP 常见 Apache 目录下一份、PHP 目录下一份，只改了一个，另一个仍在生效
-
php-fpm.conf 覆盖 php.ini：如
php_value[memory_limit]在 php-fpm.d/ 下设置，优先级高于 php.ini
验证是否真生效
别凭感觉，动手确认：
- 在控制器里加
var_dump(config('app.app_debug'));，看输出是否和 config/app.php 一致 - 访问
phpinfo()，搜Loaded Configuration File，确认改的是正在用的 php.ini - 浏览器打开 Network 面板，刷新页面，看响应头是否有
X-Powered-By: ThinkPHP且响应时间变长（说明没走缓存） - 删掉 runtime/config.php 后，执行
php think config:cache，再检查该文件是否重新生成且内容包含你刚改的配置项
