WordPress 查询未返回预期结果：如何正确筛选不存在自定义字段的帖子

本文详解为何使用 `meta_query` 查找“未设置发票号”的文章时返回空结果，并提供正确写法——应使用 `'compare' => 'not exists'` 而非 `'=' => ''`，同时提醒 post_type 命名规范与调试要点。

在 WordPress 开发中，常需基于自定义字段（post meta）筛选内容，例如查找所有状态为“已完成”但尚未填写发票号（invoice_number）的工作任务。但若直接使用 'value' => '' 配合 'compare' => '='，查询将始终返回空数组——因为该写法仅匹配已保存且值为空字符串的记录，而绝大多数情况下，未填写的字段根本未被写入数据库（即 meta 记录完全不存在）。

正确的做法是使用 NOT EXISTS 比较符，它专门用于检测某 meta key 是否从未被设置过：

$posts = get_posts(array(
    'post_type'      
=> 'job', // 注意：建议使用单数形式，如 'job'（需与注册时一致）
    'posts_per_page' => -1,
    'meta_key'       => 'job_date',
    'orderby'        => 'meta_value',
    'order'          => 'ASC',
    'tax_query'      => array(
        array(
            'taxonomy' => 'job_status',
            'field'    => 'slug',
            'terms'    => 'complete', // terms 可为字符串（单值）或数组（多值）
        ),
    ),
    'meta_query'     => array(
        'relation' => 'AND',
        array(
            'key'     => 'invoice_number',
            'compare' => 'NOT EXISTS', // ✅ 关键修正：查找 meta 不存在的帖子
        ),
    ),
));

⚠️ 注意事项：NOT EXISTS 不接受 value 参数，添加它将导致查询失效或意外行为；若你确实需要同时排除「空字符串」和「不存在」两种情况，可组合使用 NOT EXISTS 和 = ''（通过 OR 关系），但通常 NOT EXISTS 已覆盖业务场景；post_type 名称务必与 register_post_type() 中定义的一致；WordPress 官方推荐使用单数小写（如 'job' 而非 'jobs'），请确认你的自定义文章类型注册名称；调试建议：使用 WP_Query 替代 get_posts() 并启用 WP_DEBUG_LOG，或临时添加 echo $wp_query->request; 查看生成的 SQL，验证 meta 条件是否按预期编译。

综上，NOT EXISTS 是处理“字段未填写”逻辑的标准、高效且语义清晰的解决方案。掌握这一用法，可避免大量因元数据存在性误判导致的查询失败问题。