GitHub Actions中Docker Compose挂载卷失效问题排查

问题描述 #

在GitHub Actions自托管Worker主机上，尝试挂载app-back容器（镜像由其他Job构建缓存后下载）的目录以获取应用测试生成的文件，但遇到以下问题：

• 主机提前创建了/tmp/export目录，容器日志显示文件已生成，但主机该目录始终为空
• 给主机目录设置chmod 777后问题依旧
• docker inspect显示挂载配置正常（Type为bind，权限rw）

现有配置 #

• 容器启动Action步骤：下载镜像artifact、加载镜像、创建/tmp/export目录、启动Docker Compose、等待容器就绪并检查挂载状态
• docker-compose-ci.yml中back服务绑定挂载配置：- /tmp/export:/tmp/export
• workflow.yml的tests Job调用该Action，执行测试后停止容器

可能的原因及解决办法 #

1. 容器内文件生成路径不符 #

检查应用在容器内生成文件的实际路径是否确实为/tmp/export。部分场景下代码可能使用相对路径（如./export）或其他预设目录，导致文件并未写入挂载目录。可通过进入容器执行ls /tmp/export确认目录内是否存在文件。

2. 容器内进程权限不足 #

若容器内的应用进程以非root用户运行，可能没有权限写入挂载的/tmp/export目录：

• 临时测试：在docker-compose-ci.yml的back服务中添加user: root，验证是否能正常生成文件
• 长期解决：在主机创建目录时，指定与容器内运行用户一致的UID/GID，例如：

  mkdir -p /tmp/export && chown 1000:1000 /tmp/export
  

  （具体UID/GID需查看容器内用户配置，可通过docker exec <容器ID> id获取）

3. 自托管Worker的目录隔离机制 #

GitHub Actions自托管Worker可能对/tmp目录做了隔离或重置处理，导致你访问的主机/tmp并非容器实际挂载的目录。建议改用Worker工作目录下的路径：

• 在Action中创建${{ github.workspace }}/export目录
• 修改docker-compose-ci.yml的挂载配置为：- ${{ github.workspace }}/export:/tmp/export

4. 测试执行时机过早 #

若测试代码在容器未完全就绪时就执行，可能导致文件未正确生成到挂载目录。可延长容器就绪等待时间，或添加更严格的健康检查（如检查容器内特定服务端口、接口是否可用）后再执行测试。

5. Docker Compose挂载配置隐性问题 #

确认docker-compose-ci.yml的挂载语法无错误，确保使用的是绝对路径绑定挂载。若使用了独立的volumes块定义挂载，需同步检查该块的配置是否正确。

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