WordPress基于ACF配置自定义文章类型多级固定链接遇404问题

你当前的实现仅修改了前台输出的固定链接文本，但没有为WordPress注册对应URL结构的解析规则，WordPress默认重写逻辑无法识别多层嵌套的自定义文章类型路径，无法从URL中匹配到对应文章，因此返回404。仅刷新重写规则无法解决问题，因为你从未将自定义的路径匹配规则写入WP的重写体系。

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

注册四类CPT时，必须在rewrite配置中声明对应层级的占位符，关闭with_front避免被全局固定链接前缀干扰：

// 注册最顶层region
add_action('init', function(){
    register_post_type('region', [
        'labels' => [...],
        'public' => true,
        'rewrite' => [
            'slug' => '/',
            'with_front' => false
        ],
        'has_archive' => false,
        // 保留你原有的其他配置
    ]);

    // 注册county
    register_post_type('counties', [
        'labels' => [...],
        'public' => true,
        'rewrite' => [
            'slug' => '%region%',
            'with_front' => false
        ],
        'has_archive' => false,
        // 保留你原有的其他配置
    ]);

    // 注册city
    register_post_type('cities', [
        'labels' => [...],
        'public' => true,
        'rewrite' => [
            'slug' => '%region%/%county%',
            'with_front' => false
        ],
        'has_archive' => false,
        // 保留你原有的其他配置
    ]);

    // 注册community
    register_post_type('communities', [
        'labels' => [...],
        'public' => true,
        'rewrite' => [
            'slug' => '%region%/%county%/%city%',
            'with_front' => false
        ],
        'has_archive' => false,
        // 保留你原有的其他配置
    ]);
});

2. 修正固定链接替换逻辑 #

你原有代码存在斜杠不统一、缺少空值判断、硬拼路径易出错的问题，统一使用占位符替换逻辑实现：

add_filter('post_type_link', function($url, $post){
    // 顶层region无需额外替换处理
    if ($post->post_type === 'counties') {
        $region = get_field('region', $post->ID);
        if ($region) {
            $url = str_replace('%region%', $region->post_name, $url);
        }
    }
    if ($post->post_type === 'cities') {
        $county = get_field('county', $post->ID);
        if ($county) {
            $region = get_field('region', $county->ID);
            $url = str_replace(['%region%', '%county%'], [$region->post_name, $county->post_name], $url);
        }
    }
    if ($post->post_type === 'communities') {
        $city = get_field('city_post', $post->ID);
        if ($city) {
            $county = get_field('county', $city->ID);
            $region = get_field('region', $county->ID);
            $url = str_replace(['%region%', '%county%', '%city%'], [$region->post_name, $county->post_name, $city->post_name], $url);
        }
    }
    // 统一处理路径斜杠，避免双斜杠、缺斜杠问题
    $url = home_url(user_trailingslashit(ltrim(str_replace(home_url(), '', $url), '/')));
    return $url;
}, 10, 2);

3. 注册自定义URL解析重写规则 #

这是你之前完全缺失的核心步骤，需要告诉WordPress如何匹配不同层级的URL，将路径映射到对应CPT的文章查询。注意长路径规则必须排在短路径之前，避免被提前匹配：

add_filter('rewrite_rules_array', function($rules){
    $new_rules = [];
    // 四级路径：匹配community详情 优先级最高
    $new_rules['^([^/]+)/([^/]+)/([^/]+)/([^/]+)/?$'] = 'index.php?post_type=communities&name=$matches[4]';
    // 三级路径：匹配city详情
    $new_rules['^([^/]+)/([^/]+)/([^/]+)/?$'] = 'index.php?post_type=cities&name=$matches[3]';
    // 二级路径：匹配county详情
    $new_rules['^([^/]+)/([^/]+)/?$'] = 'index.php?post_type=counties&name=$matches[2]';
    // 一级路径：匹配region详情
    $new_rules['^([^/]+)/?$'] = 'index.php?post_type=region&name=$matches[1]';

    // 合并规则，自定义规则优先于系统默认规则
    return $new_rules + $rules;
});

4. 添加层级合法性校验（可选但推荐） #

为了避免不同CPT出现同名slug时页面错配，添加查询校验，当URL中的上层slug和文章实际关联的上层对象不一致时，强制返回404：

add_action('pre_get_posts', function($query){
    if (!is_admin() && $query->is_main_query() && is_singular()) {
        $post_type = $query->get('post_type');
        $request_path = trim(parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH), '/');
        $segments = explode('/', $request_path);

        if ($post_type === 'counties' && count($segments) == 2) {
            $post = get_queried_object();
            $region = get_field('region', $post->ID);
            if ($region && $region->post_name !== $segments[0]) {
                $query->set_404();
            }
        }
        if ($post_type === 'cities' && count($segments) == 3) {
            $post = get_queried_object();
            $county = get_field('county', $post->ID);
            $region = $county ? get_field('region', $county->ID) : null;
            if (!$region || !$county || $region->post_name !== $segments[0] || $county->post_name !== $segments[1]) {
                $query->set_404();
            }
        }
        if ($post_type === 'communities' && count($segments) == 4) {
            $post = get_queried_object();
            $city = get_field('city_post', $post->ID);
            $county = $city ? get_field('county', $city->ID) : null;
            $region = $county ? get_field('region', $county->ID) : null;
            if (!$region || !$county || !$city || $region->post_name !== $segments[0] || $county->post_name !== $segments[1] || $city->post_name !== $segments[2]) {
                $query->set_404();
            }
        }
    }
});

生效操作 #

代码部署完成后，到后台「设置-固定链接」页面，无需修改任何配置，直接点击保存按钮刷新重写规则，所有层级页面即可正常访问，不会再返回404。

该实现完全基于CPT关联字段自动生成层级链接，不需要额外给文章分配自定义分类法，完全匹配需求。

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