使用ACF为产品文章创建的book父分类存档页出现404错误

1. 检查内容冲突 #

• 确认站点内是否存在与分类slug（books）同名的页面、文章或自定义文章类型，这类内容会抢占分类的永久链接路径，导致父分类页404。
• 解决：修改重名内容的slug，或在ACF分类设置中调整分类的rewrite slug（换一个不冲突的名称）。

2. 验证ACF分类注册参数 #

• 检查ACF创建book分类时的设置：
  • 确保「层级」选项已勾选（支持父子分类的关键）；
  • 确认「重写」设置中的slug为books，且「使用前端基础」选项按需配置（若站点有自定义永久链接结构，建议关闭）。
• 调整后务必重新刷新永久链接：进入后台「设置→固定链接」，无需修改任何选项，直接点击「保存更改」。

3. 排查模板文件有效性 #

• 虽然使用了taxonomy-book.php，仍需确认模板是否被正确加载：
  • 在模板文件顶部添加调试代码：

    <?php echo '当前加载模板：' . basename(__FILE__); ?>
    

  • 访问父分类页，若未显示该内容，说明模板未被调用，检查模板是否放在主题根目录，命名是否完全匹配（注意大小写，Linux服务器区分大小写）。

4. 强制刷新永久链接规则 #

• 常规刷新无效时，可通过代码强制刷新：
  • 在主题functions.php中临时添加以下代码，访问任意前台页面后删除：

    flush_rewrite_rules( true );
    

  • 或在后台先切换永久链接为「朴素」格式保存，再切回原格式保存。

5. 清除缓存干扰 #

• 检查服务器缓存、CDN缓存或站点缓存插件，这类缓存可能保留了旧的404页面记录。
• 解决：清空所有层级的缓存，必要时临时禁用缓存插件后测试。

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