CkFinder每次重生成未修改图片缩略图 Azure Blob后端站点卡顿如何解决

核心原理 #

CKFinder 默认的缩略图请求逻辑会在每次拉取缩略图时，对比原图与已生成缩略图的修改时间，只要判定时间不匹配就会删除全部已有缩略图再重新生成。对接Azure Blob这类远程对象存储时，跨网络的IO操作延迟高，大容量目录下的批量并发请求就会导致站点卡顿。 #

可落地修改方案 #

方案1：调整配置项直接禁用重生成校验 #

找到你的CKFinder自定义后端对应的配置文件，修改缩略图相关参数，关闭修改时间校验和强制重生成逻辑，只要缩略图已存在就直接返回，不执行删除重建流程。
示例配置（PHP版后端参考，其他语言后端对应参数逻辑一致）：

$config['thumbnails'] = [
    'enabled' => true,
    // 核心参数：关闭原图与缩略图的修改时间校验
    'checkModificationTime' => false,
    // 关闭强制重生成开关
    'forceRegenerate' => false,
    'sizes' => [
        ['width' => 150, 'height' => 150, 'quality' => 80],
        ['width' => 300, 'height' => 300, 'quality' => 80]
    ],
    // 针对Azure Blob可额外配置缩略图缓存有效期，减少重复请求
    'cacheTTL' => 86400 * 30
];

方案2：修改核心代码跳过删除步骤 #

如果配置项调整不生效，可直接修改CKFinder后端缩略图处理的核心逻辑：

• 定位到缩略图管理类的generate方法（不同语言版本类名可能为ThumbnailManager/ThumbnailService）
• 找到方法开头执行删除当前文件所有已生成缩略图的代码段，直接注释掉该逻辑
• 新增判断：如果请求尺寸的缩略图已存在，直接返回文件流，不执行后续生成逻辑

方案3：Azure Blob存储适配优化 #

针对你使用的Azure Blob自定义存储对接逻辑，做额外优化降低IO消耗：

• 新增本地缩略图缓存层：把高频访问的缩略图缓存到服务端本地磁盘，请求优先走本地缓存，无需每次访问Azure Blob
• 给Azure Blob中存储的缩略图设置ETag标识，CKFinder请求时先校验ETag匹配，匹配则直接返回304状态，不触发文件读写操作
• 前端新增缩略图懒加载逻辑，滚动浏览时才触发对应位置的缩略图请求，减少批量并发请求量

注意事项 #

禁用修改时间校验后，如果后续覆盖上传了同名原图，需要手动删除对应缩略图触发重建，否则会继续显示旧版缩略图。

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