Docker共享卷中新文件无法被OMR容器访问的问题排查

问题描述 #

我的Web应用包含4个Docker容器：frontend（React）、backend（Express）、db（Postgres）、OMR（Python）。frontend、backend和db持续运行，OMR仅在被调用时启动。所有容器共享一个存储OMR相关内容的卷。用户在frontend上传待检测的PDF文件，该文件会被保存至共享卷内的inputs文件夹，随后调用OMR扫描文件并导出至outputs文件夹。从frontend和backend容器中可正常查看共享卷内的上传文件，但启动OMR容器后却无法看到这些文件。

问题根源 #

查看你的docker-compose.yaml中OMR服务的卷配置：

omr:
  # ...其他配置
  volumes:
    - ./omr:/app/omr
    - omr-volume:/app

存在两个核心问题：

• 主机目录./omr被挂载到容器的/app/omr，会覆盖共享卷omr-volume挂载到/app下的omr目录内容。如果主机本地./omr目录没有inputs文件夹，OMR自然看不到上传的文件。
• OMR的共享卷挂载路径/app与frontend（/app/omr）、backend（/code/omr）不一致，导致文件存储和读取的路径结构不统一。

解决方案 #

修改OMR服务的卷配置，调整挂载路径并移除冲突的主机目录挂载：

基础修改（生产/开发通用） #

omr:
  build:
    context: ./omr 
  environment:
    - OMR_CHECKER_CONTAINER=True
  volumes:
    # 移除主机目录挂载，避免覆盖共享卷内容
    # - ./omr:/app/omr
    # 统一挂载路径，与其他容器保持一致逻辑
    - omr-volume:/app/omr
  networks:
    - public
  depends_on:
    - db

开发环境保留热更新的修改 #

如果需要在开发时保留本地代码的热更新，不要挂载整个./omr目录，而是只挂载具体的代码文件/子目录：

omr:
  build:
    context: ./omr 
  environment:
    - OMR_CHECKER_CONTAINER=True
  volumes:
    # 仅挂载代码文件，不覆盖共享卷的inputs/outputs目录
    - ./omr/main.py:/app/omr/main.py
    - ./omr/utils:/app/omr/utils:ro
    # 保持共享卷挂载路径统一
    - omr-volume:/app/omr
  networks:
    - public
  depends_on:
    - db

修改说明 #

1. 移除冲突挂载：去掉./omr:/app/omr后，共享卷omr-volume的内容不会被本地目录覆盖，OMR容器就能访问到frontend和backend上传到inputs文件夹的文件。
2. 统一挂载路径：将共享卷挂载到/app/omr，和其他容器的共享卷访问路径逻辑对齐，确保文件存储和读取的路径结构一致，避免因路径差异导致的文件无法访问问题。

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