本地开发环境下的异常服务端缓存问题求助

问题概述 #

修改PHP文件（比如添加var_dump、修复代码逻辑）后，无论是手动刷新浏览器还是BrowserSync自动刷新，页面都不会同步更新——旧代码仍在运行，新增的调试内容不生效，甚至已经删除的代码还会继续显示。问题并非持续触发，有时会在30秒左右自动恢复，但已严重拖慢开发流程。

环境信息 #

• Macbook Pro（16英寸，2019款，2.6 GHz 6核Intel Core i7）
• Mac OS Monterey v12.5
• Chrome v104.0.5112.79
• MAMP Pro 6.6 Build 33836（Apache 2.4.46、PHP 7.4.21、MySQL 5.7.34）
• Xdebug
• PhpStorm 2022.2 Build #PS-222.3345.135
• Gulp v4.0.2、BrowserSync v2.26.14（暂不排除影响）
• WordPress开发环境

排查方向与解决方法 #

1. PHP OPcache 缓存（高发原因） #

PHP的OPcache会预编译并缓存PHP脚本，是开发环境中这类问题的常见诱因：

• 临时禁用：找到MAMP对应PHP版本的php.ini文件，修改以下配置后重启Apache：

  opcache.enable=0
  opcache.enable_cli=0
  

• 开发环境优化：如果不想完全禁用，可设置实时校验文件修改时间：

  opcache.revalidate_freq=0
  opcache.validate_timestamps=1
  

  这样PHP会每次请求都检查文件修改时间，自动更新缓存。

2. Apache 缓存设置 #

Apache可能开启了动态内容缓存，检查相关配置：

• 查看项目根目录的.htaccess或Apache全局httpd.conf，如果有类似以下缓存规则，临时注释后测试：

  <FilesMatch "\.(php)$">
      Header set Cache-Control "max-age=3600"
  </FilesMatch>
  

• 在MAMP的Apache设置中，禁用mod_cache模块后重启服务。

3. PhpStorm 文件同步延迟 #

PhpStorm的自动同步可能出现延迟，尤其是应用更新后：

• 手动触发同步：点击菜单栏 File > Synchronize（快捷键Cmd+Alt+Y）
• 调整设置：进入Settings > Appearance & Behavior > System Settings，确保Synchronize files on frame or editor tab activation已勾选；同时取消勾选Use "safe write" (save changes to a temporary file first)，避免文件写入延迟。

4. 浏览器缓存 #

Chrome可能强制缓存了页面内容：

• 强制刷新：使用Cmd+Shift+R（Windows为Ctrl+Shift+R）忽略缓存刷新页面
• 临时禁用缓存：打开Chrome开发者工具（F12），在Network标签下勾选Disable cache，保持DevTools开启时会自动禁用缓存。

5. MAMP Pro 自带缓存 #

MAMP Pro可能开启了额外的性能缓存：

• 进入MAMP的PHP设置面板，关闭"OPcache加速"类选项，重启服务测试
• 直接重启MAMP Pro的所有服务，确保配置生效。

6. Mac OS 文件系统缓存 #

Mac的文件系统缓存可能导致Apache读取旧文件：

• 刷新系统缓存：在终端执行以下命令：

  sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
  

• 验证文件修改时间：用ls -l命令查看修改后的PHP文件时间，确认和实际保存时间一致，排除文件未真正写入磁盘的问题。

临时应急方案 #

如果问题突然出现，可快速尝试：

1. 用Cmd+Shift+R强制刷新浏览器
2. 手动触发PhpStorm文件同步
3. 重启Apache服务
4. 保存文件时添加空行或修改无关字符，强制更新文件时间戳

内容的提问来源于stack exchange，提问作者solepixel