如何配置ImageSharp.Web处理Blazor Server中非wwwroot目录的图片缩放？

核心问题是未给PhysicalFileSystemProvider配置对应的请求路径映射，ImageSharp.Web无法识别哪个URL前缀对应你指定的Uploads目录。此外，中间件顺序和部分配置细节也需要调整。

1. 完善PhysicalFileSystemProvider配置 #

给PhysicalFileSystemProviderOptions添加RequestPath，指定该提供者对应的URL路径（和你配置的静态文件请求路径一致），让ImageSharp知道拦截哪个路径下的图片请求：

.AddProvider<PhysicalFileSystemProvider>()
.Configure<PhysicalFileSystemProviderOptions>(options =>
{
    options.ProviderRootPath = SD.UploadsFullServerPath; // 改用已初始化的完整路径，避免重复拼接
    options.RequestPath = SD.UploadsRequestPath; // 关键：指定对应URL路径
});

2. 调整中间件顺序 #

app.UseImageSharp()必须放在app.UseStaticFiles()之前，否则静态文件中间件会直接返回原始图片，ImageSharp无法介入处理图片：

// 先启用ImageSharp处理
app.UseImageSharp();

// 再启用默认静态文件服务
app.UseStaticFiles();

// 最后启用Uploads目录的静态文件服务（若不需要直接访问原始图片可移除）
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(SD.UploadsFullServerPath),
    RequestPath = SD.UploadsRequestPath
});

3. 优化路径初始化逻辑 #

避免混用Directory.GetCurrentDirectory()和app.Environment.ContentRootPath，统一用ContentRootPath确保部署环境下路径正确，同时提前创建所需目录：

var app = builder.Build();

// 先初始化SD相关路径（移到app.Build()之后确保Environment可用）
SD.ContentRootPath = app.Environment.ContentRootPath;
SD.UploadsFullServerPath = Path.Combine(app.Environment.ContentRootPath, configuration["UploadsFolder:Name"]);
SD.UploadsRequestPath = configuration["UploadsFolder:WebPath"];
SD.UploadsNameOnly = configuration["UploadsFolder:Name"];
SD.UploadsRootFolderName = configuration["UploadsFolder:RootFolderName"];
SD.UploadsRootFolderWebPath = configuration["UploadsFolder:RootFolderWebPath"];

// 确保Uploads及缓存目录存在
var uploadsRootPath = Path.Combine(SD.UploadsFullServerPath, SD.UploadsRootFolderName);
var pathToUploadsCache = Path.Combine(SD.UploadsFullServerPath, "is-cache");
if (!Directory.Exists(SD.UploadsFullServerPath)) Directory.CreateDirectory(SD.UploadsFullServerPath);
if (!Directory.Exists(uploadsRootPath)) Directory.CreateDirectory(uploadsRootPath);
if (!Directory.Exists(pathToUploadsCache)) Directory.CreateDirectory(pathToUploadsCache);

4. 修正缓存配置 #

CacheRootPath设为null会默认使用WebRoot目录，若想指定自定义缓存目录，保持CacheFolder配置即可，无需设置CacheRootPath为null：

.Configure<PhysicalFileSystemCacheOptions>(options =>
{
    // 移除options.CacheRootPath = null;
    options.CacheFolder = pathToUploadsCache;
    options.CacheFolderDepth = 8;
})

假设你的UploadsRequestPath是/uploads，现在可以通过类似/uploads/your-image.jpg?width=200的URL访问并处理Uploads目录下的图片，ImageSharp会自动从指定目录读取图片并完成缩放等处理。

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