thinkphp修改.env后配置不生效的核心原因是框架将解析结果缓存到runtime/config.php中，需手动删除该文件并执行php think clear清理缓存，再通过var_dump(env('db_host'))验证是否生效。
修改 .env 文件后配置不生效，核心原因不是“没保存”或“格式错”，而是 ThinkPHP 会把 .env 解析后的结果缓存到 runtime/config.php 等文件中——你改的是源文件，框架读的却是缓存。必须清掉这层中间产物，才能让新配置落地。
确认 .env 文件是否被正确加载
先排除基础问题：
– 确保 .env 在项目根目录（和 composer.json 同级），不是放在 public/ 或 config/ 下；
– 用编辑器另存为 UTF-8 无 BOM 编码，Windows 记事本默认带 BOM，会导致 safeLoad() 静默失败；
– 检查键名写法：必须是扁平格式，如 DB_HOST=127.0.0.1，不能写成 database.hostname=127.0.0.1；
– CLI 命令（如 php think）默认不加载 .env，需手动在 think 文件末尾补加载逻辑。
必须清理 runtime/config.php 和相关缓存目录
.env 的值最终会被合并写入 runtime/config.php，这是最关键的缓存文件。光删 runtime/cache/ 没用。
推荐操作：
- 直接删除
runtime/config.php文件 - 同时清空
runtime/cache/目录（防止旧配置缓存干扰） - 如果用了多级配置（如
config_extra.php），也要检查并清理其对应缓存
执行命令（项目根目录下）：
php think clear —— 这个命令会清 runtime/cache/，但不会动 runtime/config.php，所以得额外手动删它；
更稳妥的做法是：rm -f runtime/config.php && php think clear
验证是否真正生效
别只看页面效果，要动手验证：
– 在控制器里加一行：var_dump(env('DB_HOST'));，刷新页面看输出是否为你刚写的值；
– 如果返回 null，说明 .env 没加载成功，回头检查路径、编码、CLI 加载逻辑；
– 如果返回旧值，说明 runtime/config.php 没删干净，或者有其他配置文件（如 config/database.php）覆盖了它；
– 改完立刻访问接口测试，不要等缓存过期——有些业务配置缓存有效期设为 7 天。
避免反复踩坑的长期习惯
开发阶段建议：
– 保持 APP_DEBUG = true，此时框架跳过大部分缓存，.env 修改基本秒生效；
– 上线前再切回 false，并配合 php think config:cache 生成生产配置缓存；
– 不要在 bootstrap.php 或配置文件里提前调 Env::get()，那时 .env 还没加载，必然返回 null；
– 统一用 env('DB_HOST', '127.0.0.1') 函数读取，它绕过白名单限制，比 Env::get() 更可靠。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
