WordPress Imagick转WebP上传图片出现Attachment ID相关警告如何解决？

问题根源 #

media_handle_upload是专门处理用户表单上传文件的函数，它会强制验证文件是否通过HTTP POST上传（依赖is_uploaded_file校验）。而你转换生成的WebP文件是服务器本地生成的，并非来自用户上传的临时文件，因此触发了“Specified file failed upload test.”错误，进而引发后续的PHP警告。

解决方案：改用wp_insert_attachment处理本地生成文件 #

放弃media_handle_upload，换成wp_insert_attachment + wp_generate_attachment_metadata的组合，这两个函数支持直接处理本地文件，无需上传验证。

具体代码调整步骤 #

假设你已完成原图片到WebP的转换，拿到了WebP文件绝对路径$webp_file_path和原文件路径$original_file_path，修改代码如下：

// 获取WordPress上传目录信息
$wp_upload_dir = wp_upload_dir();
// 获取WebP文件的文件名与MIME类型
$file_name = basename($webp_file_path);
$file_type = wp_check_filetype($file_name, null);

// 准备附件基础数据（可复用原图片的标题、描述等信息）
$attachment_post = array(
    'post_mime_type' => $file_type['type'],
    'post_title'     => sanitize_file_name(pathinfo($file_name, PATHINFO_FILENAME)),
    'post_content'   => '', // 可替换为原图片的post_content字段
    'post_status'    => 'inherit'
);

// 将WebP文件插入媒体库，$post_id为关联文章ID（无需关联传0即可）
$attachment_id = wp_insert_attachment($attachment_post, $webp_file_path, $post_id);

// 验证插入结果，生成并保存图片元数据
if (!is_wp_error($attachment_id)) {
    // 引入WordPress图片处理核心文件
    require_once(ABSPATH . 'wp-admin/includes/image.php');
    // 生成图片缩略图、尺寸等元数据
    $metadata = wp_generate_attachment_metadata($attachment_id, $webp_file_path);
    // 将元数据保存到数据库
    wp_update_attachment_metadata($attachment_id, $metadata);
    
    // 附件插入成功后，安全删除原文件
    if (file_exists($original_file_path)) {
        unlink($original_file_path);
    }
} else {
    // 记录插入失败日志，便于排查问题
    error_log('WebP附件插入失败：' . $attachment_id->get_error_message());
}

关键说明 #

• wp_insert_attachment：直接将本地文件作为附件插入媒体库，跳过上传验证逻辑，适配转换生成的文件场景。
• wp_generate_attachment_metadata：必须调用此函数，它会生成图片缩略图、尺寸信息等元数据，否则媒体库中WebP图片会缺少缩略图和尺寸展示。
• 原文件删除时机：必须放在附件插入成功之后，避免转换过程出错导致原文件丢失。

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