如何让WordPress列表文章类型URL保留城市别名，避免跳转？

问题根源 #

你遇到的404和URL跳转问题，核心是WordPress的规范URL（Canonical URL）机制和重写规则、查询变量的配合问题：

• 之前重写规则生效但URL跳转，是因为post_type_link返回的还是默认的/listings/[name]，WordPress会自动将请求的/city/[name]重定向到它认定的规范URL；
• 后来修改post_type_link返回/city/[name]却出现404，是因为重写规则的查询变量处理不完整，WordPress无法通过city和name参数匹配到对应的文章。

分步解决方案 #

1. 注册重写规则与查询变量

首先要让WordPress识别city作为合法查询变量，同时添加正确的重写规则：

// 放入主题functions.php或自定义插件文件
add_action('init', 'register_listing_rewrite_rules');
function register_listing_rewrite_rules() {
    // 注册city查询变量
    global $wp;
    $wp->add_query_var('city');

    // 添加重写规则：匹配 /[city]/[name] 结构，指向listings类型文章
    add_rewrite_rule(
        '^([^/]+)/([^/]+)/?$',
        'index.php?post_type=listings&city=$matches[1]&name=$matches[2]',
        'top' // 设为最高优先级，避免被其他规则覆盖
    );
}

2. 修复post_type_link过滤器

不要直接返回home_url构建的完整URL，同时处理城市字段为空的 fallback 逻辑，避免生成无效URL：

add_filter('post_type_link', 'custom_listing_permalink', 10, 2);
function custom_listing_permalink($permalink, $post) {
    if ($post->post_type !== 'listings') {
        return $permalink;
    }

    // 获取ACF字段的城市值
    $locations = get_field('listing_locations', $post->ID);
    $city_slug = '';
    if ($locations && !empty($locations[0]['city'])) {
        $city_slug = sanitize_title($locations[0]['city']);
    }

    // 城市字段为空时，返回默认permalink避免404
    if (empty($city_slug)) {
        return $permalink;
    }

    // 构建自定义URL结构
    $permalink = home_url(user_trailingslashit("{$city_slug}/{$post->post_name}"));
    return $permalink;
}

3. 修正文章查询逻辑

当WordPress接收到city参数时，需要让它能通过ACF字段匹配到对应文章，添加pre_get_posts过滤器：

add_action('pre_get_posts', 'adjust_listing_query');
function adjust_listing_query($query) {
    // 仅处理前台主查询且为listings类型的请求
    if (!is_admin() && $query->is_main_query() && isset($query->query_vars['post_type']) && $query->query_vars['post_type'] === 'listings') {
        if (isset($query->query_vars['city']) && !empty($query->query_vars['city'])) {
            $query->set('meta_query', array(
                array(
                    'key' => 'listing_locations_0_city', // ACF重复字段的meta_key格式，可通过wp_postmeta表确认
                    'value' => $query->query_vars['city'],
                    'compare' => '=' // 存储的是slug时用精确匹配更高效
                )
            ));
        }
    }
}

4. 刷新重写规则

完成代码添加后，进入WordPress后台设置→固定链接，直接点击「保存更改」即可刷新重写规则，无需修改现有设置。

关键注意事项 #

• 确认ACF字段listing_locations的结构正确，对应文章已填写有效的城市值；
• 若存在多文章共用同一城市+文章名的情况，需添加额外逻辑避免冲突；
• 可开启WP_DEBUG=true查看错误日志，排查潜在问题。

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