WordPress中CSV导入中文自定义字段部分失败问题求助

使用ACF插件创建了自定义文章类型articles及自定义字段article_keywords，因文章数量较多采用CSV批量导入，但大量文章的自定义字段更新失败。尝试过从Microsoft Excel和Google Sheets导出CSV，仅部分内容成功。当前使用的WordPress CSV导入函数无法通过update_post_meta()的返回值判断哪些文章未更新——即使更新失败，该函数也不会返回null。

原导入代码如下：

function import_custom_posts_from_csv($file_path)
{
    if (!file_exists($file_path) || !is_readable($file_path)) {
        return false;
    }

    $header = null;
    $data = array();
    if (($handle = fopen($file_path, 'r')) !== false) {
        while (($row = fgetcsv($handle, 1000, ',')) !== false) {
            if (!$header) {
                $header = $row;
            } else {
                // Check if the number of columns matches
                if (count($header) == count($row)) {
                    $data[] = array_combine($header, $row);
                } else {
                    if (count($row) > 10) {
                        for ($i = 0; $i < count($header); $i++) {
                            if (!isset($row[$i]) || $row[$i] === '') {
                                $row[$i] = '&nbsp;'; // Replace empty columns with a space
                            }
                        }
                        $data[] = array_combine($header, $row);
                    }
                }
            }
        }
        fclose($handle);
    }


    foreach ($data as $row) {
        // Check if the post already exists
        $existing_post = get_page_by_title($row['post_title'], ARRAY_N, 'articles');

        if (!empty($existing_post)) {
            $post_id = $existing_post[0];
            $post_data = array(
                'ID'           => $post_id,
                'post_title'   => $row['post_title'],
                'post_content' => '', // Add content if you have in CSV
                'post_status'  => 'publish',
                'post_date'  => format_post_date($row['publication_date']),
               
            );
            wp_update_post($post_data);
        } else {
            $post_data = array(
                'post_title'   => $row['post_title'],
                'post_content' => '', // Add content if you have in CSV
                'post_status'  => 'publish',
                'post_type'    => 'articles', // Change to your custom post type
               
                'post_date'  => format_post_date($row['publication_date']),
            );
            $post_id = wp_insert_post($post_data);
        }

        if ($post_id) {

            // Add or update custom fields
            foreach ($row as $key => $value) {
                if ($key != 'post_title' && $key != 'publish_date') {
                    // Retrieve the ACF field object using the field name
                    $field_object = acf_get_field($key);

                    if ($field_object) {
                        $field_key = $field_object['key'];
                       
                        update_post_meta($post_id, '_' . $key, $field_key);
                        if ($field_object['type'] == 'checkbox') {
                            // Split the checkbox values
                            $checkbox_values = explode(',', $value);
                           

                            update_post_meta($post_id, $key, $checkbox_values);
                        } else {
                            update_post_meta($post_id, $key, $value);

                           

                        }
                    }
                }
            }
        }
    }

    echo '<div class="notice notice-success is-dismissible"><p>CSV file imported successfully.</p></div>';
}

核心失败原因 #

1. CSV编码/格式问题：中文内容易出现编码不兼容（如Excel导出为GBK，WordPress用UTF-8），或字段含逗号/换行导致解析错误。
2. ACF字段匹配失效：acf_get_field($key)依赖字段名称精确匹配，若表头含空格/大小写不一致，会返回false跳过更新。
3. update_post_meta返回值逻辑：该函数在元数据未变化时返回true，仅数据库操作失败时返回false，无法区分“未修改”和“更新失败”。
4. 标题匹配不准确：get_page_by_title()易因重复标题、特殊字符返回错误的post_id。

修改后的导入函数（带错误追踪） #

function import_custom_posts_from_csv($file_path) {
    if (!file_exists($file_path) || !is_readable($file_path)) {
        error_log('CSV文件不存在或无法读取: ' . $file_path);
        return false;
    }

    // 强制转码为UTF-8，解决中文编码问题
    $file_content = file_get_contents($file_path);
    $file_content = mb_convert_encoding($file_content, 'UTF-8', mb_detect_encoding($file_content));
    $temp_file = tempnam(sys_get_temp_dir(), 'csv_');
    file_put_contents($temp_file, $file_content);

    $header = null;
    $data = array();
    $failed_entries = array(); // 记录失败条目

    if (($handle = fopen($temp_file, 'r')) !== false) {
        while (($row = fgetcsv($handle, 0, ',')) !== false) { // 取消长度限制，适配长内容
            if (!$header) {
                $header = array_map('trim', $row); // 去除表头空格
            } else {
                $row = array_map('trim', $row); // 去除每行内容空格
                if (count($header) == count($row)) {
                    $data[] = array_combine($header, $row);
                } else {
                    error_log('CSV列数不匹配，跳过行: ' . implode(',', $row));
                    $failed_entries[] = array('reason' => '列数不匹配', 'data' => $row);
                    continue;
                }
            }
        }
        fclose($handle);
        unlink($temp_file); // 删除临时文件
    }

    foreach ($data as $index => $row) {
        $post_title = trim($row['post_title']);
        if (empty($post_title)) {
            $failed_entries[] = array('reason' => '标题为空', 'data' => $row);
            continue;
        }

        // 使用标题+自定义类型精确匹配，避免重复标题问题
        $existing_post = get_posts(array(
            'post_type' => 'articles',
            'post_title' => $post_title,
            'post_status' => 'any',
            'numberposts' => 1,
            'fields' => 'ids'
        ));

        $post_id = null;
        if (!empty($existing_post)) {
            $post_id = $existing_post[0];
            $post_data = array(
                'ID' => $post_id,
                'post_title' => $post_title,
                'post_content' => '',
                'post_status' => 'publish',
                'post_date' => isset($row['publication_date']) ? format_post_date($row['publication_date']) : current_time('mysql')
            );
            $update_result = wp_update_post($post_data, true); // 开启错误返回
            if (is_wp_error($update_result)) {
                error_log('更新文章失败 ' . $post_title . ': ' . $update_result->get_error_message());
                $failed_entries[] = array('reason' => '文章更新失败', 'message' => $update_result->get_error_message(), 'data' => $row);
                continue;
            }
        } else {
            $post_data = array(
                'post_title' => $post_title,
                'post_content' => '',
                'post_status' => 'publish',
                'post_type' => 'articles',
                'post_date' => isset($row['publication_date']) ? format_post_date($row['publication_date']) : current_time('mysql')
            );
            $post_id = wp_insert_post($post_data, true); // 开启错误返回
            if (is_wp_error($post_id)) {
                error_log('创建文章失败 ' . $post_title . ': ' . $post_id->get_error_message());
                $failed_entries[] = array('reason' => '文章创建失败', 'message' => $post_id->get_error_message(), 'data' => $row);
                continue;
            }
        }

        if ($post_id) {
            $field_update_failed = false;
            foreach ($row as $key => $value) {
                $key = trim($key);
                if ($key == 'post_title' || $key == 'publication_date' || empty($key)) {
                    continue;
                }

                // 优先使用字段名称匹配，失败则尝试字段标签
                $field_object = acf_get_field($key);
                if (!$field_object) {
                    $field_object = acf_get_field_by_label($key);
                }

                if (!$field_object) {
                    error_log('找不到ACF字段 ' . $key . '，文章标题: ' . $post_title);
                    $failed_entries[] = array('reason' => 'ACF字段不存在', 'field' => $key, 'data' => $row);
                    $field_update_failed = true;
                    continue;
                }

                $field_key = $field_object['key'];
                $meta_key = $field_object['name'];

                // 更新ACF绑定元数据
                $meta_result = update_post_meta($post_id, '_' . $meta_key, $field_key);
                if ($meta_result === false) {
                    error_log('更新ACF绑定元数据失败 ' . '_' . $meta_key . '，文章ID: ' . $post_id);
                    $failed_entries[] = array('reason' => 'ACF绑定元数据更新失败', 'field' => '_' . $meta_key, 'data' => $row);
                    $field_update_failed = true;
                }

                // 处理字段值
                if ($field_object['type'] == 'checkbox') {
                    $checkbox_values = array_map('trim', explode(',', $value));
                    $checkbox_values = array_filter($checkbox_values); // 过滤空值
                    $value_result = update_post_meta($post_id, $meta_key, $checkbox_values);
                } else {
                    $value = mb_convert_encoding($value, 'UTF-8', mb_detect_encoding($value));
                    $value_result = update_post_meta($post_id, $meta_key, $value);
                }

                // 判断数据库级更新失败
                if ($value_result === false) {
                    error_log('更新字段 ' . $meta_key . ' 失败，文章ID: ' . $post_id);
                    $failed_entries[] = array('reason' => '字段更新失败', 'field' => $meta_key, 'data' => $row);
                    $field_update_failed = true;
                }
            }

            if (!$field_update_failed) {
                error_log('文章及字段更新成功，标题: ' . $post_title);
            }
        }
    }

    // 输出导入结果通知
    if (!empty($failed_entries)) {
        $error_msg = 'CSV导入完成，但有 ' . count($failed_entries) . ' 条条目失败。详情请查看WordPress错误日志。';
        echo '<div class="notice notice-error is-dismissible"><p>' . esc_html($error_msg) . '</p></div>';
        error_log('导入失败条目详情: ' . print_r($failed_entries, true));
    } else {
        echo '<div class="notice notice-success is-dismissible"><p>CSV文件导入成功。</p></div>';
    }

    return empty($failed_entries);
}

// 辅助函数：通过字段标签查找ACF字段
function acf_get_field_by_label($label) {
    $fields = acf_get_fields();
    foreach ($fields as $field) {
        if ($field['label'] == $label) {
            return $field;
        }
    }
    return false;
}

1. 规范CSV导出：
   • Google Sheets导出时选择「逗号分隔值(.csv)」，确保编码为UTF-8；
   • Excel导出时选择「CSV(逗号分隔)(*.csv)」，保存时指定UTF-8编码。
2. 验证ACF字段匹配：确认CSV表头与ACF字段的「名称」（不是标签）完全一致，注意大小写和空格。
3. 优化文章匹配：若存在重复标题，建议在CSV中加入post_id列，直接通过ID匹配更新更可靠。
4. 查看错误日志：开启WordPress调试模式（WP_DEBUG=true），查看wp-content/debug.log中的详细错误信息，快速定位问题。

内容的提问来源于stack exchange，提问作者Manoj Kumar Dora