WordPress REST API结合Ajax使用时无法排除指定文章

看起来你遇到的问题是自定义REST端点（mx/v1/posts）没有正确处理exclude参数——毕竟默认的wp/v2/posts端点会自动处理这个参数，但自定义端点需要我们手动配置参数支持并在查询中应用它。下面是具体的排查和解决步骤：

1. 检查自定义REST路由的注册代码 #

首先，你需要确保在注册mx/v1/posts这个自定义端点时，已经声明了exclude参数是可接受的，并且在回调函数里把这个参数传递给WP_Query。

比如，正确的路由注册应该类似这样：

add_action( 'rest_api_init', function () {
  register_rest_route( 'mx/v1', '/posts', array(
    'methods' => 'GET',
    'callback' => 'mx_get_custom_posts',
    'args' => array(
      // 声明exclude参数，允许传入数字或数组
      'exclude' => array(
        'description' => '排除指定ID的文章',
        'type' => array( 'integer', 'array' ),
        'items' => array( 'type' => 'integer' ),
        'sanitize_callback' => 'absint',
        'validate_callback' => function( $param, $request, $key ) {
          return is_numeric( $param ) || ( is_array( $param ) && all_is_numeric( $param ) );
        }
      ),
    ),
  ) );
} );

2. 在回调函数中应用exclude参数 #

接下来，在处理请求的回调函数里，需要把exclude参数传递给WP_Query的post__not_in参数：

function mx_get_custom_posts( $request ) {
  $args = array(
    'post_type' => 'post', // 根据你的需求调整文章类型
    'post_status' => 'publish',
  );

  // 获取exclude参数并应用到查询
  $exclude = $request->get_param( 'exclude' );
  if ( ! empty( $exclude ) ) {
    // 如果是单个ID，转成数组
    if ( is_numeric( $exclude ) ) {
      $exclude = array( $exclude );
    }
    $args['post__not_in'] = array_map( 'absint', $exclude );
  }

  $query = new WP_Query( $args );
  $posts = array();

  if ( $query->have_posts() ) {
    while ( $query->have_posts() ) {
      $query->the_post();
      // 按照你的需求格式化返回的文章数据
      $posts[] = array(
        'id' => get_the_ID(),
        'title' => get_the_title(),
        'content' => get_the_content(),
      );
    }
    wp_reset_postdata();
  }

  return rest_ensure_response( $posts );
}

3. 小细节：检查Ajax请求的拼写 #

另外注意你的Ajax代码里datatype应该是**dataType**（首字母大写），虽然这可能不是导致exclude失效的直接原因，但可能会影响JSON数据的解析：

$.ajax({ 
  url: queryUrl, 
  dataType: 'json', // 修正大小写
  success: function(data, textStatus, request) { 
    console.log(data); 
  } 
});

为什么默认端点能生效？ #

默认的wp/v2/posts端点是WordPress内置的，它已经在注册时就支持了exclude参数，并且内部会自动把它映射到WP_Query的post__not_in，但自定义端点需要我们自己完成这个映射逻辑。

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