核心原因是OPcache字节码缓存未刷新，PHP-FPM重启才能彻底重建进程树并强制OPcache重新加载；需同步确认opcache.enable=1、清空runtime缓存，并用config()和ini_get()验证双层生效。
ThinkPHP 改了配置后必须重启 PHP-FPM 才生效，核心原因在于 **OPcache 字节码缓存未刷新**，而非框架本身“没读新配置”。TP5.1/8.0 默认启用 OPcache，它会把 PHP 配置文件（如 config/app.php）编译成字节码并长期驻留内存。即使你清空了 ThinkPHP 的 runtime/cache/，只要 OPcache 里的旧字节码还在，PHP 解释器就仍执行旧逻辑。
OPcache 锁死了配置的实时更新
PHP-FPM 是常驻进程，加载一次 OPcache 后不会自动感知文件变化。修改 .env 或 config/*.php 后：
- ThinkPHP 缓存可被
php think clear清掉，但只是删了 runtime 下的 PHP 编译文件； - OPcache 仍在内存中运行着旧的配置解析结果；
- 请求进来时，PHP 直接从 OPcache 取字节码执行，跳过文件重读和重新解析。
为什么 reload 不够，必须 restart？
php-fpm reload 仅平滑重启 worker 进程，主进程仍持有原 OPcache 实例；只有 restart（或 stop → start）才会彻底销毁并重建整个 PHP-FPM 进程树，强制 OPcache 重新初始化、重新加载所有 PHP 文件。
- 宝塔面板点「重载配置」≠ 重启 PHP-FPM，它只重载 Nginx/Apache；
- LNMP 环境需执行
lnmp php-fpm restart； - Ubuntu/Debian 常用
sudo systemctl restart php8.1-fpm（版本号按实际调整）。
还有两个关键依赖点不能漏
单靠重启 PHP-FPM 也不一定立即见效，还需同步处理：
立即学习“PHP免费学习笔记（深入）”；
-
确认 OPcache 配置正确：检查
php.ini中opcache.enable=1、opcache.save_comments=1（否则注释丢失会导致路由/模板失效）； -
删干净 runtime 缓存：执行
php think clear:config或手动删除runtime/cache/全部内容，避免框架层缓存与 OPcache 层缓存不一致。
快速验证是否真生效
别只看页面效果，直接在控制器里加一行：
echo config('app.app_name') . ' | ' . ini_get('opcache.enable');
输出值与预期一致，且 opcache.enable 为 1，才说明双缓存都已更新到位。
