根本原因是OPcache、Web服务器代理层与浏览器三者缓存叠加；需依次验证phpinfo()中OPcache状态、php.ini中opcache.validate_timestamps=1且revalidate_freq=0、opcache_get_status()路径一致性，再检查curl响应头X-Cache、隐身窗口及硬刷新效果，并确认file_get_contents等函数的路径与权限正确。
PHP 8.2 网站文件缓存不更新，表现为修改了 PHP 源码或 JSON/图片等静态资源后，浏览器刷新仍显示旧内容，根本原因不是单一环节出错，而是 OPcache、Web 服务器代理层、浏览器三者叠加作用的结果，必须按层级顺序排查。
确认是否真被 OPcache 缓存
第一步：访问 phpinfo() 页面，在输出中搜索 【Zend OPcache】，若状态为 enabled，说明 OPcache 正在运行；若未找到该模块，则跳过本阶段。
第二步：检查 php.ini 中关键配置项是否生效：opcache.validate_timestamps=1 和 opcache.revalidate_freq=0。若二者任一为 0 或未设置，OPcache 就不会检测文件变更，改完代码也白改。
第三步：执行 opcache_get_status()['scripts']，查看目标脚本的 full_path 字段是否与你实际编辑的路径完全一致——【路径不一致（如用了 symlink 或相对 include）会导致缓存多份，清空时漏掉一份】。
立即学习“PHP免费学习笔记（深入）”；
检查 Web 服务器是否缓存了响应
方法一：用 curl 查看响应头
执行 curl -I https://yoursite.com/test.php，观察返回头中是否含 X-Cache: HIT 或 X-Proxy-Cache: HIT。有则说明 Nginx/Apache 的 fastcgi_cache 或 proxy_cache 已生效，需定位对应 location 块并临时注释掉 fastcgi_cache 或 proxy_cache 指令。
方法二：Apache 用户可直接禁用 cache 模块
运行 a2dismod cache cache_disk 并重启 Apache，比逐条清理规则更快见效。
注意：Nginx Proxy Manager 用户需登录后台，在对应代理主机的「缓存」设置中关闭启用状态，而非只改 PHP 配置。
验证浏览器是否绕过了服务端更新
① 先用隐身窗口访问页面，若内容已更新，说明是浏览器本地缓存干扰；
② 再执行硬刷新：Windows/Linux 按 Ctrl + F5，macOS 按 Cmd + Shift + R；
③ 最后检查前端 fetch 请求是否带缓存参数——比如 fetch('data.json?_t=1727387826') 这类时间戳参数会强制跳过缓存，但若后端 PHP 脚本本身被 OPcache 锁死，前端加参数也无效。
排查文件级缓存读取失败
如果网站依赖 file_get_contents('cache/data.json') 类逻辑，读不到新内容，先别怀疑代码，直接验证路径和权限：
运行 var_dump(realpath(__DIR__ . '/cache/data.json'));，确保输出的是绝对路径且存在；
接着执行 var_dump(is_readable($path) && is_writable(dirname($path)) );，返回 false 就说明 Web 进程用户（如 www-data）无权读取该文件——【CLI 下能 cat 看到 ≠ PHP 脚本能读到，用户身份不同】；
最后检查错误报告是否关闭：临时加 error_reporting(E_ALL); ini_set('display_errors', '1');，再试一次读取，看是否爆出权限或路径警告。
清除所有缓存并验证生效
第一步：调用 opcache_reset() 清除字节码缓存；
第二步：若有 APCu，执行 apcu_clear_cache()；
第三步：删除项目中 runtime/、cache/、tmp/ 目录下全部内容；
第四步：重启 PHP-FPM 服务：sudo systemctl restart php8.2-fpm（Ubuntu 22.04+ 默认服务名含版本号）；
第五步：用 curl -I 再次检查响应头，确认不再出现 X-Powered-By 或 X-Debug，否则说明输出缓冲未清干净。
