WordPress自定义主题异常：Artists类型文章固定链接跳转至首页模板

• 检查自定义文章类型注册参数
  确认注册artists时的关键参数是否正确设置：

  • publicly_queryable必须设为true，否则WordPress不会识别该类型的单篇文章查询
  • rewrite参数的slug不要和现有页面/分类的slug冲突，with_front可设为false避免继承固定链接的前缀
    示例注册代码片段：

  register_post_type( 'artists', array(
      'public' => true,
      'publicly_queryable' => true,
      'rewrite' => array( 'slug' => 'artists', 'with_front' => false ),
      'has_archive' => true,
      // 其他必要参数（labels、supports等）
  ) );
  

• 排查front-page.php的自定义查询逻辑
  检查主题的front-page.php是否存在错误的全局查询修改，比如误用query_posts()后未调用wp_reset_query()，或者用WP_Query时覆盖了全局$wp_query对象，导致所有请求都被强制使用首页的查询规则。

• 禁用插件排查干扰
  暂时禁用所有第三方插件（尤其是SEO、路由管理、缓存类插件），测试是否恢复正常。部分插件可能会修改WordPress的路由解析逻辑，导致自定义文章类型的单页请求被错误路由。

• 验证服务器重写规则

  • Apache环境：确认主题根目录的.htaccess文件包含WordPress默认的重写规则，且文件权限正确（可被服务器读取）
  • Nginx环境：检查站点配置中是否添加了正确的重写规则，确保所有非文件/目录的请求都转发到index.php

• 确认模板文件的正确性

  • 检查single-artists.php是否存在于当前激活主题的根目录下
  • Linux服务器注意文件名大小写，确保文件名完全匹配（比如Single-Artists.php会被识别为错误文件）

• 调试实际加载的模板
  在主题的functions.php中添加以下代码，查看当前请求实际加载的模板路径：

  add_filter( 'template_include', function( $template ) {
      die( '当前加载模板：' . $template );
  } );
  

  点击文章链接后，页面会显示实际加载的模板路径，以此确认是否被强制跳转到front-page.php。

• 排查自定义钩子的影响
  检查主题functions.php或自定义插件中是否使用了template_redirect、parse_request等钩子，这些钩子可能会修改请求的路由逻辑，强制将自定义文章类型的请求重定向到首页。

• 确认文章状态
  检查目标文章是否处于“发布”状态，私密/草稿状态的文章可能会被WordPress重定向，不过这种情况通常会跳转到登录页，但仍可排除此可能性。

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