Docker Compose开发环境中./back:/app与./front:/app卷挂载失效求助

问题现象 #

开发环境下，Docker Compose配置中的./back:/app和./front:/app卷挂载后，本地文件修改无法同步到容器内，项目可正常构建但热重载不生效，其他卷（如MySQL数据卷）工作正常。

可能原因及解决方案 #

一、通用排查步骤 #

• 确认路径正确性：确保执行docker-compose up的目录与docker-compose.yml所在目录一致，./back和./front是相对于该目录的相对路径。
• 检查挂载状态：执行docker inspect backend和docker inspect frontend，查看Mounts字段，确认本地目录已正确挂载到容器内/app路径。
• 权限校验：进入容器（docker exec -it backend bash），查看/app目录权限（ls -ld /app），确保容器内用户拥有读写权限。若本地用户UID/GID与容器内不一致，可在服务配置中指定用户：

  services:
    backend:
      # 替换为本地用户的UID和GID，可通过`id -u`和`id -g`查看
      user: "1000:1000"
    frontend:
      user: "1000:1000"
  

二、前端（Vite）专属解决方案 #

Vite在容器内运行时，默认可能无法监听本地文件系统的变化，需调整监听配置：

1. 修改启动命令：在前端package.json中更新dev命令，添加监听参数：

   "scripts": {
     "dev": "vite --host 0.0.0.0 --watch"
   }
   

2. 配置Vite监听策略：在vite.config.js中启用轮询监听（解决容器内文件事件传递问题）：

   import { defineConfig } from 'vite'
   
   export default defineConfig({
     server: {
       host: '0.0.0.0',
       watch: {
         usePolling: true
       }
     }
   })
   

3. 保留匿名卷配置：当前配置中/app/node_modules匿名卷无需修改，可避免本地node_modules与容器内依赖冲突。

三、后端（Spring Boot）专属解决方案 #

Spring Boot默认不启用热重载，需添加依赖并配置：

1. 添加DevTools依赖：在pom.xml中引入Spring Boot DevTools：

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-devtools</artifactId>
       <scope>runtime</scope>
       <optional>true</optional>
   </dependency>
   

2. 配置热重载参数：在src/main/resources/application.properties中添加：

   spring.devtools.restart.enabled=true
   spring.devtools.restart.additional-paths=src/main/java
   spring.devtools.restart.poll-interval=2000ms
   

3. 确认挂载覆盖逻辑：挂载./back:/app会覆盖容器构建时复制的文件，确保本地back目录包含完整的项目文件（pom.xml、mvnw、src等），容器内执行的./mvnw spring-boot:run会直接使用挂载后的本地文件。

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