WP REST API发布房产自定义文章类型故障：wp_postmeta属性字段未创建

我之前也碰到过类似的自定义文章类型REST API元字段不生效的问题，大概率是下面几个常见原因导致的，你可以逐一排查：

WordPress默认不会把自定义元字段暴露给REST API，必须手动注册并开启REST支持。你需要用register_post_meta函数把房产相关的元字段（比如面积、位置、价格等）注册进去，核心是设置show_in_rest => true。

举个实际代码例子，你可以把这段加到主题的functions.php或者自定义插件里：

function register_property_meta_fields() {
    // 注册房产价格字段
    register_post_meta( 'property', 'property_price', array(
        'show_in_rest' => true,
        'single' => true,
        'type' => 'number',
        'sanitize_callback' => 'sanitize_text_field',
        'auth_callback' => function() {
            return current_user_can( 'edit_posts' );
        }
    ) );

    // 注册房产位置字段
    register_post_meta( 'property', 'property_location', array(
        'show_in_rest' => true,
        'single' => true,
        'type' => 'string',
        'sanitize_callback' => 'sanitize_text_field',
        'auth_callback' => function() {
            return current_user_can( 'edit_posts' );
        }
    ) );

    // 继续注册你需要的其他元字段，比如property_area、property_bedrooms等
}
add_action( 'init', 'register_property_meta_fields' );

很多时候问题出在请求体的结构上——元字段必须嵌套在meta对象里，而不是直接跟title、content同级。正确的JSON请求体应该是这样的：

{
    "title": "市中心精装三居室",
    "content": "南北通透，采光极佳",
    "status": "publish",
    "type": "property",
    "meta": {
        "property_price": 2800000,
        "property_location": "朝阳区建国路",
        "property_area": 120
    }
}

如果直接把property_price放在根层级，REST API会忽略这个参数，自然不会写入wp_postmeta表。

检查你注册property自定义文章类型的代码，必须确保show_in_rest => true，并且supports数组包含custom-fields：

function register_property_post_type() {
    $args = array(
        'public' => true,
        'label'  => '房产',
        'show_in_rest' => true, // 关键：开启REST API支持
        'rest_base' => 'properties', // 可选，设置REST端点路径
        'supports' => array( 'title', 'editor', 'custom-fields' ) // 必须包含custom-fields
    );
    register_post_type( 'property', $args );
}
add_action( 'init', 'register_property_post_type' );

如果show_in_rest是false，整个自定义文章类型都无法通过REST API正常操作，更别说元字段了。

注册元字段时的auth_callback要确保当前请求的用户有编辑权限。另外，如果你的请求是前端发起的，要确认请求携带的身份凭证（比如JWT Token、Cookie）对应的用户拥有edit_posts或者自定义文章类型的编辑权限。

暂时禁用所有其他插件，尤其是那些修改REST API、自定义字段的插件（比如ACF），然后测试提交是否正常。如果禁用后问题解决，再逐个启用插件排查冲突源。

先从注册元字段和请求格式这两个最常见的点入手排查，一般都能解决问题。

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