如何阻止WooCommerce在商品归档页自动添加属性至li类以提速

这个问题我之前帮客户排查过，确实是WooCommerce的默认行为拖了后腿——它会自动把产品的所有属性（包括自定义属性）添加到产品列表的<li>标签类中，而每个属性的获取都会触发2次独立的MySQL查询，当你产品多、属性多的时候，查询量会爆炸式增长。

下面给你几个可行的解决方法，按需选择：

1. 彻底禁用属性类的自动添加 #

如果你的主题不依赖这些属性类做样式，这是最直接的解决方案，能完全消除这部分额外查询。把下面的代码加到子主题的functions.php或者自定义插件里：

// 阻止WooCommerce在产品li标签上添加属性类
add_filter( 'woocommerce_product_class', '__return_empty_array' );

或者更精准地移除WooCommerce负责添加这些类的回调函数（效果一致，更直观）：

// 移除WooCommerce添加产品属性类的核心函数
add_action( 'init', function() {
    remove_filter( 'post_class', 'woocommerce_post_class' );
}, 20 );

2. 选择性保留必要的类（仅移除自定义属性类） #

如果你的主题需要保留分类、标签、库存状态这些默认类，但不需要自定义属性（以pa_开头的类），可以用过滤函数只删掉这些自定义属性类：

// 过滤掉产品li标签中的自定义属性类（pa_开头的类）
add_filter( 'woocommerce_product_class', 'custom_clean_product_list_classes', 10, 3 );
function custom_clean_product_list_classes( $classes, $product, $args ) {
    // 只保留非pa_开头的类
    return array_filter( $classes, function( $class ) {
        return strpos( $class, 'pa_' ) !== 0;
    } );
}

3. 预加载属性以减少查询（如果必须保留属性类） #

如果你的业务或样式必须保留这些属性类，那可以通过预加载所有产品的属性元数据，避免逐个产品逐个属性查询。下面的代码会让WooCommerce在分类页主查询时一次性加载所有产品的属性数据：

// 预加载分类页产品属性，减少MySQL查询
add_action( 'woocommerce_product_query', 'preload_product_attributes_for_category_pages' );
function preload_product_attributes_for_category_pages( $query ) {
    // 仅在前台分类页执行
    if ( ! is_admin() && $query->is_main_query() && is_product_category() ) {
        // 让查询同时获取产品属性元数据
        $query->set( 'meta_query', array_merge(
            $query->get( 'meta_query', array() ),
            array( array( 'key' => '_product_attributes', 'compare' => 'EXISTS' ) )
        ) );
    }
}

注意事项 #

• 样式测试：修改代码后一定要检查前端页面的样式是否正常，有些主题可能会用这些属性类做筛选或样式渲染，避免出现布局问题。
• 缓存加持：解决查询问题后，建议启用页面缓存（比如WooCommerce自带的缓存或第三方缓存插件），进一步提升页面加载速度。
• 代码维护：尽量把代码放在子主题或自定义插件中，避免主题更新后代码丢失。

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