Docker容器重启后无法识别预构建vendor目录触发Composer自动加载报错

重启容器后vendor目录文件丢失、自动加载报错，核心是docker-compose中的匿名卷挂载机制和宿主机目录覆盖逻辑冲突导致的。
你当前docker-compose配置中的这几行是问题核心：

volumes:
  - /var/www/project/vendor/
  - ./project:/var/www/project
  - ./project/.docker/php/local.ini:/usr/local/etc/php/conf.d/local.ini

具体触发逻辑：

1. 第一行配置是没有绑定宿主机路径的匿名卷，首次启动容器时，Docker会把镜像构建阶段打包好的、通过composer install生成的完整vendor目录，同步写入这个匿名卷，此时容器内可以正常访问vendor下的所有文件。
2. 第二行配置是将宿主机的项目目录，整体挂载覆盖到容器的/var/www/project工作目录下。当容器重启时，匿名卷的挂载顺序没有固定保障，会和宿主机挂载的项目目录产生路径冲突，导致容器内看到的vendor目录和autoload文件记录的实际路径不匹配，最终出现无法打开流：没有该文件或目录的报错。
3. 匿名卷本身不会随容器删除自动清理，长期运行下很容易出现卷内文件索引异常、权限错乱的问题，这也是为什么临时在容器内重新执行composer install可以临时恢复，但重启后问题复现的原因。

根据你的使用场景调整配置即可：

本地开发场景 #

直接移除匿名卷配置，将vendor目录纳入宿主机项目目录的同步范围：

volumes:
  - ./project:/var/www/project
  - ./project/.docker/php/local.ini:/usr/local/etc/php/conf.d/local.ini

修改完成后，先清理之前遗留的所有关联旧卷，避免干扰：
执行 docker-compose down -v 清理旧卷和旧容器，再重新启动服务即可。这种配置下，容器内执行composer生成的vendor文件会直接同步到宿主机项目目录，重启容器不会出现文件丢失问题。

生产部署场景 #

保持Dockerfile中composer install、依赖安装的步骤不变，同样移除匿名卷配置即可。因为你的Dockerfile已经把所有依赖、前端构建产物都打包到了镜像层，启动时不需要额外挂载vendor目录，从根本上避免卷挂载导致的文件覆盖问题。
如果有缓存vendor目录提升构建速度的需求，不要使用匿名卷，替换为稳定性更高的具名卷：

services:
  project:
    volumes:
      - project-vendor:/var/www/project/vendor
      - ./project:/var/www/project
      - ./project/.docker/php/local.ini:/usr/local/etc/php/conf.d/local.ini
# 单独声明具名卷
volumes:
  project-vendor:

具名卷的生命周期独立，不会因为挂载顺序错乱导致路径冲突，重启稳定性远高于匿名卷。

你当前Dockerfile中，切换为www用户后再执行全局安装composer依赖tightenco/tlint的步骤存在权限隐患，建议将该步骤调整到USER www指令之前执行，避免重启后全局依赖权限异常导致的访问报错。

内容的提问来源于stack exchange，提问作者Orange-Man