WooCommerce后台单个产品设置中ACF文件上传字段无法保存

你的代码存在两个核心问题导致文件无法保存：

1. 保存逻辑挂载的钩子错误：你在渲染字段的woocommerce_product_options_general_product_data钩子内处理保存，这个钩子仅在页面渲染时触发，无法捕获产品保存的提交请求。
2. 文件上传数据处理错误：文件上传依赖$_FILES全局变量而非$_POST，直接读取$_POST['acf']无法获取上传的文件数据，也没有完成文件上传到媒体库的流程。

修正后的代码 #

// 渲染ACF文件字段到WooCommerce产品常规设置标签
function add_acf_file_field_to_woocommerce_product_options() {
    global $product_object;
    $product_id = $product_object->get_id();

    // 字段配置
    $field_settings = array(
        'key' => 'field_my_file_field',
        'label' => '文件字段',
        'name' => 'my_file_field',
        'type' => 'file',
        'instructions' => '上传文件',
        'return_format' => 'url',
        'value' => get_field('field_my_file_field', $product_id), // 回显已保存的值
    );

    acf_render_field_wrap($field_settings);
}
add_action('woocommerce_product_options_general_product_data', 'add_acf_file_field_to_woocommerce_product_options');

// 处理产品保存时的文件上传与字段更新
function save_acf_file_field_for_woocommerce_product($product_id) {
    // 检查权限
    if (!current_user_can('edit_product', $product_id)) {
        return;
    }

    // 检查ACF文件字段的上传数据
    if (isset($_FILES['acf']['name']['field_my_file_field']) && !empty($_FILES['acf']['name']['field_my_file_field'])) {
        // 使用WordPress内置函数上传文件到媒体库
        $attachment_id = media_handle_upload('acf[field_my_file_field]', $product_id);

        // 检查上传是否成功
        if (!is_wp_error($attachment_id)) {
            // 根据字段配置的return_format保存对应值
            $field_object = get_field_object('field_my_file_field', $product_id);
            $field_value = 'url' === $field_object['return_format'] 
                ? wp_get_attachment_url($attachment_id) 
                : $attachment_id;

            update_field('field_my_file_field', $field_value, $product_id);
        }
    }
}
add_action('woocommerce_process_product_meta', 'save_acf_file_field_for_woocommerce_product');

代码说明 #

• 渲染部分：保留字段渲染逻辑，新增value参数回显已保存的文件，提升编辑页面的用户体验。
• 保存部分：
  • 挂载到专门的产品保存钩子woocommerce_process_product_meta，确保在产品保存动作触发时执行逻辑。
  • 通过$_FILES获取上传文件的原始数据，用media_handle_upload完成文件验证、存储到媒体库的完整流程，避免手动处理文件的安全风险。
  • 匹配ACF字段的return_format，自动保存对应的文件URL或媒体库附件ID。
  • 添加权限检查，防止未授权用户修改产品数据。

内容的提问来源于stack exchange，提问作者sambhu lambhu