WordPress WP_Query 中如何正确查询未设置自定义字段值的文章

本文详解为何使用 `meta_query` 查询空字符串（`''`）无法匹配未设置自定义字段的 wordpress 文章，并提供标准解决方案：改用 `'compare' => 'not exists'` 精确筛选尚未填写字段的条目。

在 WordPress 开发中，常需通过 WP_Query 或 get_posts() 查询满足特定元数据条件的文章（如“已完成但尚未开具发票”的工单）。但一个常见误区是：将“字段未填写”等同于“字段值为空字符串”。实际上，当用户从未在后台为某篇文章保存过 invoice_number 字段时，该 post meta 记录根本不存在于数据库中；此时 meta_key = 'invoice_number' AND meta_value = '' 的 SQL 条件将完全不匹配——因为连这条记录都没有。

因此，原代码中：

array(
  'key'   => 'invoice_number',
  'value' => '',
  'compare' => '='
)

应替换为更语义准确、数据库友好的写法：

array(
  'key'     => 'invoice_number',
  'compare' => 'NOT EXISTS'
)

✅ 正确完整的查询示例（适配您的需求）：

$posts = get_posts(array(
    'post_type'      => 'jobs', // 注意：请确认注册的 post_type 名称是否确为复数 'jobs'；按 WordPress 官方惯例建议使用单数如 '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'
        )
    )
));

⚠️ 注意事项：

• 'NOT EXISTS' 是 WordPress 3.5+ 引入的标准比较符，无需 value 参数，直接判断 meta 记录是否存在；
• 若需同时支持“字段不存在”或“字段存在但为空字符串/0/null”，可组合使用 'OR' 关系及多个子句（如 NOT EXISTS + = ''），但本场景仅需前者；
• 始终验证 post_type 名称是否与 register_post_type() 中定义的一致（例如 'job' 而非 'jobs'），否则查询将返回空结果；
• 排序依赖 meta_value 时，确保 job_date 字段已对所有目标文章统一存入且格式一致（推荐使用 Y-m-d 标准格式以保障 ASC/DESC 可靠性）。

总结：区分「字段未设置」（NOT EXISTS）与「字段设为空值」（= ''）是编写健壮 WordPress 元查询的关键。善用 NOT EXISTS 不仅逻辑清晰、性能更优，还能避免因数据缺失导致的静默失败。