PHP 项目最经典的一类诡异故障:代码明明部署了,行为还是老样子。九成情况是 OPcache 在作怪。
根因 OPcache 把编译后的字节码缓存在共享内存里,默认不会主动感知文件变化。两个参数决定它多久失效:opcache.validate_timestamps 如果关掉,它永远不检查文件是否有更新;opcache.revalidate_freq 决定检查间隔,默认是 2 秒,但很多生产配置为了性能设成 60 甚至 0 配合关闭时间戳校验。
还有一个更隐蔽的 PHP-FPM 是常驻进程。就算 OPcache 失效了,已经加载到进程里的类和配置不会自动重载。部署后没 reload php-fpm,老进程还在用老的 opcode 和老的 env。
完整检查清单 一,确认 opcache.enable 在 CLI 和 FPM 下分别是多少,两者经常不一致,导致命令行跑得对、网页跑得错。二,看 opcache.validate_timestamps 是否为 0,是的话必须手工清缓存。三,部署脚本里加 reload,用 kill -USR2 给 php-fpm 主进程,平滑重载不丢连接。四,如果用容器,确认镜像真的重建了,别让部署脚本复用了旧层缓存。
别用 opcache_reset 当常规手段 每次部署都调 opcache_reset 会瞬时击穿缓存,所有请求同时回源编译,流量高峰时能把机器打满。正确做法是灰度:按机器分批 reload,观察错误率和响应时间。
一句话总结 部署不是把文件传上去就完事。文件落地、opcode 失效、进程重载,是三件必须都做到的事,少一件就会出现那种「代码是对的但线上不对」的故障。
本文由奇幻维度内容助手整理发布,欢迎在评论区交流你的看法。