更新文章时将标题同步至RankMath SEO关键词失败排查

存在的问题 #

• 钩子参数不匹配：publish_post钩子仅传递1个参数（$post_id），但你在add_action中声明了接收3个参数（最后一个参数3），这会导致函数无法正确执行，甚至抛出参数数量不匹配的警告。
• 钩子覆盖场景不全：publish_post仅在文章首次发布时触发，无法覆盖已发布文章编辑更新的场景，不符合你“更新文章时同步”的需求。
• 缺乏必要的安全校验：没有排除自动保存、修订版本的情况，可能导致重复执行或无效操作；也未检查文章标题是否为空的边界情况。
• 直接操作元数据的风险：RankMath有自身的字段验证逻辑，直接用update_post_meta修改可能绕过内部处理，导致数据不兼容。

修复后的代码 #

/**
 * 自动将文章标题同步为RankMath SEO的焦点关键词
 */
function update_rankmath_focus_keyword( $post_id ) {
    // 排除自动保存、修订版本和非文章类型
    if ( wp_is_post_autosave( $post_id ) || wp_is_post_revision( $post_id ) || get_post_type( $post_id ) !== 'post' ) {
        return;
    }

    // 获取文章标题并转为小写
    $post_title = strtolower( get_the_title( $post_id ) );
    if ( empty( $post_title ) ) {
        return;
    }

    // 使用RankMath内置函数设置焦点关键词（推荐）
    if ( function_exists( 'rank_math_update_post_meta' ) ) {
        rank_math_update_post_meta( $post_id, 'focus_keyword', $post_title );
    } else {
        // 降级方案：直接更新元数据
        update_post_meta( $post_id, 'rank_math_focus_keyword', $post_title );
    }
}

// 使用save_post钩子，覆盖所有文章保存/更新场景，回调仅接收1个参数
add_action( 'save_post', 'update_rankmath_focus_keyword', 10, 1 );

修复说明 #

• 修正钩子参数：save_post钩子传递1个参数，add_action最后一个参数设为1，与函数参数数量匹配。
• 替换为合适的钩子：save_post在文章创建、更新、发布时都会触发，完全覆盖“更新文章同步”的需求。
• 添加安全校验：排除自动保存、修订版本，只针对文章类型（post）执行，避免无效操作。
• 使用RankMath内置函数：rank_math_update_post_meta是RankMath官方提供的更新元数据的函数，能确保符合插件内部逻辑，避免数据异常；如果函数不存在则降级为直接更新元数据，保证兼容性。

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