Docker卷不同步求助：PHP容器文件上传后浏览器无法显示

从你的描述来看，文件在主机和容器内都能正常看到，但浏览器始终显示旧文件，这几乎可以确定是缓存机制导致的问题，下面分几个方向给你具体的解决步骤：

1. 检查并调整OPcache配置 #

你的Dockerfile里明确安装并启用了OPcache，这是PHP的字节码缓存工具，在开发环境下如果配置不当，会缓存旧的文件内容，即使文件已经更新。

打开你的opcache.ini文件，确保以下配置正确：

opcache.enable=1
opcache.enable_cli=0
opcache.validate_timestamps=1  # 必须开启，让OPcache检查文件时间戳
opcache.revalidate_freq=0       # 开发环境设为0，实时检查文件变化
opcache.max_accelerated_files=10000
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.fast_shutdown=1

修改后需要重启PHP容器生效：

docker-compose restart php

2. 清理PHP的realpath缓存 #

PHP会缓存文件的真实路径，即使文件内容更新，可能还在使用缓存的路径映射。你可以在代码里添加临时调试代码，或者在容器内执行命令清理：

在PHP脚本中添加（仅开发环境使用）：

clearstatcache(true); // 清理文件状态缓存
realpath_cache_clear(); // 清理realpath缓存

或者进入容器执行PHP命令：

docker exec -it container php -r "clearstatcache(true); realpath_cache_clear();"

3. 处理浏览器端缓存 #

浏览器会自动缓存静态资源（比如图片、文档），即使服务器端文件已经更新，浏览器可能还是读取本地缓存。你可以：

• 强制刷新页面：Windows用Ctrl+F5，Mac用Cmd+Shift+R
• 在上传后的文件URL中添加随机参数，比如http://yourdomain.com/uploads/file.pdf?v=<?= time() ?>，避免浏览器缓存旧资源
• 配置Web服务器（比如Nginx）对上传目录的文件添加Cache-Control响应头，禁止缓存：

  location /uploads {
      add_header Cache-Control "no-store, no-cache, must-revalidate, max-age=0";
      add_header Pragma "no-cache";
  }
  

4. 确认文件权限与用户一致性 #

虽然你能看到文件，但还是要确认容器内文件的用户和PHP-FPM运行用户是否一致：
你的docker-compose里设置了user: 1000:1000，但Dockerfile里COPY文件时用了--chown=33（33是www-data用户的ID），这可能导致PHP读取文件时的权限问题？不过你已经能在容器内看到文件，这个概率较低，但可以检查下：

docker exec -it container ls -l /usr/src/app/path/to/uploads

如果所有者是33:33，而PHP运行在1000:1000，可能需要调整卷挂载的权限，或者修改docker-compose的user为33:33。

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