ACF orderby日期排序异常：无头WP REST API排序问题求助

我之前也碰到过类似的情况——用无头WP REST API搭配ACF自定义字段时，标题排序正常，但其他字段尤其是日期字段排序结果混乱。分享几个亲测有效的排查和解决方法：

1. 先确认ACF日期字段的存储格式 #

ACF日期字段默认是YYYYMMDD的字符串格式，这种格式的字符串排序逻辑和日期逻辑是一致的。但如果你的字段设置了其他格式（比如MM/DD/YYYY），数据库会按字符串规则排序，自然会出现混乱：

• 进入ACF字段编辑页，把存储格式和返回格式都改成YYYYMMDD或YYYY-MM-DD
• 如果已经有存量数据，需要批量更新这些字段的存储值到标准格式（可以用ACF的批量编辑工具或者自定义脚本处理）

2. 核对meta_key的正确性 #

ACF字段在数据库里的存储键是不带下划线的字段名（比如你的日期字段叫publish_date，存储键就是publish_date，带下划线的_publish_date是字段配置信息）。一定要确保你用的filter[meta_key]是正确的字段名，比如：

?filter[meta_key]=publish_date&filter[order]=DESC

3. 放弃默认filter参数，自定义REST排序规则 #

WP REST API的默认filter参数对自定义字段的支持本来就有限，容易出现不稳定的情况。推荐通过代码注册专门的排序参数，更可靠：

// 给你的自定义文章类型添加支持ACF字段排序的参数
add_filter('rest_{your_post_type}_collection_params', function($params) {
    // 替换成你的ACF日期字段名，比如publish_date
    $params['orderby']['enum'][] = 'publish_date';
    return $params;
});

// 处理排序逻辑
add_filter('rest_{your_post_type}_query', function($args, $request) {
    $orderby = $request->get_param('orderby');
    // 匹配你的ACF字段名
    if ($orderby === 'publish_date') {
        $args['meta_key'] = 'publish_date';
        // 如果是YYYYMMDD格式，用meta_value_num更精准；YYYY-MM-DD用meta_value即可
        $args['orderby'] = 'meta_value_num';
        $args['order'] = $request->get_param('order') ?: 'ASC';
    }
    return $args;
}, 10, 2);

把{your_post_type}替换成你的自定义文章类型slug，之后就可以用更简洁的参数排序：

?orderby=publish_date&order=DESC

4. 排查插件冲突 #

有时候其他REST API插件、ACF扩展插件会干扰排序逻辑。可以暂时禁用非必要插件，只保留ACF和你的过滤插件，测试排序是否正常，再逐个启用插件排查冲突源。

5. 给自定义字段添加数据库索引 #

如果数据量较大，没有索引的自定义字段排序可能会因为数据库查询缓存或排序算法问题出现不稳定。可以给对应字段添加索引：

-- 替换wp_postmeta为你的数据库表前缀，publish_date为你的ACF字段名
CREATE INDEX wp_postmeta_meta_key_publish_date ON wp_postmeta (meta_key, meta_value) WHERE meta_key = 'publish_date';

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