ThinkPHP 5.1配置不生效主因是缓存未清、.env解析失败或配置优先级覆盖；需检查UTF-8无BOM编码、KEY=VALUE格式、双引号包裹特殊字符、执行php think clear并重启PHP-FPM，再用Config::get()验证实际加载值。
ThinkPHP 5.1 配置不生效，通常不是改了没保存，而是被缓存、覆盖或解析失败“悄悄屏蔽”了。关键要分清是哪一层的配置（环境变量、框架配置、模板配置）没起作用，再针对性清理和验证。
检查 .env 文件是否被正确解析
.env 是最高优先级的配置入口，但极易因格式错误失效：
- 所有含空格、#、@、$ 的值必须用双引号包裹，例如
DATABASE_PASSWORD="pass#123"，单引号无效 - 确保没有 UTF-8 BOM 头——用编辑器（如 VS Code）确认编码为 “UTF-8 without BOM”
- 修改后必须清空 runtime/ 目录全部内容（cache/、log/、temp/），否则旧解析结果仍被加载
确认配置缓存是否已更新
TP5.1 默认开启配置缓存，手动改 config/ 下的 PHP 文件不会立即生效：
- 执行命令清除：进入项目根目录运行
php think clear:config或更通用的php think clear - 若使用 OPcache，还需重启 PHP-FPM（不能只 reload），否则字节码缓存仍会覆盖新配置
- 检查
runtime/cache/下是否有config.php编译文件，存在即说明缓存未清干净
验证配置读取路径与优先级
TP5.1 配置按顺序叠加：.env → config/app.php → config/子目录PHP文件 → 动态赋值。后写覆盖前写：
立即学习“PHP免费学习笔记（深入）”；
- 用
echo Config::get('app.app_name');在控制器中直接输出，确认实际读到的值 - 如果 .env 里写了
APP_DEBUG=true，但页面仍不显示错误，说明 .env 未生效或被 config/app.php 中的'app_debug' => false覆盖 - 注意大小写：.env 中的键名不区分大小写，但值中的字符串内容（如数据库密码）必须原样匹配
排查 OPcache 导致注释丢失（影响依赖注入/路由绑定）
OPcache 若关闭了注释保存，会导致基于 @param、@var 等 PHPDoc 的功能异常，间接让部分配置逻辑失效：
- 检查 php.ini 中是否设置了
opcache.save_comments=1和opcache.load_comments=1 - 确认
opcache.enable=1且扩展已加载（php -m | grep opcache） - 修改后必须重启 PHP-FPM，并同步清空 ThinkPHP 的
runtime/cache/
