如何在ASP.NET Core 9.0中创建无虚拟目录的读写文件目录？

核心思路 #

用配置驱动的物理路径映射+静态文件中间件模拟IIS虚拟目录的效果，既支持多环境路径配置，又能避免将文件目录纳入项目发布包。

步骤实现 #

1. 配置多环境文件存储路径 #

在不同环境的配置文件中定义对应的物理路径：

• 开发环境（appsettings.Development.json）：

  {
    "FileStorage": {
      "FilesPath": "D:\\Dev_Upload_Files\\"
    }
  }
  

• 预发布环境（appsettings.Staging.json）：

  {
    "FileStorage": {
      "FilesPath": "E:\\Staging_Upload_Files\\"
    }
  }
  

• 生产环境（appsettings.Production.json）：

  {
    "FileStorage": {
      "FilesPath": "F:\\Prod_Upload_Files\\"
    }
  }
  

生产环境也可通过环境变量ASPNETCORE_FileStorage__FilesPath配置，优先级高于配置文件，更适合部署场景。

2. 绑定配置到强类型模型（可选但推荐） #

创建配置类统一管理路径：

public class FileStorageSettings
{
    public string FilesPath { get; set; } = string.Empty;
}

在Program.cs中绑定配置：

builder.Services.Configure<FileStorageSettings>(builder.Configuration.GetSection("FileStorage"));

3. 配置静态文件中间件映射/files/路径 #

在Program.cs的中间件管道中添加静态文件映射，将/files/请求指向配置的物理目录：

// 读取配置的文件存储路径
var fileStorageSettings = builder.Configuration.GetSection("FileStorage").Get<FileStorageSettings>()!;

// 确保目录存在，避免上传时出错
if (!Directory.Exists(fileStorageSettings.FilesPath))
{
    Directory.CreateDirectory(fileStorageSettings.FilesPath);
}

// 映射/files/路径到物理目录
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(fileStorageSettings.FilesPath),
    RequestPath = "/files"
});

此时访问https://yourdomain/files/xxx.pdf会直接返回对应物理路径下的文件，和IIS虚拟目录效果一致。

4. 文件上传时使用配置路径 #

在控制器中注入配置，实现文件上传：

private readonly FileStorageSettings _storageSettings;

public FileController(IOptions<FileStorageSettings> storageOptions)
{
    _storageSettings = storageOptions.Value;
}

[HttpPost("upload")]
public async Task<IActionResult> Upload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("未选择文件");

    // 生成唯一文件名避免冲突
    var fileName = $"{Guid.NewGuid()}{Path.GetExtension(file.FileName)}";
    var fullPath = Path.Combine(_storageSettings.FilesPath, fileName);

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

    // 返回可访问的文件URL
    return Ok(new { FileUrl = $"/files/{fileName}" });
}

安全与权限注意事项 #

• 确保物理目录给应用运行身份分配了读写权限（IIS应用池身份或Kestrel运行用户）；
• 可通过中间件限制/files/路径的访问权限（比如仅登录用户可访问）；
• 添加文件类型校验，禁止上传可执行文件等危险类型；
• 可配置静态文件缓存策略，提升访问性能。

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