在WP REST API中筛选ACF数组值字段的问题

我来帮你搞定这个ACF多选字段通过WP REST API筛选的问题——你遇到的核心问题是ACF多选字段的存储格式和REST查询的匹配逻辑不兼容，咱们一步步来修正：

先搞清楚ACF字段的存储方式 #

ACF的多选字段有两种存储模式：

• 序列化数组：数据库里存的是类似a:4:{i:0;s:2:"11";i:1;s:2:"12";...}的序列化字符串，这是默认选项
• 逗号分隔字符串：如果你在字段设置里勾选了「返回值 > 逗号分隔的字符串」，数据库里会存成11,12,13,14

你的API返回值是["11","12","13","14"]，说明是序列化数组模式，这也是导致你当前筛选失效的根本原因——默认的=比较符无法匹配序列化后的内容。

修正你的rest_post_query过滤器 #

首先，别直接用$_GET获取参数，WP REST API提供了更安全规范的$request对象；其次，要针对序列化数组调整查询逻辑：

方案1：筛选包含单个值的帖子 #

add_filter( 'rest_post_query', function( $args, $request ) {
    // 检查请求中是否存在ddd参数
    if ( isset( $request['ddd'] ) && !empty( $request['ddd'] ) ) {
        $target_value = esc_sql( $request['ddd'] );
        // 序列化数组里的字符串是带双引号的，所以要把目标值包在引号里
        $args['meta_query'] = array(
            array(
                'key'     => 'ddd',
                'value'   => '"' . $target_value . '"',
                'compare' => 'LIKE',
            )
        );
    }
    return $args;
}, 10, 2 );

方案2：支持多值筛选（比如同时匹配11和12） #

如果需要支持/wp-json/wp/v2/posts?ddd=11&ddd=12这种多值请求，可以改成这样：

add_filter( 'rest_post_query', function( $args, $request ) {
    if ( isset( $request['ddd'] ) && !empty( $request['ddd'] ) ) {
        // 把参数转成数组（兼容单个值和多个值的情况）
        $target_values = is_array( $request['ddd'] ) ? $request['ddd'] : array( $request['ddd'] );
        // 转义每个值并处理序列化格式
        $serialized_values = array_map( function( $val ) {
            return '"' . esc_sql( $val ) . '"';
        }, $target_values );

        $args['meta_query'] = array(
            array(
                'key'     => 'ddd',
                'value'   => $serialized_values,
                'compare' => 'LIKE',
                'relation' => 'OR', // 匹配包含任意一个目标值的帖子
                // 如果要匹配同时包含所有值的帖子，把relation改成AND即可
            )
        );
    }
    return $args;
}, 10, 2 );

测试你的请求 #

现在你可以用以下格式发起请求，就能正确筛选了：

• 单个值筛选：/wp-json/wp/v2/posts?ddd=11 或 /wp-json/acf/v3/posts?ddd=11
• 多值筛选：/wp-json/wp/v2/posts?ddd=11&ddd=12

为什么你的原代码失效？ #

1. 你用了默认的=比较符，但ACF多选数组存储的是序列化字符串，直接匹配单个值肯定找不到结果
2. 直接使用$_GET获取参数不符合WP REST API的安全规范，应该用$request对象来获取参数

内容的提问来源于stack exchange，提问作者Danilo P. da Silva