WordPress WP_Query 是否存在元查询子句最多5个的数量限制？

问题现象 #

当前触发规则非常明确：

• 仅当查询同时满足 post_status = publish、meta_query 包含 source_clause（匹配 _sourcename = AHA）时，返回空结果
• 只要满足以下任一调整，查询即可正常返回：
  • 将 post_status 改为 draft
  • 移除 meta_query 中的 source_clause 子句
• 已核验数据库存在符合所有查询条件的对应数据

传入 WP_Query 的原始参数 #

Array
(
    [post_type] => post
    [post_status] => Array
        (
            [0] => publish
        )

    [meta_query] => Array
        (
            [view_count_clause] => Array
                (
                    [key] => _viewcount
                    [type] => NUMERIC
                )

            [actual_date_clause] => Array
                (
                    [key] => _actualdate
                )

            [start_date_clause] => Array
                (
                    [key] => _actualdate
                    [value] => 2021-03-23 00-00-00
                    [compare] => >
                )

            [end_date_clause] => Array
                (
                    [key] => _actualdate
                    [value] => 2021-03-24 00-00-00
                    [compare] => <
                )

            [color_clause] => Array
                (
                    [key] => _color
                    [type] => NUMERIC
                    [compare] => IN
                    [value] => Array
                        (
                            [0] => 4
                        )
                )

            [source_clause] => Array
                (
                    [key] => _sourcename
                    [value] => AHA
                    [compare] => =
                )
        )

    [orderby] => Array
        (
            [actual_date_clause] => DESC
        )
)

排查与修复步骤 #

1. 先验证底层数据匹配性 #

你提到已核验数据库，但 compare => = 是精确字符串匹配，需先排除隐形数据问题：

• 检查 _sourcename 值是否存在前后空格、大小写差异（如数据库存为 ' AHA ' 或 'aha' 都会导致匹配失败）
• 确认同一篇 post 没有多条 _sourcename 记录（wp_postmeta 允许同 post 同 meta_key 多条数据，只要有一条值不是 AHA 就会被过滤）

可直接用原生 SQL 验证是否存在符合条件的 published 文章，排除 WP_Query 层的问题：

SELECT p.ID, p.post_status, pm.meta_value 
FROM wp_posts p
INNER JOIN wp_postmeta pm ON p.ID = pm.post_id
WHERE p.post_type = 'post'
AND p.post_status = 'publish'
AND pm.meta_key = '_sourcename'
AND pm.meta_value = 'AHA'

如果这条 SQL 查不到数据，说明之前的数据库核验存在遗漏，修正 meta 值或对应 post 状态即可。

2. 修复重复 meta_key 导致的 JOIN 冲突 #

你在 meta_query 中连续 3 次使用 _actualdate 作为 meta_key，部分 WordPress 版本会对重复 meta_key 生成别名冲突的 JOIN 语句，导致结果被错误过滤。同时你的日期值用破折号做时分秒分隔，不符合标准 datetime 格式，会引发比较逻辑异常。

调整后的标准化 meta_query 配置示例：

'meta_query' => [
    'relation' => 'AND', // 显式声明默认 AND 关系，避免歧义
    'view_count_clause' => [
        'key' => '_viewcount',
        'type' => 'NUMERIC',
    ],
    'actual_date_clause' => [
        'key' => '_actualdate',
        'type' => 'DATETIME',
    ],
    'start_date_clause' => [
        'key' => '_actualdate',
        'value' => '2021-03-23 00:00:00', // 修正时分秒分隔符为标准冒号
        'compare' => '>',
        'type' => 'DATETIME',
    ],
    'end_date_clause' => [
        'key' => '_actualdate',
        'value' => '2021-03-24 00:00:00', // 修正时分秒分隔符为标准冒号
        'compare' => '<',
        'type' => 'DATETIME',
    ],
    'color_clause' => [
        'key' => '_color',
        'type' => 'NUMERIC',
        'compare' => 'IN',
        'value' => [4],
    ],
    'source_clause' => [
        'key' => '_sourcename',
        'value' => 'AHA',
        'compare' => '=',
    ],
],

3. 排除钩子隐形过滤 #

如果以上调整后仍有问题，可临时禁用所有插件、切换为默认主题，排查是否有 pre_get_posts 钩子给 post_status = publish 的查询添加了未声明的 meta 过滤条件。

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