WordPress/WooCommerce重写颜色变体GET参数为路径URL报404

规则失效返回404是两个问题叠加导致的：

• 仅靠.htaccess追加查询参数无法让WordPress识别路径。Apache完成重写后，WordPress的路由层依然会读取原始请求路径做内容匹配，会把路径末尾的颜色slug识别为独立的页面/文章别名，匹配不到对应内容就直接返回404，根本不会走到WooCommerce处理变体属性参数的逻辑。
• 你写的单商品固定路径规则通用性极低，没有排除WooCommerce的购物车、结账、账户中心等功能路径，既容易误匹配，只要商品分类层级变动也会直接失效。

按以下三步操作即可实现需求，规则不会被WordPress或缓存插件自动覆盖。

1. 调整.htaccess重写规则 #

打开站点根目录的.htaccess文件，删除你之前添加的那条针对trickers-wiltshire-leather-derby-shoes的单条重写规则，在# BEGIN WordPress标记的上方（不要写到WordPress动态规则块内部，否则会被覆盖）添加如下通用规则：

# WooCommerce可变商品颜色属性路径重写
RewriteCond %{REQUEST_URI} !^/shop/(cart|checkout|my-account|product-category|product-tag)/
RewriteRule ^shop/([^/]+/[^/]+/[^/]+)/([a-z0-9-]+)/?$ /shop/$1/?attribute_pa_product-color=$2 [QSA,L]

如果你的商品固定链接层级和默认的/shop/一级分类/二级分类/商品名/结构不一致，对应调整正则里的路径匹配段数即可。

2. 添加WordPress路由兼容代码 #

将下面的代码添加到当前启用主题的functions.php文件中，或者通过代码片段插件插入，作用是让WordPress正确识别带颜色后缀的商品路径，不会误判为404，同时自动把颜色属性注入到商品查询逻辑里，访问时可以直接选中对应颜色变体：

// 适配颜色属性路径的WooCommerce可变商品路由
add_filter( 'request', function( $query_vars ) {
    if ( is_admin() || !isset( $query_vars['error'] ) ) {
        return $query_vars;
    }

    $request_uri = parse_url( $_SERVER['REQUEST_URI'], PHP_URL_PATH );
    $request_path = trim( $request_uri, '/' );
    if ( strpos( $request_path, 'shop/' ) !== 0 ) {
        return $query_vars;
    }

    $path_segments = explode( '/', $request_path );
    if ( count( $path_segments ) < 4 ) {
        return $query_vars;
    }

    $color_slug = array_pop( $path_segments );
    $product_path = implode( '/', $path_segments );
    $product = get_page_by_path( $product_path, OBJECT, 'product' );

    if ( !$product ) {
        return $query_vars;
    }

    $wc_product = wc_get_product( $product->ID );
    if ( !$wc_product->is_type( 'variable' ) ) {
        return $query_vars;
    }

    $valid_colors = wp_get_post_terms( $product->ID, 'pa_product-color', [ 'fields' => 'slugs' ] );
    if ( is_wp_error( $valid_colors ) || !in_array( $color_slug, $valid_colors ) ) {
        return $query_vars;
    }

    $query_vars = [
        'post_type' => 'product',
        'name' => $wc_product->get_slug(),
        'attribute_pa_product-color' => $color_slug
    ];

    $categories = get_the_terms( $product->ID, 'product_cat' );
    if ( $categories && !is_wp_error( $categories ) ) {
        $query_vars['product_cat'] = implode( ',', wp_list_pluck( $categories, 'slug' ) );
    }

    return $query_vars;
}, 1 );

如果你自定义过颜色属性的slug，不是默认的pa_product-color，把代码和htaccess规则里对应的参数名替换成你自己的即可。

3. 刷新规则缓存 #

• 登录WordPress后台，进入「设置」-「固定链接」页面，不需要修改任何配置，直接拉到页面底部点击「保存更改」，强制刷新WordPress的重写规则缓存。
• 如果你启用了LSCache或者其他服务器/CDN缓存，清空全站缓存后再测试访问。

• 所有自定义重写规则必须放在# BEGIN WordPress标记外部，否则WordPress更新固定链接、缓存插件重置规则时会自动删除你写的自定义内容。
• 如果访问后打开了商品页但没有自动选中对应颜色变体，先检查可变商品的对应颜色属性是否已经启用「用于变体」选项，属性值slug和路径里的后缀是否完全一致。
• 如果你的站点商品路径没有二级分类，是/shop/分类/商品名/的三层结构，把htaccess规则里的正则改成^shop/([^/]+/[^/]+)/([a-z0-9-]+)/?$即可。

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