自定义WordPress主题非首页跳转404.php问题求助

我来帮你搞定这个问题！根据你描述的细节——纯文本固定链接正常，但用/%postname%/模式时除了首页全跳404，且默认主题完全没问题，核心原因大概率是切换自定义主题后，WordPress的重写规则缓存没跟上，或者主题缺少必要的基础逻辑支持。下面是一步步的排查和解决方法：

1. 先强制刷新固定链接规则（最可能解决问题） #

这是我遇到这类问题时的第一招，切换主题后WordPress的重写规则经常会“卡壳”：

• 登录WP后台，进入「设置」→「固定链接」
• 啥都不用改，直接点「保存更改」按钮就行
• 这一步会强制WP重新生成.htaccess文件（只要服务器权限允许），同时更新重写规则的缓存

2. 检查模板文件的基础逻辑（排除隐性问题） #

你已经有archive.php、404.php这些文件，但可以再确认下模板的基础结构没问题：

• 每个模板都正确调用了get_header()和get_footer()（你贴的代码看起来没问题，但再核对一遍总没错）
• 给archive.php加个基础循环试试，有时候WP会因为模板里没有有效内容误判：

<?php get_header(); ?>
<div class="archive-container">
    <h1><?php the_archive_title(); ?></h1>
    <?php if ( have_posts() ) : 
        while ( have_posts() ) : the_post(); ?>
            <article class="archive-post">
                <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
                <?php the_excerpt(); ?>
            </article>
        <?php endwhile; 
    else : ?>
        <p><?php esc_html_e( '暂无内容哦', 'your-theme-slug' ); ?></p>
    <?php endif; ?>
</div>
<?php get_footer(); ?>

3. 手动验证.htaccess文件的正确性 #

哪怕你说没发现异常，也可以检查下根目录的.htaccess内容是否符合WP标准：

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

如果文件不存在，手动创建一个，粘贴上面的内容，然后把权限设为644（确保服务器能读写）

4. 确认服务器的重写模块是否开启 #

/%postname%/这种固定链接依赖服务器的重写功能：

• 要是用Apache，通过phpinfo()查看mod_rewrite是否启用
• 要是用Nginx，得在站点配置里加这段规则，然后重启Nginx：

location / {
    try_files $uri $uri/ /index.php?$args;
}

5. 检查functions.php和引入的文件有没有语法错误 #

你的functions.php只引入了scripts.php，确认scripts.php里的wp_enqueue_scripts钩子没写错，比如：

function my_theme_load_scripts() {
    wp_enqueue_style( 'my-theme-style', get_stylesheet_uri() );
}
add_action( 'wp_enqueue_scripts', 'my_theme_load_scripts' );

语法错误会导致主题加载异常，间接影响重写规则的生效

按这个顺序排查，先试第一步，大概率就能解决。我之前做自定义主题也碰到过好几次，基本都是固定链接没刷新的锅。

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