WordPress多参数URL重写与动态路径模板映射配置问题

你需要的路径结构完全可以实现，规则不生效是重写缓存未刷新、规则覆盖场景不全、优先级不对导致的，具体配置方法如下：

核心问题原因 #

1. 未刷新 WordPress 重写缓存：每次修改 add_rewrite_rule 后必须刷新缓存才会生效
2. 仅覆盖了带视频ID的路径场景，缺少用户个人主页、用户视频列表的匹配规则，WordPress 无法识别中间的用户名参数，会直接 fallback 到 /users/ 父页面
3. 规则精度优先级错误：短路径规则如果放在前面会先命中，导致长路径规则失效

完整配置步骤 #

1. 添加全场景重写规则 #

替换子主题 functions.php 中原有的重写规则为以下内容：

// 匹配视频播放页：/users/用户名/videos/视频ID
add_rewrite_rule(
    '^users/([^/]+)/videos/(\d+)/?$',
    'index.php?pagename=users/videos/video-play&users_filter_name=$matches[1]&user_video_id=$matches[2]',
    'top'
);

// 匹配用户视频列表页：/users/用户名/videos/
add_rewrite_rule(
    '^users/([^/]+)/videos/?$',
    'index.php?pagename=users/videos&users_filter_name=$matches[1]',
    'top'
);

// 匹配用户个人主页：/users/用户名/
add_rewrite_rule(
    '^users/([^/]+)/?$',
    'index.php?pagename=users&users_filter_name=$matches[1]',
    'top'
);

注意：pagename 参数值需要和后台创建的页面层级完全对应：

• 一级页面 users 绑定用户个人主页模板，slug 为 users
• users 的子页面 videos 绑定视频列表模板，slug 为 videos
• videos 的子页面 video-play 绑定视频播放模板，slug 为 video-play
  三个页面天然保持父子层级，可直接适配原生面包屑导航逻辑。

2. 确认查询变量已注册 #

确保自定义参数已加入 WordPress 查询白名单（已配置可跳过）：

add_filter('query_vars', function($vars) {
    $vars[] = 'users_filter_name';
    $vars[] = 'user_video_id';
    return $vars;
});

3. 刷新重写缓存 #

进入 WordPress 后台 → 设置 → 固定链接，无需修改任何配置，直接点击「保存更改」即可清空旧缓存，新规则生效。

简化方案（可选） #

如果不需要单独创建三级播放页面，可在视频列表模板中添加判断：当 get_query_var('user_video_id') 有有效值时，直接加载播放页模板，面包屑导航手动拼接层级即可。

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