WP_Query日期meta_query筛选自定义文章fixtures无返回结果排查

问题排查与修复方案 #

你遇到的问题主要来自以下几个可复现的错误点，按优先级排查即可：

• 需求与代码逻辑不一致
  你要筛选未来2周的赛事，但代码里的时间范围仅设置了未来7天，超出7天的赛事本身不会被命中，修改时间计算逻辑即可：

// 把原来的+7 day改为+14 day
$time_next_week = strtotime('+14 day', $time_now);

• 查询参数被第三方钩子篡改导致仅返回前10条
  你虽然设置了posts_per_page => -1要求返回所有匹配结果，但如果主题、其他插件挂载了pre_get_posts钩子，强制修改了自定义文章类型的查询条数（WordPress默认全局分页条数是10），就会导致仅返回前10条结果，甚至覆盖你的查询条件。
  修复方法是在查询参数中加入禁止过滤器修改的配置：

$args = array(
  'post_type' => 'fixtures',
  'posts_per_page' => -1,
  'suppress_filters' => true, // 新增这行，屏蔽第三方钩子对本次查询的修改
  // 剩余原有参数保持不变
);

• 时间字段存储格式与查询格式不匹配，导致补充数据后无返回
  如果你的fixture_kickoff自定义字段存储的是Unix时间戳（纯数字格式），而非Y-m-d H:i:s格式的字符串，用DATETIME类型做区间查询会完全匹配不到结果。
  如果确认字段存储的是时间戳，修改对应查询配置：

// meta_query中的时间条件改为
array(
  'key' => 'fixture_kickoff',
  'compare' => 'BETWEEN',
  'value' => array($time_now, $time_next_week), // 直接传入时间戳数值
  'type' => 'NUMERIC'
),
// 同时修改排序相关参数
'orderby' => 'meta_value_num',
'meta_type' => 'NUMERIC'

• 时区偏差导致匹配结果异常
  原生PHP的date()函数默认读取服务器时区，如果你的赛事开赛时间是按WordPress站点设置的时区存储，会存在数小时的时间差，导致本该命中的赛事被过滤。改用WordPress内置的时间函数即可对齐时区：

// 替换原来的时间获取逻辑
$date_now = current_time('Y-m-d H:i:s');
$time_now = current_time('timestamp');

• HTML结构冗余优化
  你当前的代码在循环内每次都输出<ul>标签，会生成大量冗余结构，建议把<ul>移到循环外部：

if( $fixturesLoop->have_posts() ): ?>
<ul>
<?php
  while ( $fixturesLoop->have_posts() ) : $fixturesLoop->the_post(); ?>
  <li><?php the_title(); ?></li>
<?php endwhile; ?>
</ul>
<?php else : ?>
<p>There are no tickets on sale at the moment. Check back at least 7 days before the next home game.</p>
<?php endif; wp_reset_postdata(); ?>

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