Docker容器偶发无法识别jar文件问题求助

问题现象 #

运行Spring Boot应用的Docker容器多数时候能正常识别jar文件，但偶发启动失败，提示Unable to access jarfile。异常时容器内执行ls显示挂载目录无文件，但主机端该目录文件正常；容器挂载配置显示正确，主机端对应路径ls能看到文件。重建容器后问题可解决，系统为Mac 12.0.1。

相关配置 #

Dockerfile

FROM openjdk:8-oraclelinux8
RUN mkdir /app
WORKDIR /app
CMD "java" "-jar" "app.war"

docker-compose.yml

version: "3.9"
services:
  app:
    build: .
    depends_on:
      - sql1
    volumes:
      - ./target:/app
    ports:
      - "8080:8080"
    links:
      - "sql1:sqlserver"
    ...

排查思路 #

• 排查文件生成与容器启动的竞态：你先构建jar包再启动容器，偶发场景下可能容器启动时，主机端target/app.war还未完全写入完成，导致Docker挂载时无法识别。建议在启动容器前增加校验：比如用脚本判断文件存在且大小非零，再启动容器；或者修改容器启动命令，等待文件出现后再执行java命令：

  CMD until [ -f app.war ] && [ -s app.war ]; do sleep 1; done && java -jar app.war
  

• 针对Mac Docker挂载的inode特性优化：Mac下Docker通过HyperKit实现文件共享，若主机端jar包被重新构建覆盖，文件inode会变化，容器挂载可能无法同步更新。避免直接挂载整个target目录到容器/app，改为挂载单个jar文件，或者直接将jar包COPY进镜像（彻底规避挂载同步问题）：

  # 修改Dockerfile，将jar包打包进镜像
  FROM openjdk:8-oraclelinux8
  RUN mkdir /app
  WORKDIR /app
  COPY target/app.war .
  CMD java -jar app.war
  

• 检查文件权限与Mac文件系统映射：Mac的文件权限在Docker共享时可能存在映射异常，确保主机端target/app.war有可读权限（执行chmod +r ./target/app.war），也可在Dockerfile中指定非root用户运行容器，避免权限冲突：

  RUN useradd -m appuser
  USER appuser
  

• 重启Docker桌面服务排查同步缓存：Mac Docker桌面版偶发会出现文件同步延迟，尝试重启Docker服务，或在Docker设置中调整文件共享的同步策略（关闭缓存或调整同步频率）。
• 验证挂载目录的同步状态：异常发生时，在主机端执行stat target/app.war记录inode值，同时在容器内（若能进入）执行stat /app/app.war对比inode，确认是否因inode变化导致挂载失效。

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