使用Docker-Compose构建Rust开发容器时遇[cargo: not found]错误

直接错误原因 #

你的Dockerfile.dev中CMD指令的JSON数组格式错误——数组元素之间缺少逗号分隔。Docker会将整个["cargo" "watch" "-x" "run"]视为单个命令名，导致找不到[cargo这个命令，从而抛出/bin/sh: 1: [cargo: not found错误。

修正后的Dockerfile.dev #

FROM rust
WORKDIR /app
# 安装cargo-watch，可指定版本提升兼容性
RUN cargo install cargo-watch
COPY . /app
# 修正JSON数组的逗号分隔格式
CMD ["cargo", "watch", "-x", "run"]

开发环境优化建议 #

1. 避免目录挂载冲突 #

在docker-compose.yml的devcontainer服务中，添加匿名卷排除target目录，防止宿主机的target文件与容器内的构建缓存冲突，同时保留容器内的构建缓存以加快编译速度：

services:
  devcontainer:
    # ... 其他配置
    volumes:
      - ./:/app
      - /app/target  # 排除target目录，使用容器内的缓存

2. 配置开发环境变量 #

为Rocket设置开发环境模式，同时配置数据库连接地址（对应compose中的db服务）：

services:
  devcontainer:
    # ... 其他配置
    environment:
      - ROCKET_ENV=development
      - DATABASE_URL=postgres://postgres:postgres@db:5432/postgres

3. 确保数据库就绪后启动服务 #

添加服务依赖和健康检查，避免Rocket服务在数据库未就绪时启动失败：

services:
  devcontainer:
    # ... 其他配置
    depends_on:
      db:
        condition: service_healthy

  db:
    # ... 其他配置
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5

关于生产环境的多阶段构建 #

你提供的多阶段Dockerfile是用于生产环境的优化构建（缓存依赖、使用轻量级镜像），开发环境无需复杂的多阶段流程，使用简化的Dockerfile.dev配合cargo-watch即可实现热重载开发。

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