WordPress自定义用户档案模板遇404：/user/username路径无法访问

你操作中的错误点 #

1. 模板文件位置错误：WordPress默认不会扫描主题子目录（比如theme/user/）加载页面模板，你放在这个路径下的page-user.php无法被系统正确识别，即便后台选择了模板也无法生效。
2. 误解了页面模板的作用：常规页面模板仅对应固定的单个页面（比如/user/），无法处理/user/company这种带动态用户名后缀的URL——WordPress会把这个URL判定为user页面的子页面，但你并没有创建slug为company的子页面，所以返回404错误。

实现动态用户档案URL的正确步骤 #

1. 调整模板文件位置

将page-user.php（对应slug为user的页面）移动到主题根目录下，确保WordPress能正常识别这个模板。

2. 添加自定义Rewrite规则

在主题的functions.php文件中添加以下代码，让WordPress识别/user/{username}格式的URL，并将用户名作为参数传递给user页面：

function custom_user_profile_rewrite() {
    // 注册Rewrite规则，匹配/user/xxx格式的URL
    add_rewrite_rule(
        '^user/([^/]+)/?$',
        'index.php?pagename=user&username=$matches[1]',
        'top'
    );
    // 注册自定义查询变量
    add_rewrite_tag('%username%', '([^/]+)');
}
add_action('init', 'custom_user_profile_rewrite');

添加代码后，进入WordPress后台的设置→固定链接页面，点击「保存更改」按钮，刷新系统的Rewrite规则。

3. 修改模板文件逻辑

更新page-user.php的代码，获取URL中的用户名参数并加载对应用户的档案信息：

<?php
/*
    Template Name: User Profile
*/
get_header(); // 替代wp_head()，加载完整的主题头部

// 获取URL中的用户名参数
$username = get_query_var('username');

if ($username) {
    // 根据用户名查询用户信息
    $user = get_user_by('login', $username);
    
    if ($user) {
        // 输出用户档案内容（可根据需求自定义）
        echo '<div class="user-profile">';
        echo '<h1>' . esc_html($user->display_name) . '的个人档案</h1>';
        echo '<p>用户名：' . esc_html($user->user_login) . '</p>';
        echo '<p>邮箱：' . esc_html($user->user_email) . '</p>';
        echo '<p>注册时间：' . date('Y-m-d H:i:s', strtotime($user->user_registered)) . '</p>';
        echo '</div>';
    } else {
        echo '<p>未找到该用户的档案信息</p>';
    }
} else {
    // 访问/user/时的默认提示
    echo '<p>请在URL后输入用户名，例如：/user/company</p>';
}

get_footer(); // 替代wp_footer()，加载完整的主题底部
?>

4. 验证效果

现在访问http://localhost/wordpress/user/company，如果系统中存在登录名为company的用户，页面会显示该用户的档案信息；如果不存在，会提示未找到用户。

内容的提问来源于stack exchange，提问作者Mittul At TechnoBrave