WordPress媒体库：服务端拒删时如何阻止客户端视图移除图片？

你当前的实现存在两个核心问题，直接导致了前端视图误删的异常：

1. 响应格式不兼容：直接用wp_die()抛出400错误时，返回的是纯文本错误页面，并不是WordPress媒体JS预期的标准AJAX JSON格式响应
2. 钩子使用方式不规范：pre_delete_attachment钩子的设计逻辑是通过返回值中断默认删除流程，而非直接终止请求，直接die的写法绕过了WP内置的错误响应传递机制，让前端JS无法正确识别操作状态

补充：WordPress媒体库的默认JS逻辑，会在接收到删除请求的响应后：成功则从视图移除条目，失败则弹出错误提示、保留视图条目。但当响应格式无法被JS解析时，部分版本会触发异常分支，直接把条目从视图移除，和实际的服务端结果脱节。

1. 修正服务端钩子的实现逻辑 #

不要在钩子中直接调用wp_die()，改为利用钩子的返回值机制拦截删除，返回WP_Error对象，让WP自动生成符合前端预期的错误响应：

add_filter('pre_delete_attachment', 'check_locked_cpt_thumbnail', 10, 2);
function check_locked_cpt_thumbnail($delete, $post) {
    // 非附件类型直接跳过校验
    if ('attachment' !== $post->post_type) {
        return $delete;
    }
    // 校验当前附件是否为自定义文章类型的锁定特色图像
    // 性能优化方案：可以在为CPT设置特色图像时，给附件写入_locked_thumbnail meta标记，直接读取判断即可
    $is_locked = get_post_meta($post->ID, '_locked_thumbnail', true);
    if (!empty($is_locked)) {
        return new WP_Error(
            'locked_attachment_delete',
            '该图像为自定义文章类型的必需特色图像，无法被永久删除'
        );
    }
    return $delete;
}

这种写法下，WP会自动捕获返回的WP_Error，返回格式为{"success":false,"data":"错误提示"}的标准JSON响应，媒体库JS收到响应后会弹出对应错误提示，完全不会触发视图移除逻辑。

2. 兼容旧版本的前端兜底 #

如果部分旧版WP环境、或自定义媒体选择器仍然存在误移除的问题，可以在后台页面加载对应JS脚本，挂载错误事件的兜底处理：

// 绑定到后台加载媒体库的页面对应脚本
wp.media.view.AttachmentsBrowser = wp.media.view.AttachmentsBrowser.extend({
    ready: function() {
        wp.media.view.AttachmentsBrowser.__super__.ready.apply(this, arguments);
        // 捕获附件删除的错误事件
        this.collection.on('error:delete', function(model) {
            // 被误移除的模型重新加回媒体集合
            this.collection.add(model);
            // 触发视图重绘
            this.trigger('reset');
        }, this);
    }
});

这个兜底逻辑会在检测到删除请求失败时，把JS临时从集合中移除的附件条目重新加回视图，避免出现“明明没删成但图没了”的异常。

• 不要将钩子优先级设为0：过低的优先级会导致其他插件的附件处理逻辑被提前中断，使用默认的10优先级即可
• 优化校验性能：不要每次删除请求都反向查询所有CPT的特色图像关联关系，可以在设置特色图像时给对应附件写入锁定标记，校验时直接读meta值，减少数据库查询开销
• 覆盖所有删除入口：pre_delete_attachment钩子会覆盖媒体库AJAX删除、后台编辑页删除、REST接口删除的所有场景，只要钩子逻辑正确，不需要额外写其他拦截代码

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