Symfony容器镜像构建时缓存预热目录命名异常问题

问题现象 #

容器化Symfony应用在镜像构建最后一步执行缓存预热，执行cache:clear命令后无报错，但生成两个环境缓存目录：正常命名的prod和带波浪线的pro~，且prod目录缺失部分内容，导致应用启动失败。

原Dockerfile缓存预热步骤 #

ENV COMPOSER_MEMORY_LIMIT=-1

RUN set -eux; \
    mkdir -p var/cache var/log; \
    composer dump-autoload -o --apcu --no-dev; \
    composer dump-env prod; \
    chmod +x bin/console; sync;

RUN set eux; \
    rm -rf var/cache/* && \
    bin/console cache:clear && \
    bin/console assets:install public && \
    bin/console importmap:install && \
    bin/console sass:build -v && \
    bin/console asset-map:compile;

临时解决方式 #

• 手动执行rm -rf var/cache/prod && mv var/cache/pro~ var/cache/prod可恢复应用正常，但不符合镜像构建的预期流程
• 容器启动后执行cache:clear可解决问题，但会导致部署时出现短暂停机

核心疑问 #

1. 为何cache:clear命令未正确完成却无报错？
2. 为何执行两次cache:clear后仅生成正常的prod目录？

两次执行cache:clear的Dockerfile步骤 #

RUN set eux; \
    rm -rf var/cache/* && \
    bin/console cache:clear && \
    bin/console cache:clear && \
    bin/console assets:install public && \
    bin/console importmap:install && \
    bin/console sass:build -v && \
    bin/console asset-map:compile;

执行结果 #

此时缓存目录仅存在正常的prod目录：

docker run -it web-api/env-prod:local ls -la var/cache
total 0
drwxr-xr-x 1 root root   8 Jan  2 12:11 .
drwxr-xr-x 1 root root  72 Jan  2 12:11 ..
drwxr-xr-x 1 root root 170 Jan  2 12:11 prod

问题分析与解答 #

1. cache:clear无报错但未完成的原因 #

Symfony的cache:clear命令执行逻辑分为两步：

• 第一步：创建新的临时缓存目录（如pro~），完成所有缓存文件的生成，这一步成功后命令会返回0（无报错）
• 第二步：尝试将旧的缓存目录（如果存在）替换为新的临时目录。若镜像构建环境中存在文件权限异常、文件系统同步延迟（比如Docker层间的文件操作未及时同步），会导致替换步骤失败，但因为核心的缓存生成步骤已完成，命令不会返回错误码，最终留下两个目录，且原prod目录内容不全。

另外注意原Dockerfile中set eux缺少横杠，正确应为set -eux，缺少-会导致命令执行出错时不自动退出，可能掩盖部分潜在问题。

2. 两次执行cache:clear生效的原因 #

第一次执行cache:clear时，虽然生成了pro~临时目录，但替换prod失败；第二次执行时：

• 命令会先检测到已存在prod目录，将其删除
• 重新创建新的临时缓存目录，再完成替换操作
• 此时第一次执行遗留的临时目录已被清理，或环境中的权限/同步问题已不存在，替换步骤顺利完成，最终仅保留正常的prod目录

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