macOS下Docker代码变更延迟/不生效问题求助

问题背景 #

三名MacBook开发者协作Docker项目，仅本人环境出现异常：

• 初始执行docker compose up -d正常，一段时间后代码变更同步延迟，最终完全失效
• 仅能通过docker compose down && docker compose up -d重启恢复；重启笔记本可临时解决约1小时，之后问题复发
• 已尝试重置笔记本、重装组件、测试docker compose watch，均无效
• Docker Compose版本：2.24.1

我的docker-compose.yml配置 #

version: '3.8'
services:
  app:
    build:
      context: ./docker/app
      dockerfile: Dockerfile
    image: example/app
    ports:
      - '${LARAVEL_WEBSOCKETS_PORT:-6001}:${LARAVEL_WEBSOCKETS_PORT:-6001}'
      - "80:80"
      - "8000:8000"
    volumes:
      - .:/var/www/example-dev
      - /var/run/docker.sock:/var/run/docker.sock
    networks:
      overwatch:
        aliases:
          - example
      example-net:
  mysql:
    image: "${DB_IMAGE}"
    ports:
      - "${DB_PORT}:3306"
    environment:
      MYSQL_ROOT_PASSWORD: "${DB_PASSWORD}"
      MYSQL_DATABASE: "${DB_DATABASE}"
      MYSQL_ALLOW_EMPTY_PASSWORD: 'yes'
    volumes:
      - example_mysql:/var/lib/mysql
    networks:
      overwatch:
        aliases:
          - example_db
      example-net:
  redis:
    image: redis:alpine
    volumes:
      - example_redis:/data
    networks:
      - example-net
networks:
  example-net:
    driver: "bridge"
  overwatch:
    external: true
    name: overwatch
volumes:
  example_redis:
    driver: "local"
  example_mysql:
    driver: "local"

排查与解决建议 #

1. 调整Docker文件共享设置 #

Mac上Docker依赖文件共享实现主机-容器同步，优先排查这部分：

• 打开Docker Desktop → 设置 → 资源 → 文件共享，确认项目根目录已添加；尝试切换文件共享驱动（gRPC FUSE/osxfs），不同驱动在不同Mac版本上兼容性差异大
• 移除项目目录后重新添加，再重启Docker服务

2. 优化卷挂载的缓存策略 #

给挂载卷添加缓存参数，缓解同步延迟：
修改app服务的volumes配置，添加cached或delegated参数：

volumes:
  - .:/var/www/example-dev:cached  # 优先主机缓存，适合读多写少场景
  - /var/run/docker.sock:/var/run/docker.sock

• cached：主机优先缓存，提升读取速度
• delegated：容器优先缓存，提升写入速度
  可根据项目读写场景切换测试

3. 检查Docker资源占用 #

长时间运行后资源耗尽会导致同步异常：

• 打开Docker Desktop → 仪表盘 → 统计，监控CPU、内存、磁盘IO使用率；如果磁盘IO持续高位，说明文件共享存在瓶颈
• 调整Docker资源分配：设置 → 资源，分配至少4GB内存及2核以上CPU

4. 排查第三方工具冲突 #

Mac上的安全软件、云同步工具（如Dropbox、OneDrive）可能干扰文件共享：

• 暂时关闭这类工具，测试问题是否复发
• 检查防火墙设置，确保Docker网络连接未被限制

5. 排查配置中的潜在风险 #

从你的配置看，几个点可以验证：

• 暂时移除/var/run/docker.sock挂载（容器获得主机Docker权限，长时间运行可能导致socket连接异常），测试问题是否消失
• 检查外部网络overwatch状态：执行docker network inspect overwatch，确认无异常容器连接或配置错误
• 验证环境变量（如${DB_IMAGE}）是否正确加载，避免mysql服务异常间接影响app同步

6. 调整Docker Compose版本 #

当前2.24.1可能存在已知bug：

• 降级到2.23.x或升级到最新稳定版，测试问题是否解决
• 版本切换命令（brew安装场景）：

  # 升级到最新版
  brew upgrade docker-compose
  # 降级到指定版本（如2.23.3）
  brew install docker-compose@2.23.3
  

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