自定义主题分类与标签页出现404错误求助

从你描述的情况来看，既然切换到Twenty Seventeen主题一切正常，那问题肯定出在你的自定义主题里，咱们一步步来排查：

1. 先检查category.php和tag.php的代码 #

这两个文件是分类和标签页的优先模板，但现在它们反而导致跳404，大概率是文件本身有问题：

• 打开这两个文件，看看有没有强制跳404的代码，比如类似 wp_redirect(get_404_template()); 或者 include(get_404_template()); 的语句，不小心加了这种代码会直接触发404。
• 检查文件里的循环逻辑，比如有没有正确写 if ( have_posts() ) : 开头的循环，如果循环条件写错或者没有正确调用主查询，WordPress会认为这个页面没有内容，自动跳404。
• 可以做个快速测试：把archive.php里的内容完整复制到category.php和tag.php里，然后刷新分类/标签页，如果正常显示了，那说明原文件的代码逻辑有问题，需要逐行排查错误。

2. 排查主题functions.php里的自定义逻辑 #

很多主题会用钩子修改查询或模板加载，这也可能导致404：

• 看看有没有使用 pre_get_posts 钩子修改分类/标签的查询，比如错误地设置了 $query->set('post_type', '不存在的类型')，导致查询返回空结果，触发404。
• 检查有没有 template_include 钩子，强行把分类/标签页的模板指向404.php。
• 有没有用 query_posts 覆盖主查询？这个函数很容易破坏原有的查询逻辑，导致分类/标签页找不到内容。

3. 确认模板文件的命名和位置 #

别小看基础问题，有时候就是这么简单：

• 确认category.php和tag.php在主题根目录下，不是放在子文件夹里（比如/template/这类目录，WordPress不会自动识别）。
• 检查文件名拼写：有没有写成 categories.php 或者 tags.php？WordPress对模板文件名是严格匹配的，差一个字母都不行。

4. 解释移除404.php后的异常现象 #

当你删掉404.php后，页面能加载archive.php但标题显示“页面未找到”、body带error404类，这是因为WordPress的主查询已经判定这是404页面，只是找不到404.php才 fallback到archive.php。这说明核心问题是分类/标签的查询没有返回任何内容，导致WordPress认为页面不存在。
你可以在archive.php开头加几行调试代码，看看查询状态：

var_dump(is_category()); // 分类页应该返回true
var_dump(is_tag()); // 标签页应该返回true
var_dump($wp_query->found_posts); // 应该返回该分类/标签下的文章数量

如果found_posts是0，那就是查询出了问题；如果是正常数字但is_category()/is_tag()返回false，那说明模板判断逻辑有问题。

5. 最后补充调试技巧 #

• 开启WordPress调试模式：在wp-config.php里设置 define('WP_DEBUG', true);，刷新分类/标签页，看看有没有报错信息，很多时候错误提示会直接告诉你问题出在哪一行。
• 检查服务器的错误日志：如果WP_DEBUG没给出足够信息，服务器日志里可能会有更详细的404触发原因（比如重写规则的问题，但你已经刷新过固定链接，这个可能性较低）。

总的来说，问题根源就在你的自定义主题模板或函数代码里，按照上面的步骤排查，应该能很快找到问题所在。

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