Docker Compose构建报错：changes out of order问题求助

错误原因 #

1. Docker构建缓存冲突：changes out of order错误源于构建缓存中文件的修改/添加顺序与当前构建上下文不匹配，单独构建和Compose构建的缓存环境差异触发了该异常。
2. 环境变量不匹配：docker-compose.yml中给mongo-seed配置的环境变量是username/password，但导入脚本读取的是MONGO_USERNAME/MONGO_PASSWORD，会导致导入时使用默认账号而非配置的管理员账号。
3. 服务启动时机问题：mongo-seed未等待MongoDB完成初始化就执行导入，即使配置了depends_on，也仅能保证容器启动，无法确保服务就绪。

修复步骤 #

1. 清理构建缓存，解决顺序异常 #

首先清除旧的构建缓存，避免缓存干扰：

# 仅清理mongo-seed的构建缓存
docker-compose build --no-cache mongo-seed

# 若上述命令无效，可清除所有Docker构建缓存（注意：会删除所有未使用的构建缓存）
docker builder prune -af

2. 修正环境变量映射 #

修改docker-compose.yml中mongo-seed的环境变量，与脚本中的变量名保持一致，并添加健康检查依赖：

mongo-seed:
    build: mongo
    environment:
      MONGO_USERNAME: ${MONGO_INITDB_ROOT_USERNAME}
      MONGO_PASSWORD: ${MONGO_INITDB_ROOT_PASSWORD}
      MONGO_HOST: mongodb
      MONGO_DB: morefont
    networks: 
      - npm-network 
    restart: "no"
    depends_on:
      mongodb:
        condition: service_healthy  # 等待MongoDB健康检查通过后再启动

3. 优化导入脚本的稳定性 #

更新import-script.sh，增加MongoDB就绪等待逻辑，并调整错误处理策略：

#!/bin/bash
# Import script for MongoDB

# 读取环境变量或使用默认值
username="${MONGO_USERNAME:-admin}"
password="${MONGO_PASSWORD:-admin_123}"
host="${MONGO_HOST:-morefont-mongo}"
db="${MONGO_DB:-morefont}"

# 等待MongoDB服务就绪
echo "Waiting for MongoDB to be ready..."
until mongo --username ${username} --password ${password} --authenticationDatabase "admin" --host ${host} --eval "db.runCommand('ping')" >/dev/null 2>&1; do
    sleep 2
done
echo "MongoDB is ready!"

# 后续命令遇到错误即终止
set -e

# 逐个导入JSON文件到对应集合
for file in /seed/*.json; do
    collection=$(basename "$file" .json)
    echo "Importing collection: ${collection}"
    mongoimport --username ${username} --password ${password} --authenticationDatabase "admin" --mode upsert --host ${host} --db ${db} --collection ${collection} --type json --file "$file" --jsonArray
done

echo "All data imports completed successfully!"
exit 0

4. 确认构建上下文目录结构 #

确保docker-compose.yml所在的项目根目录下，mongo子目录的结构正确：

项目根目录
├── docker-compose.yml
└── mongo/
    ├── Dockerfile
    ├── import-script.sh
    └── seed/
        ├── fontstylegroups.json
        └── 其他MongoDB数据文件

5. 重新构建并启动服务 #

# 测试环境下可清理旧容器和卷（生产环境谨慎操作）
docker-compose down -v

# 重新构建并启动服务
docker-compose build --no-cache mongo-seed
docker-compose up -d

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