WordPress REST API orderby=rand参数失效：返回重复帖子而非随机内容

问题概述 #

需求：通过WordPress REST API获取站点随机帖子
失效请求示例：

https://example.com/wp-json/wp/v2/posts?per_page=1&orderby=rand

预期行为：每次API调用返回不同的随机帖子
实际行为：多次调用始终返回同一篇帖子

已完成的排查 #

• 调整per_page参数（1、5、10）搭配orderby=rand，问题依旧
• 测试带认证/不带认证的请求，结果一致
• 停用所有插件后问题仍然存在
• 短时间内多次调用API，返回内容无变化
• 在全新WordPress实例测试该端点，问题复现

环境配置：

• WordPress版本：最新版
• 已发布帖子数：344+
• 使用标准REST API，无自定义修改

当前临时方案 #

客户端先获取多篇帖子再随机选择：

fetch('https://example.com/wp-json/wp/v2/posts?per_page=20&orderby=id')
     .then(response => response.json())
     .then(posts => {
const randomPost = posts[Math.floor(Math.random() * posts.length)];
// 使用randomPost
     });

疑问解答与解决方案 #

1. orderby=rand 是否存在已知失效问题？ #

是，这是广泛存在的问题，原因是WordPress REST API默认会缓存查询结果，orderby=rand的查询结果也会被缓存，导致后续请求直接返回缓存内容，无法生成新的随机结果。

2. 是核心Bug还是配置问题？ #

不是核心Bug，是WordPress为了REST API性能设置的默认缓存策略导致的。REST API会缓存查询参数对应的结果，rand查询的结果被缓存后，不会重新执行随机排序逻辑。

3. 获取真正随机帖子的推荐方式 #

以下是三种可行的解决方案：

方案一：临时禁用rand查询的缓存（后端代码修改）

在主题的functions.php中添加以下代码，检测到orderby=rand时临时禁用查询缓存：

add_filter( 'rest_post_collection_params', 'disable_rest_rand_cache' );
function disable_rest_rand_cache( $params ) {
    if ( isset( $params['orderby'] ) ) {
        $params['orderby']['sanitize_callback'] = function( $value ) use ( $params ) {
            if ( $value === 'rand' ) {
                add_filter( 'wp_cache_results', '__return_false' );
            }
            return sanitize_key( $value );
        };
    }
    return $params;
}

修改后，原请求URL即可正常返回随机帖子。

方案二：自定义REST API端点（更灵活）

注册一个自定义端点专门返回随机帖子，避免默认缓存影响：

add_action( 'rest_api_init', 'register_random_post_endpoint' );
function register_random_post_endpoint() {
    register_rest_route( 'custom/v1', '/random-post/', array(
        'methods' => 'GET',
        'callback' => 'get_random_post',
        'permission_callback' => '__return_true', // 根据实际需求调整权限
    ) );
}

function get_random_post( $request ) {
    $args = array(
        'post_type' => 'post',
        'post_status' => 'publish',
        'posts_per_page' => 1,
        'orderby' => 'rand',
        'no_found_rows' => true, // 提升性能，无需计算总帖子数
    );
    $query = new WP_Query( $args );
    if ( $query->have_posts() ) {
        return rest_prepare_post( $query->posts[0], $request );
    }
    return new WP_Error( 'no_posts', '未找到随机帖子', array( 'status' => 404 ) );
}

使用方式：请求https://example.com/wp-json/custom/v1/random-post/即可获取随机帖子。

方案三：添加随机参数绕过缓存（无需后端修改）

在原请求URL后添加一个每次变化的参数（如时间戳），让服务器认为是新请求，避免命中缓存：

https://example.com/wp-json/wp/v2/posts?per_page=1&orderby=rand&_t=1699999999

客户端可以动态生成时间戳作为参数，示例代码：

const timestamp = Date.now();
fetch(`https://example.com/wp-json/wp/v2/posts?per_page=1&orderby=rand&_t=${timestamp}`)
  .then(response => response.json())
  .then(post => {
    // 使用返回的随机帖子
  });

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