ThinkPHP 8 重构配置流程：.env仅字面量覆盖一级键（如DATABASE_HOSTNAME）、PHP配置只加载config/下预设模块文件、自定义配置须显式注册并清缓存；键名不匹配、未注册或未执行php think clear:config均导致配置失效。
ThinkPHP 8 的配置加载顺序和覆盖规则变了
不是“变没变”，是 TP8 彻底重构了配置解析流程：环境变量（.env）只覆盖一级键，且必须严格匹配 PHP 配置里的键名结构；PHP 配置文件不再自动合并任意文件，只加载 config/ 目录下预设模块名的文件；自定义配置不显式注册就完全不可见。
env() 只能覆盖一级键，database.hostname ≠ DATABASE_HOST
常见错误是写了 DATABASE_HOST=127.0.0.1，但 PHP 配置里写的是 'hostname' => env('DATABASE_HOSTNAME', '127.0.0.1')，结果 Config::get('database.hostname') 始终返回默认值——因为 TP8 的 env() 不做键名推导，只做字面量映射。
-
.env中必须写DATABASE_HOSTNAME=127.0.0.1才能生效 -
config/database.php中必须用env('DATABASE_HOSTNAME')，不能漏掉NAME后缀 - 写成
DATABASE_HOST或database.host都不会被识别 - 修改
.env后必须运行php think clear:config，否则缓存不刷新
自定义配置文件（如 config/custom.php）默认不加载
TP6 可能靠自动扫描或全局 include 加载业务配置，TP8 下这招失效。如果你把支付密钥、API 地址塞进 config/custom.php 却没注册，Config::get('custom.pay_key') 永远返回 null，且无任何警告。
- 新建
config/custom.php，返回纯数组：return ['pay_key' => env('PAY_KEY', '')]; - 在
app/bootstrap.php开头添加：think\facade\Config::load(__DIR__ . '/../config/custom.php', 'custom'); -
PAY_KEY必须全大写、下划线分隔，否则env('PAY_KEY')读不到 - 不执行
Config::load()，框架启动时根本不会碰这个文件
配置缓存机制更敏感，改完不清理 = 白改
TP8 的配置合并发生在容器初始化早期，且缓存粒度更细。你改了 .env、改了 config/database.php、甚至重跑了 composer dump-autoload，只要没清配置缓存，所有改动都不生效。
立即学习“PHP免费学习笔记（深入）”；
- 每次修改配置后，必须执行
php think clear:config - 若用
opcache.enable=1，还需确认opcache.revalidate_freq=0，否则 PHP 文件变更可能被 opcache 缓存住 - CI/CD 流程中容易漏掉这步，导致测试环境和生产环境配置不一致
