使用cargo-watch与Docker Compose运行Rust工作区项目遇错误

问题分析 #

你遇到的间歇性文件写入错误，核心原因集中在这几点：

• 跨平台文件系统差异：Mac本地APFS与Linux容器内文件系统的挂载同步存在延迟，cargo并行编译时可能出现文件未完成同步就尝试写入的情况。
• Dockerfile路径错误：源码复制路径拼写错误，导致目录结构异常，触发偶发编译路径问题。
• 本地target挂载竞争：本地与容器同时操作target目录，容易出现文件状态不一致的冲突。

修复步骤 #

1. 修正Dockerfile中的路径错误 #

Dockerfile里的源码复制路径写错了，把错误的路径替换为正确的项目路径：

# 错误行
# COPY ./lib_bot/src ./librium_bot/src
# 替换为
COPY ./lib_bot/src ./lib_bot/src

2. 用Docker卷替代本地target挂载 #

取消本地./target的挂载，改用Docker卷存储编译产物，彻底避免跨文件系统的同步问题：
修改docker-compose.yml的volumes配置：

services:
  lib_bot:
    # 其他配置保持不变
    volumes:
      - cargo_registry_lib_bot:/usr/local/cargo/registry
      - ./lib_bot/src:/app/lib_bot/src
      - ./lib_bot/Cargo.toml:/app/lib_bot/Cargo.toml
      # 移除本地target挂载，改用Docker卷
      - target_lib_bot:/app/target
      - ./Cargo.lock:/app/Cargo.lock
      - ./Cargo.toml:/app/Cargo.toml

volumes:
  cargo_registry_lib_bot: {}
  # 新增target专用卷
  target_lib_bot: {}

3. 调整cargo-watch命令，增加同步延迟 #

给cargo-watch添加延迟参数，让文件系统有足够时间完成同步后再触发编译：
修改Dockerfile的CMD指令：

CMD ["cargo", "watch", "--delay", "1s", "-x", "run", "-p", "lib_bot"]

4. 统一文件权限（可选） #

如果仍存在权限相关的偶发问题，可以在Dockerfile中创建非root用户，避免容器root用户操作本地文件的权限冲突：

# 在WORKDIR指令后添加
RUN useradd -m rustuser
USER rustuser

也可以在docker-compose.yml中通过user: "${UID}:${GID}"参数，让容器使用与本地一致的用户ID运行（启动时需确保环境变量传递正确）。

验证修改 #

重新构建镜像并启动容器：

docker-compose down
docker-compose build
docker-compose up

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