WooCommerce 的自定义商品字段默认保存在 WordPress 的 wp_postmeta 表中，通过 post_id 关联商品；如需存入自定义数据库表，需手动创建表结构并改写保存逻辑。
woocommerce 的自定义商品字段默认保存在 wordpress 的 `wp_postmeta` 表中，通过 `post_id` 关联商品；如需存入自定义数据库表，需手动创建表结构并改写保存逻辑。
在 WooCommerce 中，使用 add_meta_box() 或 woocommerce_product_options_general_product_data 钩子添加的自定义字段（如 _custom_product_number_field），其值默认不会写入新表，而是统一存储于 WordPress 核心的 wp_postmeta 数据表中。该表结构简洁高效，包含四个关键字段：
-
meta_id（主键） -
post_id（关联商品的wp_posts.ID） -
meta_key（字段标识符，如_custom_product_number_field） -
meta_value（序列化或原始字符串值）
✅ 验证方式：在 phpMyAdmin 或数据库管理工具中执行以下 SQL 即可查到你的自定义值：
SELECT * FROM wp_postmeta WHERE post_id = 123 AND meta_key = '_custom_product_number_field';
（将 123 替换为对应商品 ID）
⚠️ 注意事项：
- 所有以
_开头的meta_key默认为“私有字段”，后台编辑页不可见（符合 WooCommerce 最佳实践）； - 必须使用
esc_attr()或更安全的sanitize_text_field()/sanitize_number_field()进行输入过滤，避免 XSS 或数据污染； -
woocommerce_process_product_meta钩子在商品保存时触发，但不区分新建/更新场景，建议补充if ( defined('DOING_AUTOSAVE') && DOING_AUTOSAVE ) return;防止自动保存冲突。
? 若需存入自定义数据表（例如 wp_woocommerce_custom_fields），需三步实现：
-
创建数据表（推荐在插件激活时执行）：
function create_custom_fields_table() { global $wpdb; $table_name = $wpdb->prefix . 'woocommerce_custom_fields'; $charset_collate = $wpdb->get_charset_collate(); $sql = "CREATE TABLE $table_name ( id BIGINT(20) NOT NULL AUTO_INCREMENT, product_id BIGINT(20) NOT NULL, field_key VARCHAR(100) NOT NULL, field_value LONGTEXT, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_product_key (product_id, field_key) ) $charset_collate;"; require_once( ABSPATH . 'wp-admin/includes/upgrade.php' ); dbDelta( $sql ); } register_activation_hook( __FILE__, 'create_custom_fields_table' ); -
改写保存逻辑（替换原
woocommerce_product_custom_fields_save）：function woocommerce_product_custom_fields_save( $post_id ) { if ( defined('DOING_AUTOSAVE') && DOING_AUTOSAVE ) return; if ( !current_user_can('edit_product', $post_id) ) return; $value = isset( $_POST['_custom_product_number_field'] ) ? sanitize_text_field( $_POST['_custom_product_number_field'] ) : ''; global $wpdb; $table_name = $wpdb->prefix . 'woocommerce_custom_fields'; // 先删除旧记录（确保单 key 单值） $wpdb->delete( $table_name, [ 'product_id' => $post_id, 'field_key' => '_custom_product_number_field' ] ); // 再插入新值（仅当非空） if ( !empty( $value ) ) { $wpdb->insert( $table_name, [ 'product_id' => $post_id, 'field_key' => '_custom_product_number_field', 'field_value' => $value ] ); } } -
读取自定义表数据（例如在商品详情页显示）：
function get_custom_field_from_table( $product_id, $key ) { global $wpdb; $table_name = $wpdb->prefix . 'woocommerce_custom_fields'; return $wpdb->get_var( $wpdb->prepare( "SELECT field_value FROM $table_name WHERE product_id = %d AND field_key = %s", $product_id, $key ) ); } // 使用示例：echo get_custom_field_from_table( get_the_ID(), '_custom_product_number_field' );
? 总结：
绝大多数场景下，直接使用 wp_postmeta 是最佳选择——它已高度优化、支持缓存、兼容所有 WooCommerce 扩展及 REST API；仅当存在高频 JOIN 查询、审计合规要求或超大字段（如 JSON 配置块）时，才建议引入自定义表。务必避免重复造轮子，优先利用 WordPress 原生元数据机制的稳定性与生态兼容性。
