Nginx后端应用Docker共享卷挂载配置错误排查

核心错误点 #

1. 错误复用同一个卷挂载到多个关键目录：你将myshare卷同时挂载到前端容器的/etc/nginx和/usr/share/nginx/html，而Docker本地卷初始状态为空，直接覆盖了Dockerfile中复制到容器内的nginx.conf配置文件和Vue构建后的静态文件，导致Nginx启动时找不到必要的配置。
2. 挂载目录偏离需求：你的目标是让后端访问前端的上传文件，但当前挂载的是Nginx的配置目录和静态文件根目录，完全不符合共享上传文件的需求。

修复步骤 #

1. 调整docker-compose.yml配置 #

创建专门的上传共享卷，仅挂载到前后端的上传文件目录，避免影响容器原有文件结构：

version: "3.8"

services:
  use_frontend:
    container_name: 'use_frontend'
    volumes:
      # 仅将前端的上传目录挂载到共享卷
      - 'upload_share:/usr/share/nginx/html/uploads'
    build: 
      context: ./admin
      dockerfile: Dockerfile
    restart: always
    depends_on:
      - use_backend
    ports:
      - 8090:80

  use_db:
    container_name: use_db
    image: postgres:14.2
    # 保留原有数据库配置...

  use_backend:
    container_name: 'use_backend'
    volumes:
      # 后端挂载到自身的上传目录，与前端共享同一卷
      - 'upload_share:/app/uploads'  # 此处路径需与后端代码中指定的上传目录一致
    build: 
      context: ./api
      dockerfile: Dockerfile
    restart: always
    depends_on:
      - use_db
    # 保留原有后端配置...

volumes:
  upload_share:
    driver: local

2. 配置Nginx处理上传请求 #

修改Nginx配置文件，确保上传请求能正确指向共享的uploads目录：

events {}

http {
    server {
        listen 80;
        root /usr/share/nginx/html;
        include /etc/nginx/mime.types;
        
        client_max_body_size 20M;

        location / {
            try_files $uri /index.html;
        }

        # 处理上传文件的访问请求
        location /uploads/ {
            alias /usr/share/nginx/html/uploads/;
            autoindex off;
        }

        # 保留原有其他配置...
    }
}

3. 调整前后端代码路径 #

• 前端代码：确保上传逻辑将文件保存到容器内的/usr/share/nginx/html/uploads目录。
• 后端代码：确保读取上传文件时指向容器内的/app/uploads目录（与docker-compose中挂载的路径一致）。

4. 清理旧资源并重新部署 #

# 停止容器并删除旧卷（避免残留问题）
docker compose down -v
# 重新构建镜像
docker compose build
# 启动服务
docker compose up

额外说明 #

• 不需要修改前端的Dockerfile：当前Dockerfile的逻辑是正确的——构建Vue项目后将静态文件复制到Nginx目录，仅需确保挂载的是新增的uploads目录，而非覆盖原有Nginx配置或静态文件目录。
• Docker卷挂载规则：挂载卷会覆盖容器内对应目录的原有内容，因此绝不能将空卷挂载到容器需要依赖的预配置目录（如Nginx的/etc/nginx）。

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