WordPress更新后按分类查询自定义文章触发PHP严重错误

DevOps 小满

2026-8-29

问题根因

裸常量触发致命错误：代码中'order' => ASC未给ASC加引号，属于未定义裸常量。PHP 7.2以下版本会自动将未定义裸常量容错解析为同名字符串，升级到高版本PHP（WordPress 6.0+默认要求PHP7.4+，推荐PHP8+）后，该容错逻辑被移除，直接抛出语法级致命错误。
ACF字段返回值无校验：get_field('category')未做合法性判断。Advanced Custom Fields的分类关联字段支持返回「分类ID、分类Term对象、分类别名」三种格式，如果字段未赋值、或配置为返回Term对象/数组时，直接拼接到WP_Query的cat参数中，会因参数类型不符合要求触发类型错误；如果自定义文章类型messages_single未注册关联内置category分类法，传入cat参数也会导致查询异常。
HTML结构不完整：循环输出的.series-item外层容器缺少闭合标签，会导致前端布局错乱。
排序逻辑不严谨：仅设置排序方式为升序，未显式指定orderby排序维度，默认按发布时间排序，可能和业务预期不符。
上下文取值兼容问题：如果这段代码放在分类归档、选项页等非单篇文章场景下，直接调用get_field()不传上下文ID，高版本ACF+WordPress环境下可能无法正确取到字段值。

修复方案

给排序常量ASC加单引号转为合法字符串参数
对ACF返回的分类字段做格式兼容，统一提取合法的分类ID，无有效分类ID时移除分类筛选条件，避免非法参数传入
补全缺失的HTML闭合标签
显式声明orderby参数，固定排序逻辑
给ACF字段调用补全上下文ID兼容，支持归档页、选项页等多场景取值
对讲者字段做空值兜底，增加输出转义符合WordPress安全规范

修复后的完整代码如下：

<?php
// 兼容不同场景下的ACF取值上下文
$context_id = get_queried_object_id();
$category_field = get_field('category', $context_id);
$cat_id = 0;
// 兼容ACF返回ID、Term对象两种格式
if (is_numeric($category_field)) {
    $cat_id = intval($category_field);
} elseif (is_object($category_field) && isset($category_field->term_id)) {
    $cat_id = intval($category_field->term_id);
}

$args = array(
    'post_type' => 'messages_single',
    'posts_per_page' => 10, 
    'orderby' => 'date', // 可根据业务需求改为title、menu_order等
    'order' => 'ASC',
    'ignore_sticky_posts' => 1,
);
// 有合法分类ID时才加分类筛选条件
if ($cat_id > 0) {
    // 如果是自定义分类法，将'cat'改为对应tax_query配置
    $args['cat'] = $cat_id;
}

$q = new WP_Query( $args );

if ( $q->have_posts() ) {
    while ( $q->have_posts() ) {
        $q->the_post(); ?>
        <div class="series-item">
            <div class="series-thumb">
                <?php if ( has_post_thumbnail() ) { ?>
                    <a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>">
                        <img src="<?php the_post_thumbnail_url( 'full' ); ?>" alt="<?php the_title(); ?>" class="zoom" />
                    </a>
                <?php } else { ?>
                    <a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>">
                        <img src="/img/image-holder.png" alt="<?php the_title(); ?>" />
                    </a>
                <?php } ?>
            </div>
            <div class="series-info">
                <h3>
                    <a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>">
                        <?php the_title(); ?>
                    </a>
                </h3>
                <div class="mspeaker">
                    <?php
                    $other_speaker = get_field('other_speaker', get_the_ID());
                    $speaker = get_field('speaker', get_the_ID());
                    if (!empty($other_speaker)) {
                        echo esc_html($other_speaker);
                    } elseif (!empty($speaker)) {
                        echo esc_html($speaker);
                    }
                    ?>
                </div>
            </div>
        </div><!-- .series-item-->
<?php    }
    wp_reset_postdata();
}
?>

补充说明：如果messages_single绑定的分类不是WordPress内置的文章分类，而是自定义分类法，需要将$args['cat']替换为tax_query数组配置，否则分类筛选不会生效。

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