Docker Compose容器构建时挂载文件脚本执行异常排查

Docker镜像构建阶段完全无法访问容器启动时才挂载的卷——卷挂载是容器启动流程的环节，构建阶段只能读取通过COPY/ADD指令放入镜像的文件。你在RUN write_config.sh时，${WWWPATH}还只是镜像里的空目录，自然找不到本地./src里的globals.template.inc.php。

以下是三种落地性强的处理方式，按需选择：

方案1：构建阶段预处理模板，启动阶段同步到挂载目录 #

适合需要在镜像里预存默认配置，同时允许本地挂载目录覆盖的场景：

1. 修改Dockerfile，提前把模板文件复制到镜像临时目录：

   # 把本地src里的模板文件复制到镜像临时目录
   COPY ./src/globals.template.inc.php /tmp/config_templates/
   # 复制配置脚本
   COPY write_config.sh /usr/local/bin/
   RUN chmod +x /usr/local/bin/write_config.sh
   # 构建阶段先在临时目录生成配置
   RUN write_config.sh
   

2. 调整write_config.sh，让它把生成的配置输出到/tmp/config_templates/，而非直接操作${WWWPATH}
3. 新增一个启动脚本entrypoint.sh，容器启动时把预生成的配置同步到挂载目录：

   #!/bin/bash
   # 同步预生成的配置到挂载目录
   cp /tmp/config_templates/globals.inc.php ${WWWPATH}/
   # 启动PHP服务（比如php-fpm）
   exec php-fpm
   

4. Dockerfile末尾指定entrypoint：

   COPY entrypoint.sh /usr/local/bin/
   RUN chmod +x /usr/local/bin/entrypoint.sh
   ENTRYPOINT ["entrypoint.sh"]
   

方案2：把配置生成逻辑移到容器启动阶段 #

最直接的解决方式，适合开发环境或依赖外部挂载文件的场景：

1. 从Dockerfile中移除RUN write_config.sh指令
2. 把配置脚本复制到镜像，并添加到启动流程：

   COPY write_config.sh /usr/local/bin/
   COPY entrypoint.sh /usr/local/bin/
   RUN chmod +x /usr/local/bin/write_config.sh /usr/local/bin/entrypoint.sh
   ENTRYPOINT ["entrypoint.sh"]
   CMD ["php-fpm"]
   

3. 编写entrypoint.sh，确保先执行配置生成，再启动服务：

   #!/bin/bash
   # 此时卷已经挂载，${WWWPATH}里的模板文件可访问
   write_config.sh
   # 执行容器启动命令（比如php-fpm）
   exec "$@"
   

方案3：构建阶段先复制整个src目录，启动阶段用卷覆盖 #

适合需要在构建阶段完成所有配置生成，同时允许本地开发时替换文件的场景：

1. 修改Dockerfile，先把本地./src复制到镜像的${WWWPATH}：

   COPY ./src ${WWWPATH}
   COPY write_config.sh /usr/local/bin/
   RUN chmod +x /usr/local/bin/write_config.sh
   # 此时能访问到模板文件，执行配置生成
   RUN write_config.sh
   

2. docker-compose.yml的卷挂载保持不变——容器启动时，本地./src会覆盖镜像里的${WWWPATH}，如果需要保留构建阶段生成的配置，可以把配置文件单独挂载成卷，而非挂载整个./src。

• 开发环境下，方案2生成的配置仅存在于容器内存，不会同步到本地./src；如果需要本地保留配置，可修改脚本把生成的配置写入挂载目录的指定文件。
• 生产环境建议采用方案1或方案3，避免容器启动时依赖外部挂载的文件，提升稳定性。

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