WordPress画廊图片导入问题：默认插件失效的简便方案咨询

这个问题我之前帮朋友处理过，确实默认的WP-Importer插件在处理画廊短码的附件ID映射上存在短板——导入后附件的旧ID被替换成新ID，但文章里的[gallery ids="..."]短码不会自动同步更新，导致画廊无法正常显示。除了开发自定义脚本，还有几个更省心的解决方案：

1. 使用带ID映射功能的第三方导入插件（最简便） #

这是新手友好度最高的方案，完全不用写代码。推荐两款插件：

• WP Migrate DB：免费版就支持基础的ID映射功能，导出源站数据时勾选「包含附件」，导入到新站时，插件会自动扫描所有内容中的旧附件ID，替换为新站对应的新ID，包括画廊短码里的ID。
• All-in-One WP Migration：同样支持自动处理ID映射，操作流程更直观，适合对数据库操作不太熟悉的用户。

操作步骤基本都是：源站导出完整数据包→新站安装插件并导入数据包→插件自动完成ID映射和内容更新，画廊短码直接恢复正常。

2. 利用WP-Importer生成的ID映射，写一次性替换脚本 #

如果你已经用默认插件完成了导入，不想再重新导入，可以利用WP-Importer自动生成的旧ID映射记录（存储在wp_postmeta表中，meta_key为_wp_old_post_id），写一个简单的PHP脚本批量替换：

<?php
// 放到网站根目录，访问一次后删除
require_once('wp-load.php');

// 获取附件旧ID到新ID的映射关系
$mapping = $wpdb->get_results(
    "SELECT meta_value AS old_id, post_id AS new_id 
     FROM {$wpdb->prefix}postmeta 
     WHERE meta_key = '_wp_old_post_id' AND post_type = 'attachment'",
    ARRAY_A
);
$id_map = array_column($mapping, 'new_id', 'old_id');

// 遍历所有包含画廊短码的文章
$posts = $wpdb->get_results(
    "SELECT ID, post_content 
     FROM {$wpdb->prefix}posts 
     WHERE post_content LIKE '%[gallery ids=%'"
);

foreach ($posts as $post) {
    // 正则替换短码中的旧ID为新ID
    $new_content = preg_replace_callback(
        '/\[gallery ids="([^"]+)"\]/',
        function($matches) use ($id_map) {
            $old_ids = explode(',', $matches[1]);
            $new_ids = [];
            foreach ($old_ids as $old_id) {
                $new_ids[] = isset($id_map[$old_id]) ? $id_map[$old_id] : $old_id;
            }
            return '[gallery ids="' . implode(',', $new_ids) . '"]';
        },
        $post->post_content
    );
    
    // 更新文章内容
    $wpdb->update(
        $wpdb->prefix . 'posts',
        ['post_content' => $new_content],
        ['ID' => $post->ID]
    );
}

echo '画廊短码ID替换完成！';
?>

把这个脚本命名为fix-gallery-ids.php放到网站根目录，用浏览器访问一次，执行完成后记得删除脚本，避免安全风险。

3. 给默认WP-Importer添加钩子，导入时自动替换 #

如果不想用第三方插件，也不想事后处理，可以在导入前给默认WP-Importer加个钩子，让它在导入文章时自动替换画廊短码里的ID。在主题的functions.php中添加以下代码：

add_action('import_post_meta', 'replace_gallery_ids_during_import', 10, 3);
function replace_gallery_ids_during_import($post_id, $post_meta, $post) {
    global $wpdb;
    
    // 只处理文章类型的内容
    if ($post['post_type'] !== 'post') return;
    
    $content = $post['post_content'];
    // 跳过不含画廊短码的文章
    if (strpos($content, '[gallery ids=') === false) return;
    
    // 获取已导入附件的ID映射
    $mapping = $wpdb->get_results(
        "SELECT meta_value AS old_id, post_id AS new_id 
         FROM {$wpdb->prefix}postmeta 
         WHERE meta_key = '_wp_old_post_id' AND post_type = 'attachment'",
        ARRAY_A
    );
    $id_map = array_column($mapping, 'new_id', 'old_id');
    
    // 替换短码中的ID
    $new_content = preg_replace_callback(
        '/\[gallery ids="([^"]+)"\]/',
        function($matches) use ($id_map) {
            $old_ids = explode(',', $matches[1]);
            $new_ids = [];
            foreach ($old_ids as $old_id) {
                $new_ids[] = isset($id_map[$old_id]) ? $id_map[$old_id] : $old_id;
            }
            return '[gallery ids="' . implode(',', $new_ids) . '"]';
        },
        $content
    );
    
    // 更新导入后的文章内容
    wp_update_post(['ID' => $post_id, 'post_content' => $new_content]);
}

添加完成后再用默认WP-Importer导入内容，插件会在导入每篇文章时自动处理画廊短码的ID替换。

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