WordPress中get_the_category返回错误分类问题求助

我之前也碰到过一模一样的坑，大概率是获取分类的方式不对或者钩子执行时机的问题，咱们一步步排查解决：

1. 先确认钩子回调是否正确接收文章ID #

publish_post钩子的第一个参数就是发布文章的ID，你的回调函数得先把这个参数接住，不然后续操作全是空谈：

add_action('publish_post', 'send_post_notification', 10, 1);
function send_post_notification($post_id) {
    // 这里写你的通知逻辑
}

2. 跳过自动保存和修订版（关键步骤！） #

有时候publish_post会在文章自动保存或者生成修订版时触发，这时候分类数据还没同步到正式的文章记录里，所以先加个判断过滤掉这些情况：

function send_post_notification($post_id) {
    // 跳过自动保存和修订版，只处理正式发布的文章
    if (wp_is_post_autosave($post_id) || wp_is_post_revision($post_id)) {
        return;
    }
    // 下面写获取分类和发送通知的代码
}

3. 用正确的方式获取文章分类 #

别依赖全局变量$category，它在publish_post的上下文里不一定指向当前发布文章的分类，必须通过文章ID主动获取：

针对默认分类法（category）的两种方法 #

方法一：用get_the_category()直接拿分类对象

$categories = get_the_category($post_id);
if (!empty($categories) && !is_wp_error($categories)) {
    // 取第一个分类的名称
    $cat_name = $categories[0]->name;
} else {
    $cat_name = 'Uncategorized';
}

方法二：先拿分类ID再取名称（更灵活）

$cat_ids = wp_get_post_categories($post_id);
if (!empty($cat_ids)) {
    $category = get_category($cat_ids[0]);
    $cat_name = $category->name;
} else {
    $cat_name = 'Uncategorized';
}

如果用的是自定义分类法 #

要是你的文章用的是自己创建的自定义分类（不是默认的category），得用wp_get_object_terms()：

// 把下面的`your_custom_taxonomy`换成你自定义分类法的slug
$terms = wp_get_object_terms($post_id, 'your_custom_taxonomy');
if (!empty($terms) && !is_wp_error($terms)) {
    $term_name = $terms[0]->name;
} else {
    $term_name = '未分类';
}

4. 调整钩子优先级（备选方案） #

要是上面的方法都没用，可能是其他插件或者主题在你之前修改了分类数据，可以把钩子的优先级调高（比如设为20，比默认的10晚执行）：

add_action('publish_post', 'send_post_notification', 20, 1);

5. 调试验证（快速定位问题） #

可以临时加个调试语句，看看获取到的分类数据到底是什么：

$categories = get_the_category($post_id);
// 开启WP_DEBUG后，日志会存在wp-content/debug.log里
error_log(print_r($categories, true));

通过日志你能直观看到是否获取到了正确的分类数组，方便排查问题。

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