本文介绍在通过 SQL 直接删除 WooCommerce 商品后，如何自动清理对应的产品缩略图（媒体库文件），避免产生冗余图片资源。核心方案是利用 WordPress 的 before_delete_post 钩子，在商品永久删除前调用 wp_delete_attachment() 安全移除缩略图。
本文介绍在通过 sql 直接删除 woocommerce 商品后，如何自动清理对应的产品缩略图（媒体库文件），避免产生冗余图片资源。核心方案是利用 wordpress 的 `before_delete_post` 钩子，在商品永久删除前调用 `wp_delete_attachment()` 安全移除缩略图。
在 WooCommerce 开发中，为优化库存管理，开发者有时会采用直接执行 SQL 的方式批量删除“缺货”（outofstock）商品，例如使用 DELETE ... JOIN 语句高效清空数据库记录。但这种方式绕过了 WordPress 的标准删除流程（如 wp_delete_post()），因此不会触发 delete_post、deleted_post 或媒体关联清理逻辑，导致商品缩略图仍滞留在媒体库中，长期积累将造成存储浪费与管理混乱。
要解决该问题，关键在于在商品被物理删除前捕获事件，并主动清理其附件资源。WordPress 提供了可靠的钩子 before_delete_post —— 它在 wp_delete_post() 执行 DELETE 查询之前触发（即使你用 SQL 删除，只要最终调用的是 WordPress 删除接口，此钩子仍有效；但需注意：你当前的纯 SQL 删除 并不会 触发该钩子！因此必须重构删除逻辑）。
✅ 正确做法：弃用裸 SQL 删除，改用 WordPress 原生函数，确保钩子生效：
function remove_out_of_stock_products_safely() {
// 获取所有缺货商品 ID（避免一次性加载过多）
global $wpdb;
$out_of_stock_ids = $wpdb->get_col( $wpdb->prepare(
"SELECT p.ID FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm ON p.ID = pm.post_id
WHERE p.post_type = 'product'
AND p.post_status = 'publish'
AND pm.meta_key = '_stock_status'
AND pm.meta_value = 'outofstock'
LIMIT 100" // 建议分批处理，防止超时
) );
foreach ( $out_of_stock_ids as $product_id ) {
// 使用 wp_delete_post() 触发完整生命周期钩子
wp_delete_post( $product_id, true ); // true = 永久删除（不进回收站）
}
}
add_action( 'init', 'remove_out_of_stock_products_safely', 10 );
随后，注册 before_delete_post 钩子来清理缩略图：
add_action( 'before_delete_post', 'delete_product_thumbnail_before_deletion' );
function delete_product_thumbnail_before_deletion( $post_id ) {
$post = get_post( $post_id );
// 仅对 product 类型且存在缩略图的执行清理
if ( ! $post || $post->post_type !== 'product' ) {
return;
}
$thumbnail_id = get_post_thumbnail_id( $post_id );
if ( $thumbnail_id && wp_attachment_is_image( $thumbnail_id ) ) {
// true 参数表示连文件一起从服务器删除（非仅数据库记录）
wp_delete_attachment( $thumbnail_id, true );
}
}
⚠️ 重要注意事项：
- 原始 SQL 删除无法触发钩子：你当前的 DELETE ... FROM 语句完全绕过 WordPress 核心，因此上述钩子 不会运行。必须改用 wp_delete_post()。
- 性能与安全：批量删除时务必分页（如 LIMIT 100 + 循环）并配合 wp_defer_term_counting(true) 等优化，防止内存溢出或超时。
- 备份先行：执行前务必备份数据库，尤其是生产环境。
- 扩展性考虑：如需同时清理产品图库中的其他图片（如 product_image_gallery），可在钩子中读取 _product_image_gallery meta 并遍历删除。
通过以上组合方案，你既能自动化清理缺货商品，又能确保媒体资源零残留，兼顾效率与健壮性。
