Docker Bind Mounts偶现空目录问题排查求助

嘿Hendrik，遇到这种偶发的Docker挂载问题真的挺闹心的，结合你提到的Btrfs子卷环境，我整理了几个可能的排查方向，你可以试试看：

• 检查存储挂载与容器启动的顺序：如果你的DataPool1存储卷是系统启动后期才完成挂载的（比如依赖某些存储服务或磁盘检测流程），容器可能在真实挂载就绪前就启动了。这时候Docker会自动在容器内创建一个空目录作为临时挂载点，后续即使宿主机的挂载完成，容器也不会自动重新识别这个挂载关系。你可以试试给容器配置restart: unless-stopped，或者调整systemd服务依赖，确保存储卷挂载完成后再启动容器服务。

• 排查Btrfs子卷的状态与权限：偶发的挂载失效可能和Btrfs的子卷操作（比如快照、平衡）有关。当问题出现时，在宿主机上执行以下命令检查子卷状态：

  btrfs subvolume list /srv/dev-disk-by-label-DataPool1
  

  同时确认挂载目录的权限：

  ls -ld /srv/dev-disk-by-label-DataPool1/Paperless/paperless_ng_media
  

  要保证容器运行的用户（paperless-ngx默认是UID/GID 1000）拥有该目录的读写权限，有时候子卷创建时的权限继承会有隐性问题。

• 开启Docker调试日志抓细节：既然常规的journalctl -u docker没看到错误，可以临时开启Docker的调试模式。修改/etc/docker/daemon.json添加如下配置：

  {
    "debug": true
  }
  

  然后重启Docker服务：

  systemctl restart docker
  

  等问题再次出现时，查看详细的Docker日志，说不定能捕捉到挂载过程中的隐性错误（比如Btrfs的IO异常、挂载参数冲突）。

• 用Named Volume替代Bind Mount做测试：有时候Btrfs和Docker Bind Mount的交互会有偶发兼容性问题，你可以尝试创建一个指向该子卷的Named Volume：

  docker volume create --driver local \
    --opt type=btrfs \
    --opt device=/srv/dev-disk-by-label-DataPool1/Paperless/paperless_ng_media \
    paperless-media
  

  然后修改容器配置里的volumes部分为paperless-media:/usr/src/paperless/media，观察是否还会出现同样的问题，这能帮你区分是Bind Mount本身的问题还是Btrfs子卷的配置问题。

• 检查宿主机的磁盘资源状态：问题出现时，及时查看宿主机的磁盘使用率（df -h）、IO负载（iostat -x 1）。如果磁盘IO瞬间打满或者出现IO错误，可能导致挂载点临时失效，Docker无法正确读写绑定目录，进而 fallback 到容器内部的空目录。

希望这些思路能帮你定位到问题根源！

备注：内容来源于stack exchange，提问作者henfri