docker-compose.yml配置的build args未传递到Dockerfile问题求助

问题解决方案 #

• 优先执行配置校验
  运行docker-compose config命令查看当前生效的完整compose配置，确认web服务的build.args下file_url参数正常存在，排除多配置文件覆盖（比如docker-compose.override.yml、执行命令时指定额外-f参数）导致的参数丢失问题。
• 清理旧缓存后重试
  单独build正常但up --build失败，绝大多数是因为docker-compose优先匹配了本地没有构建参数的旧镜像缓存。执行以下命令清理残留后重试即可：

  # 停止并删除相关容器、卷、本地构建的镜像
  docker-compose down -v --rmi local
  # 无缓存重新构建并启动
  docker-compose up --build --no-cache
  

• 检查固定镜像标签配置
  如果web服务配置了自定义image标签，需先手动删除本地对应标签的旧镜像，避免compose跳过构建直接使用旧镜像：

  docker rmi <你配置的镜像标签>
  docker-compose up --build
  

• 版本兼容性校验
  低于1.27.0版本的docker-compose对3.8版本的compose文件语法支持存在缺陷，可升级docker-compose到最新稳定版，或使用新版Docker自带的compose V2命令重试：

  docker compose up --build
  

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