Docker中Composer缓存目录配置及Yii2项目克隆路径问题排查

这种情况我之前处理过，核心原因是Composer在安装依赖时会生成包含绝对路径的自动加载文件，加上Docker卷挂载可能残留了旧项目的缓存或vendor文件，导致启动时还在找旧路径。下面是一步步的解决方法：

1. 彻底清理旧缓存与残留文件 #

首先要把容器内（或本地挂载的）旧vendor目录和Composer缓存清干净：

• 进入运行中的容器（如果容器能启动的话）：

  docker exec -it <你的容器名> /bin/bash
  

• 执行清理命令：

  rm -rf vendor/ && composer clear-cache
  

• 如果容器启动失败，直接在本地删除挂载的vendor目录（如果docker-compose里挂载了的话）：

  rm -rf ./vendor
  

2. 重新生成适配新路径的自动加载文件 #

清理完后，重新生成Composer的自动加载文件，替换掉里面的旧绝对路径：

composer dump-autoload --optimize

这个命令会重新生成vendor/autoload.php及相关文件，所有路径都会指向当前的/home/newproject/目录，Yii2的预脚本也能正常读取新路径了。

3. 检查并修正Docker配置 #

调整Dockerfile的工作目录 #

确保Dockerfile里的WORKDIR设置为新路径，并且Composer install是在这个目录下执行的：

WORKDIR /home/newproject
COPY composer.json composer.lock ./
# 加上--no-cache避免复用旧构建缓存
RUN composer install --no-dev --optimize-autoloader --no-interaction --no-cache

如果之前的Dockerfile里写了旧路径的WORKDIR，一定要改成/home/newproject/。

修正Docker Compose的卷挂载 #

如果你的docker-compose.yml里挂载了vendor目录到本地（比如./vendor:/home/newproject/vendor），建议先暂时注释掉这一行，让容器内部完整执行一次composer install，之后再考虑是否挂载（不建议长期挂载vendor，因为容器和本地的PHP环境可能有差异，容易导致依赖兼容问题）。

4. 检查Yii2的Composer脚本配置 #

打开项目根目录的composer.json，查看scripts部分，比如pre-install-cmd、post-install-cmd这些预/后执行脚本，确认里面有没有硬编码旧路径的内容，如果有，替换成相对路径或者新的绝对路径。比如：

"scripts": {
    "pre-install-cmd": [
        // 确保这里没有/home/oldproject/的硬编码路径
        "php init --env=Production --overwrite=n"
    ]
}

最后验证 #

做完上面的步骤后，重新构建镜像并启动容器：

docker-compose build --no-cache
docker-compose up -d

这样应该就能解决预脚本找不到旧路径的问题了。

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