WordPress自定义文章类型无法通过REST API访问求助

针对你遇到的自定义文章类型line无法通过REST API访问的问题，以下是逐一排查的步骤和解决方法：

1. 确认REST端点是否已注册 #

首先访问你的站点根目录下的/wp-json/，在返回的JSON数据中搜索是否存在"wp/v2/line"相关的端点。如果没有找到，说明自定义文章类型的注册过程存在问题。

2. 检查关联分类法的REST设置 #

你在注册自定义文章类型时关联了workplace分类法，若该分类法未开启REST支持，可能导致自定义文章类型的REST端点无法正常注册。请确保workplace分类法的注册代码包含show_in_rest参数：

function register_workplace_taxonomy() {
    $args = array(
        'label' => 'Workplace',
        'show_in_rest' => true, // 必须开启此选项
        'hierarchical' => true,
        'rewrite' => array('slug' => 'workplace'),
    );
    register_taxonomy('workplace', 'line', $args);
}
add_action('init', 'register_workplace_taxonomy');

3. 刷新重写规则 #

即使固定链接已设置为"文章名称"，注册自定义文章类型后仍需手动刷新重写规则：

• 进入WordPress后台 → 设置 → 固定链接
• 无需修改任何设置，直接点击保存更改即可完成重写规则刷新

4. 排查权限与角色设置 #

虽然你设置了capability_type为post，但可能当前用户角色没有对应权限：

• 使用管理员账号直接访问/wp-json/wp/v2/line测试是否能正常返回数据
• 若需要开放给普通用户，可在注册参数中明确权限配置：

'capabilities' => array(
    'edit_post' => 'edit_post',
    'read_post' => 'read_post',
    'delete_post' => 'delete_post',
),
'map_meta_cap' => true,

5. 检查插件冲突 #

安全插件、REST路由相关插件可能拦截或覆盖自定义端点：

• 暂时禁用所有非必要插件（仅保留WPCode Lite）
• 重新测试REST端点是否可访问，若恢复正常则逐一排查插件

6. 简化代码测试 #

将自定义文章类型代码简化为最基础版本，排查是否存在参数冲突：

function my_custom_line_post_type() {
    $args = array(
        'public' => true,
        'show_in_rest' => true,
        'label' => 'Line Managers',
        'rest_base' => 'line',
    );
    register_post_type('line', $args);
}
add_action('init', 'my_custom_line_post_type', 10);

若简化后可正常访问，再逐步添加原代码中的supports、taxonomies等参数，定位冲突点。

7. 检查函数名与执行顺序 #

• 避免函数名重复：将Custom_post_type改为更独特的名称（如fs_register_line_manager_cpt）
• 调整钩子优先级：尝试修改add_action的优先级参数，比如add_action('init', 'fs_register_line_manager_cpt', 9);（提前执行）

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