如何配置ImageHandlerSyntax插件映射URL适配ImageResizer的Diskcache

前提准备 #

确保你已经安装了两个核心插件：ImageResizer.Plugins.DiskCache 和 ImageResizer.Plugins.ImageHandlerSyntax，可通过NuGet安装，也可手动将对应dll放入站点bin目录。

基础配置（Web.config） #

首先在站点配置文件的<resizer>节点注册插件，同时完成DiskCache基础参数配置：

<configuration>
  <resizer>
    <plugins>
      <add name="DiskCache" />
      <add name="ImageHandlerSyntax" />
    </plugins>
    <!-- 缓存目录可自定义，autoClean设置为true开启自动过期清理 -->
    <diskCache dir="~/App_Data/ImageCache" autoClean="true" cacheAccessTimeout="30000" />
  </resizer>
</configuration>

自定义URL规则映射（核心步骤） #

ImageHandlerSyntax支持通过正则匹配你现有电商站点的URL模式，将路径中的参数映射为ImageResizer可识别的查询参数，同时兼容DiskCache的缓存触发逻辑。
举个示例，假设你的现有URL模式为 /images/products/{商品SKU}/{宽度}x{高度}/{文件名}.jpg，实际访问路径如 /images/products/2001/800x600/blue-coat.jpg，需要将路径中的宽高提取为ImageResizer的宽高参数，同时映射到原始图片的实际存储路径，配置如下：

<add name="ImageHandlerSyntax">
  <patterns>
    <add 
      pattern="^images/products/([^/]+)/(\d+)x(\d+)/([^/]+\.(?:jpg|png|webp))$" 
      rewrite="~/product-original/$1/$4?w=$2&h=$3&mode=max" 
      stopProcessing="true" 
    />
  </patterns>
</add>

参数说明：

• pattern：填写现有URL的正则表达式，用分组捕获需要提取的变量
• rewrite：重写后的访问路径，$1/$2对应正则的分组捕获结果，后缀跟上ImageResizer支持的标准查询参数，比如宽度w、高度h、裁剪模式mode、质量quality等
• stopProcessing：设置为true后匹配到当前规则就不会继续走其他重写逻辑，避免和站点其他规则冲突

配置验证 #

• 直接访问原有格式的图片URL，确认返回对应尺寸的处理后图片
• 检查DiskCache配置的缓存目录，确认已经生成对应的缓存文件，即说明规则适配成功

注意事项 #

• 正则匹配规则要足够精准，避免误匹配其他静态资源
• 若你的URL中包含图片质量、裁剪方式等参数，也可以通过正则分组捕获后映射为ImageResizer对应的查询参数
• 若使用ASP.NET Core版本的ImageResizer，规则逻辑完全一致，仅需将配置放在appsettings.json的对应节点即可

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