Laravel spatie media library v8 重生成转换更换格式后如何清理旧格式冗余文件

当前场景背景 #

• 业务使用spatie media library v8版本，对存量PNG格式图片执行默认JPG格式转换后，系统会独立生成全新的JPG格式文件，最终同一资源下同时存在原PNG文件与新生成的JPG文件，形成存储冗余
• 待处理图片总量超40万张，对批量操作的安全性、准确性要求极高
• 前期调研已知悉工具提供clear、clean两类内置清理命令，但尚未确认其是否为最优处理路径，也未梳理其他适配场景的实现方式

关联参考素材 #

• 官方参考指引：spatie media library v8 官方文档
• 旧格式（双文件冗余）示例截图：
  
• 目标格式示例截图：
  

内置清理命令的适用边界对比 #

• clear命令：核心能力为清空指定媒体集合下的所有关联媒体条目、对应存储文件，属于高风险的全量删除操作。该命令不适用于本次格式转换的冗余清理场景，误执行会直接删除全量业务关联图片，无法满足高精度操作的安全要求
• clean命令：核心能力为扫描存储目录，删除无数据库媒体记录关联的孤立文件。该命令本身无法删除已在数据库登记的原PNG文件，仅可作为全量操作完成后的收尾校验工具，不能作为核心清理手段

40万级图片批量处理的安全落地路径 #

• 前置准备：操作前完整备份媒体元数据表、对应全量文件存储目录，配置操作回滚机制，避免不可逆的损失
• 配置调整：在关联媒体的模型类中，移除对PNG源格式的持久化保留配置，将默认输出格式调整为JPG，从规则层面避免新的冗余文件产生
• 分批执行：将全量媒体记录按每批1000-2000条拆分，借助队列异步触发新格式的图片派生流程，每批操作完成后校验文件生成成功率，避免一次性全量操作引发的内存溢出、服务超时问题
• 定向清理：遍历每批已完成JPG派生的媒体条目，通过媒体实例提供的定向删除能力，仅移除数据库中已登记的原PNG文件，保留新生成的JPG文件的关联关系，避免直接调用通用删除逻辑误删新生成的目标文件
• 收尾校验：所有批次处理完成后，运行clean命令扫描全存储目录，清理操作过程中产生的临时孤立文件，完成最终的冗余校验

操作注意事项：每批次正式批量处理前，先抽样校验3-5条样本的转换、删除效果，确认逻辑匹配预期后再扩大处理范围；全程禁用全量范围的clear类操作，严格限定每一步的操作边界。

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