WordPress调用get_terms()返回Invalid Taxonomy错误排查

返回Invalid Taxonomy错误的核心原因是：调用get_terms()时，目标自定义分类法alumns-reps-states还没有完成注册，不存在于WordPress全局分类法列表中。结合你贴的代码，90%以上的场景是调用时序错误导致的：

• 你的分类法注册代码挂载在init钩子、默认优先级10的位置执行，如果你把get_terms()代码直接写在functions.php顶层、插件根文件全局作用域、或者执行时机早于init钩子默认优先级的位置，代码运行时分类法还没被注册，自然识别失败。
• 少数情况是第一次注册分类法后没有刷新WordPress重写缓存，或者注册代码被条件判断拦截、没有在你调用get_terms()的场景下执行。
• 可以先通过下面的代码确认分类法注册状态，排除拼写错误、代码未加载的问题：

global $wp_taxonomies;
var_dump( array_key_exists( 'alumns-reps-states', $wp_taxonomies ) );
// 返回bool(true)才代表分类法注册完成

• 调整get_terms()的执行时机：不要在全局作用域直接调用该函数，把查询分类项的逻辑挂载到晚于分类法注册的钩子上，比如wp_loaded（所有WordPress初始化逻辑跑完后触发），或者init钩子优先级设为20（晚于默认优先级10的注册逻辑），示例代码：

add_action( 'wp_loaded', function() {
    $state_terms = get_terms( array(
        'taxonomy'   => 'alumns-reps-states',
        'hide_empty' => false,
    ) );
    // 在这里写分类项遍历、输出逻辑
    if ( !is_wp_error( $state_terms ) ) {
        foreach ( $state_terms as $term ) {
            echo $term->name;
        }
    }
} );

• 如果是在主题模板文件（比如page.php、single.php、自定义页面模板）中调用，不需要额外挂载钩子，正常放在模板内容输出位置即可——模板加载时WordPress已经完成了init阶段的所有注册逻辑，不会出现时序问题。
• 代码部署完成后，进后台「设置-固定链接」页面，直接点击底部「保存更改」按钮（不需要修改任何配置），刷新WordPress的自定义类型缓存和重写规则，排除缓存导致的识别异常。
• 排查注册逻辑的生效范围：如果你的分类法注册代码加了is_admin()之类的条件判断，要确保前台访问时注册逻辑也会执行，不要只在后台页面注册分类法。

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