运行时Docker卷挂载到Compose容器失败，求解决方法

核心问题排查 #

你直接复制文件到/var/lib/docker/volumes/<volume_name>是错误的——Docker卷的实际数据存储目录是<volume_name>/_data，容器挂载卷时，实际映射的是这个_data子目录，而非卷的根目录。这是导致容器内看不到文件的最常见原因。

可行解决方案 #

1. 修正Python代码的目标路径 #

将shutil.copytree的目标路径指向卷的_data子目录：

import os
import shutil

# 拼接正确的卷数据目录路径
volume_data_path = os.path.join("/var/lib/docker/volumes", env["volume_name"], "_data")
shutil.copytree(env["directory_files"], volume_data_path, dirs_exist_ok=True)

2. 用Docker命令复制文件（更规范，避免直接操作Docker内部目录） #

直接操作/var/lib/docker目录依赖Docker的存储驱动，存在兼容性风险。推荐用临时容器挂载卷来复制文件：

docker run --rm -v my_volume:/target -v /本地源目录:/source busybox cp -r /source/. /target/

如果要在Python中执行，可通过subprocess调用：

import subprocess

subprocess.run([
    "docker", "run", "--rm",
    "-v", f"my_volume:/target",
    "-v", f"{env['directory_files']}:/source",
    "busybox", "cp", "-r", "/source/.", "/target/"
], check=True)

3. 检查并修复权限问题 #

如果文件已在_data目录但容器仍无法读取，可能是权限不匹配：

• 临时修改卷内文件权限（适用于测试场景）：

  docker run --rm -v my_volume:/target busybox chmod -R 755 /target
  

• 若容器以非root用户运行，需确保该用户对卷内文件有读取权限，可在复制时指定用户/组：

  docker run --rm -v my_volume:/target -v /本地源目录:/source busybox sh -c "cp -r /source/. /target/ && chown -R 1000:1000 /target"
  

  （将1000:1000替换为容器内使用的用户UID:GID）

4. 验证卷挂载配置 #

• 确认docker-compose.yml中的卷名称与实际存在的外部卷完全一致，执行docker volume ls查看所有卷列表。
• 启动容器后，进入容器检查挂载点：

  docker exec -it <你的容器名称> ls -l /etc/sampledata
  

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