自定义文章类型‘articles’忽略posts_per_page，是否为保留类型？

这问题我之前帮朋友排查过类似的，大概率是自定义文章类型的注册配置或者WordPress的查询规则冲突导致的，咱们一步步来拆解：

一、先排查CPT注册的核心参数 #

你用CPT UI创建articles类型时，有几个关键参数很容易踩坑：

• query_var设置：如果这个参数被设为和WordPress内置变量（比如post、page）重名，或者你不小心设成了article（少了s），会导致WP_Query无法正确识别你的自定义类型，进而忽略分页参数。去CPT UI的编辑页面，检查Query Var字段是不是准确设为articles。
• rewrite规则冲突：如果rewrite里的Slug设置和现有页面/文章的slug重复，或者勾选了With Front但你的固定链接前缀和它冲突，会打乱WordPress的查询解析逻辑。建议暂时关闭rewrite（或者设一个独一无二的slug），刷新固定链接后测试posts_per_page是否生效。
• has_archive配置：如果开启了归档但没正确设置归档页面的查询规则，也可能影响单页查询的分页参数。可以先把has_archive设为false测试。

二、检查WP_Query的代码写法 #

确认你写的WP_Query参数里，post_type是不是准确写的'articles'（别漏了s），比如：

$args = array(
    'post_type' => 'articles',
    'posts_per_page' => 5, // 这里的数值是不是被覆盖了？
    'post_status' => 'publish'
);
$query = new WP_Query($args);

另外，有没有其他地方用pre_get_posts钩子修改了查询参数？比如主题的functions.php或者某个插件里，可能写了针对特定post_type的分页修改，刚好命中了articles。可以临时注释掉这类钩子代码测试。

三、刷新固定链接规则 #

WordPress的自定义文章类型依赖固定链接规则来解析查询，很多时候CPT注册后没刷新规则会导致各种查询异常。去后台「设置-固定链接」页面，随便选一个不同的规则（比如从「文章名称」改成「简单」）保存，然后再改回原来的规则保存一次，强制刷新规则缓存。

四、关于你修改数据库的临时测试 #

你把3条记录改成article但没注册对应CPT，WordPress会默认把这些帖子归为post类型（因为找不到匹配的自定义类型），这时候如果用post_type => 'post'查询，posts_per_page应该是正常的，但这只是临时测试，还是得回到articles类型的根源问题上。

五、排查主题/插件冲突 #

切换到WordPress默认主题（比如Twenty Twenty-Four），然后禁用所有第三方插件，只保留CPT UI，再测试WP_Query的分页参数。如果这时候正常了，说明是某个主题或插件的代码干扰了查询。

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