使用docker-compose时文件为何被挂载为文件夹？

问题根源 #

Docker绑定挂载的核心规则：

• 挂载文件时，本地必须存在对应路径的文件，如果本地路径不存在，Docker会自动创建同名目录而非文件。
• 当挂载整个目录到容器目录时，容器内原目录的内容会被本地目录覆盖；若本地目录缺少容器内原有的文件路径，容器进程尝试写入该路径时，会在本地创建同名目录，最终同步回容器内显示为目录。

结合你的配置和现象，问题出在：

1. 你挂载了./cassandra:/cassandra，若容器镜像的/cassandra目录原本有init-cassandra.cql、init.sh等文件，但你的本地./cassandra目录下这些文件不存在，容器启动后，进程写入这些路径时会在本地创建同名目录，导致容器内显示为目录。
2. 第二个挂载./cassandra/init-cassandra.cql:/etc/cassandra/init-cassandra.cql，如果启动前本地该文件不存在，Docker会自动创建为目录并挂载，导致容器内/etc/cassandra/init-cassandra.cql变为目录。

解决步骤 #

1. 修复本地文件结构 #

先检查本地文件状态，确保目标路径是文件而非目录：

# 检查init-cassandra.cql状态
ls -al ./cassandra/init-cassandra.cql
# 检查init.sh状态
ls -al ./cassandra/init.sh

如果发现是目录，立即删除：

rm -rf ./cassandra/init-cassandra.cql ./cassandra/init.sh

重新创建正确的文件：

# 重建init.sh（恢复你的脚本内容）
cat > ./cassandra/init.sh << 'EOF'
# 这里写入你的init.sh原有内容
EOF
chmod +x ./cassandra/init.sh

# 创建init-cassandra.cql并写入内容
cat > ./cassandra/init-cassandra.cql << 'EOF'
// 这里写入你的CQL初始化语句
EOF

2. 清理旧容器 #

停止并删除当前运行的容器，避免残留挂载状态：

# 若使用docker-compose
docker-compose down
# 若直接用docker命令
docker rm -f <你的容器ID或名称>

3. 调整挂载配置（可选） #

如果不想覆盖容器/cassandra目录的默认内容，避免挂载整个目录，改为挂载具体子文件/目录：

init:
  image: containerregistry-na.jpmchase.net/container-external/docker.io/cassandra:4.0.0
  restart: "no"
  volumes:
    # 只挂载需要持久化或自定义的子目录/文件
    - ./cassandra/data:/cassandra/data
    - ./cassandra/init.sh:/cassandra/init.sh
    - ./cassandra/init-cassandra.cql:/etc/cassandra/init-cassandra.cql

4. 验证结果 #

重新启动容器后，进入容器检查文件状态：

docker exec -it <容器ID> ls -l /cassandra
docker exec -it <容器ID> ls -l /etc/cassandra/init-cassandra.cql

确认所有目标路径均为文件而非目录即可。

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