ASP.NET Core+Docker跨项目共享文件夹文件持久化问题排查

一、容器重启文件丢失核心原因 #

• 容器内默认存储为临时层，未将文件目录挂载到宿主机本地目录或Docker持久化卷，导致容器销毁时文件丢失
• 上传逻辑可能硬编码了容器内临时路径，未指向共享挂载目录

二、Docker持久化配置修复（支持Windows/Linux） #

方案1：使用Docker命名卷（推荐，跨平台兼容） #

修改docker-compose.yml，添加共享卷并挂载到两个服务：

version: '3.8'

volumes:
  shared-files:  # 定义共享持久化卷

services:
  mvc-app:
    build: ./MvcApp
    volumes:
      - shared-files:/app/shared-files  # 挂载到容器内目录
    ports:
      - "5000:80"
    environment:
      - FileStoragePath=/app/shared-files

  web-api:
    build: ./WebApi
    volumes:
      - shared-files:/app/shared-files  # 同一卷挂载到API容器
    ports:
      - "5001:80"
    environment:
      - FileStoragePath=/app/shared-files

方案2：绑定宿主机目录（需注意跨平台路径） #

如果需要直接访问宿主机文件，用相对路径兼容Windows/Linux：

services:
  mvc-app:
    volumes:
      - ./shared-files:/app/shared-files  # 宿主机当前目录下的shared-files映射到容器
  web-api:
    volumes:
      - ./shared-files:/app/shared-files

注意：Windows下Docker Desktop需开启"文件共享"权限，Linux下需确保宿主机目录权限为chmod 777 ./shared-files

三、上传/读取逻辑优化 #

1. 配置化存储路径 #

在两个项目的appsettings.json中统一配置：

{
  "FileStorage": {
    "RootPath": "/app/shared-files"
  }
}

在Startup/Program.cs中注入配置：

// .NET 6+ Program.cs
builder.Services.Configure<FileStorageSettings>(builder.Configuration.GetSection("FileStorage"));

// 定义配置类
public class FileStorageSettings
{
    public string RootPath { get; set; }
}

2. 上传逻辑修正 #

确保上传时将文件写入挂载目录，而非webroot：

public async Task<string> UploadFile(IFormFile file, IOptions<FileStorageSettings> settings)
{
    var rootPath = settings.Value.RootPath;
    // 确保目录存在
    if (!Directory.Exists(rootPath))
    {
        Directory.CreateDirectory(rootPath);
    }
    // 生成唯一文件名避免冲突
    var fileName = $"{Guid.NewGuid()}{Path.GetExtension(file.FileName)}";
    var filePath = Path.Combine(rootPath, fileName);

    using var stream = new FileStream(filePath, FileMode.Create);
    await file.CopyToAsync(stream);

    return fileName; // 返回文件名，用于后续访问
}

四、Web API返回图片HTTP响应 #

在Web API中添加接口，读取共享目录文件并返回流：

[HttpGet("images/{fileName}")]
public IActionResult GetImage(string fileName, IOptions<FileStorageSettings> settings)
{
    var filePath = Path.Combine(settings.Value.RootPath, fileName);
    if (!System.IO.File.Exists(filePath))
    {
        return NotFound();
    }

    var fileStream = new FileStream(filePath, FileMode.Open);
    var contentType = GetContentType(fileName); // 获取文件MIME类型
    return File(fileStream, contentType);
}

private string GetContentType(string fileName)
{
    var ext = Path.GetExtension(fileName).ToLowerInvariant();
    return ext switch
    {
        ".jpg" or ".jpeg" => "image/jpeg",
        ".png" => "image/png",
        ".gif" => "image/gif",
        _ => "application/octet-stream"
    };
}

MVC项目可直接通过API地址访问图片，如http://web-api:5001/api/images/xxx.png

五、Dockerfile优化建议 #

确保Dockerfile中创建共享目录并设置权限（Linux容器）：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80
# 创建共享目录并设置权限
RUN mkdir -p /app/shared-files && chmod 777 /app/shared-files

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
# ... 原有构建逻辑 ...

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