自定义文章类型URL移除post-name，用元属性标识遇404问题

我明白你的痛点：你想让自定义文章类型property的URL用location分类slug和propertystream_agent_ref元字段来标识，已经生成了期望的URL格式，但访问时出现404，而强制保留post-name虽然能解决404却不符合需求。

问题根源 #

你之前的代码只实现了URL的显示替换，但没有告诉WordPress如何解析这个自定义URL结构——WordPress默认需要通过post名称或ID来定位文章，当你去掉post-name后，没有对应的重写规则和查询逻辑，系统找不到对应的文章，就会返回404。

完整解决方案 #

下面是调整后的代码，分步骤解决问题：

1. 修正自定义文章类型注册

首先调整register_post_types方法，简化rewrite设置（把动态部分移到重写规则里）：

final private static function register_post_types () { 
    $labels = array( 
        'name' => _x( 'Properties', 'post type general name', 'propertystreambootstrap' ), 
        'singular_name' => _x( 'Property', 'post type singular name', 'propertystreambootstrap' ), 
        'menu_name' => _x( 'Properties', 'admin menu', 'propertystreambootstrap' ), 
        'name_admin_bar' => _x( 'Property', 'add new on admin bar', 'propertystreambootstrap' ), 
        'add_new' => _x( 'Add New', 'property', 'propertystreambootstrap' ), 
        'add_new_item' => __( 'Add New Property', 'propertystreambootstrap' ), 
        'new_item' => __( 'New Property', 'propertystreambootstrap' ), 
        'edit_item' => __( 'Edit Property', 'propertystreambootstrap' ), 
        'view_item' => __( 'View Property', 'propertystreambootstrap' ), 
        'all_items' => __( 'All Properties', 'propertystreambootstrap' ), 
        'search_items' => __( 'Search Properties', 'propertystreambootstrap' ), 
        'parent_item_colon' => __( 'Parent Properties:', 'propertystreambootstrap' ), 
        'not_found' => __( 'No properties found.', 'propertystreambootstrap' ), 
        'not_found_in_trash' => __( 'No properties found in Trash.', 'propertystreambootstrap' ) 
    ); 
    $args = array( 
        'labels' => $labels, 
        'description' => __( 'Properties for your website.', 'propertystreambootstrap' ), 
        'public' => true, 
        'publicly_queryable' => true, 
        'show_ui' => true, 
        'show_in_menu' => true, 
        'menu_icon' => 'dashicons-building', 
        'query_var' => true, 
        'rewrite' => array( 
            'slug' => 'malta-property', 
            'with_front' => false // 根据站点结构调整，是否保留根目录前缀
        ), 
        'has_archive' => false, 
        'capability_type' => 'post', 
        'hierarchical' => false, 
        'menu_position' => null, 
        'supports' => array('title', 'editor', 'excerpt', 'post-thumbnails') 
    ); 
    register_post_type( 'property', $args ); 
}

2. 添加自定义重写规则

修改url_rewrite方法，添加匹配你URL结构的规则，让WordPress能识别malta-property/{location}/{reference}格式：

final public static function url_rewrite() { 
    // 注册rewrite标签，用于解析URL参数
    add_rewrite_tag('%reference%', '([^/]+)', 'reference='); 
    add_rewrite_tag('%location%', '([^/]+)', 'location='); 

    // 添加自定义重写规则，优先匹配我们的URL结构
    add_rewrite_rule(
        '^malta-property/([^/]+)/([^/]+)/?$',
        'index.php?post_type=property&location=$matches[1]&reference=$matches[2]',
        'top'
    );
}

3. 调整永久链接过滤器

修改permalink_structure方法，直接生成我们需要的URL，同时只处理property类型的文章：

final public static function permalink_structure ($permalink, $post, $leavename) { 
    // 仅处理自定义文章类型property
    if ($post->post_type !== 'property') {
        return $permalink;
    }

    $reference = get_post_meta($post->ID, 'propertystream_agent_ref', true); 
    $location_terms = wp_get_post_terms($post->ID, 'location'); 
    $location = !empty($location_terms) ? str_replace('-cat', '', $location_terms[0]->slug) : '';

    // 如果元数据或分类为空， fallback到默认永久链接（可选）
    if (empty($reference) || empty($location)) {
        return $permalink;
    }

    // 构建最终的自定义URL
    return home_url('/malta-property/' . $location . '/' . $reference . '/');
}

4. 添加查询逻辑，让WordPress找到对应文章

添加一个pre_get_posts钩子，告诉WordPress如何通过location和reference参数查询到对应的文章：

final public static function custom_property_query($query) {
    // 仅处理前端主查询，且是property类型的请求
    if (!is_admin() && $query->is_main_query() && isset($query->query_vars['post_type']) && $query->query_vars['post_type'] === 'property') {
        $meta_query = [];
        $tax_query = [];

        // 根据reference元字段过滤
        if (isset($query->query_vars['reference'])) {
            $meta_query[] = array(
                'key' => 'propertystream_agent_ref',
                'value' => $query->query_vars['reference'],
                'compare' => '='
            );
        }

        // 根据location分类过滤
        if (isset($query->query_vars['location'])) {
            $tax_query[] = array(
                'taxonomy' => 'location',
                'field' => 'slug',
                'terms' => str_replace('-cat', '', $query->query_vars['location'])
            );
        }

        if (!empty($meta_query)) {
            $query->set('meta_query', $meta_query);
        }
        if (!empty($tax_query)) {
            $query->set('tax_query', $tax_query);
        }
    }
}
add_action('pre_get_posts', array(__CLASS__, 'custom_property_query'));

5. 刷新重写规则（关键步骤）

修改主题激活/停用钩子，确保重写规则生效：

// 主题激活时刷新重写规则
final public static function activate() {
    self::register_post_types();
    self::url_rewrite();
    flush_rewrite_rules();
}
register_activation_hook(__FILE__, array(__CLASS__, 'activate'));

// 主题停用时恢复默认规则（可选）
final public static function deactivate() {
    flush_rewrite_rules();
}
register_deactivation_hook(__FILE__, array(__CLASS__, 'deactivate'));

注意事项 #

• 确保propertystream_agent_ref元字段的值是唯一的，否则可能出现多个文章匹配的情况；
• 确认location分类的slug处理逻辑（str_replace('-cat', '', ...)）符合你的实际分类slug格式；
• 每次修改重写规则后，都需要刷新规则：可以通过后台「设置→固定链接」页面，随便切换一种格式再保存，无需实际修改。

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