本文介绍如何在通过 SQL 批量删除 WooCommerce 库存为“outofstock”的商品时，自动清理对应的商品缩略图，避免媒体库中残留无用图片。核心方案是结合 before_delete_post 钩子安全删除附件。
本文介绍如何在通过 sql 批量删除 woocommerce 库存为“outofstock”的商品时，自动清理对应的商品缩略图，避免媒体库中残留无用图片。核心方案是结合 `before_delete_post` 钩子安全删除附件。
直接执行 SQL 删除商品（如 DELETE FROM wp_posts WHERE post_type = 'product'...）虽高效，但绕过了 WordPress 的标准删除流程，导致 wp_delete_post() 不被触发，进而无法自动清理关联的缩略图、图库附件及元数据。因此，仅靠 SQL 无法保证媒体文件同步清理。
✅ 推荐解决方案：利用 before_delete_post 钩子拦截删除动作，在物理删除前主动清理缩略图
该钩子在 wp_delete_post() 执行前触发（包括 wp_delete_attachment() 调用前），且适用于所有永久删除操作（$force_delete = true 时生效）。以下代码可无缝集成到您的现有逻辑中：
// 在商品被永久删除前，自动移除其缩略图附件
add_action('before_delete_post', 'delete_product_thumbnail_on_delete');
function delete_product_thumbnail_on_delete($post_id) {
$post = get_post($post_id);
// 仅处理 WooCommerce 商品
if ($post && $post->post_type === 'product') {
$thumbnail_id = get_post_thumbnail_id($post_id);
if ($thumbnail_id && wp_attachment_is_image($thumbnail_id)) {
// 第二个参数 true = 彻底删除（不移入回收站）
wp_delete_attachment($thumbnail_id, true);
}
}
}⚠️ 重要注意事项：
- 此钩子仅对调用 wp_delete_post() 的删除行为生效。您当前的纯 SQL 删除（DELETE FROM wp_posts...）不会触发该钩子，因为 WordPress 完全 unaware。
- ✅ 正确做法：改用 wp_delete_post() 批量删除，确保钩子生效并维持数据一致性：
function remove_out_of_stock_products_safely() {
// 获取所有库存状态为 outofstock 的商品 ID
$out_of_stock_ids = get_posts([
'post_type' => 'product',
'post_status' => 'publish',
'posts_per_page' => -1,
'meta_query' => [
[
'key' => '_stock_status',
'value' => 'outofstock',
],
],
'fields' => 'ids', // 仅获取 ID，提升性能
]);
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);? 补充建议：
- 若必须使用 SQL（如超大数据量场景），请额外编写脚本查询 wp_postmeta 中 _thumbnail_id 并手动调用 wp_delete_attachment()；
- 始终在生产环境前于测试站点验证，并备份数据库；
- 可扩展该逻辑：同时删除商品图库（_product_image_gallery 元字段中的附件 ID）以实现彻底清理。
通过钩子驱动的删除方式，既保持了 WooCommerce 数据完整性，又从根本上解决了媒体库冗余问题。
