woocommerce_get_checkout_url钩子失效问题排查与求助

问题场景 #

尝试通过woocommerce_get_checkout_url过滤器钩子修改WooCommerce的结账URL，但始终无法生效。简化调试代码后，仅能看到基础日志输出，钩子关联的函数日志完全没有记录。已排查以下内容：

• 清除了所有缓存
• 仅保留WooCommerce插件和默认主题启用
• 当前WordPress版本为6.5

测试代码如下：

error_log('Log is working');

function custom_checkout_test() {
    error_log('Custom checkout filter executed.');
}
add_filter('woocommerce_get_checkout_url', 'custom_checkout_test', 10, 1);

后续尝试了带返回值的版本，仍然无效：

function custom_checkout_url( $checkout_url ) {
    // Log that the function is being called
    error_log( 'Custom checkout URL function called. Redirecting to Google.com.' );

    // Redirect to Google.com
    $new_checkout_url = 'https://www.google.com';
    return $new_checkout_url;
}
add_filter( 'woocommerce_get_checkout_url', 'custom_checkout_url', 10, 1 );

排查方向与最终解决 #

除常规的缓存、钩子优先级/参数检查外，重点排查主题对结账URL的调用方式：

• 检查主题中生成结账链接的代码，确认是否调用了wc_get_checkout_url()函数（该函数会触发woocommerce_get_checkout_url钩子）
• 若主题直接硬编码了结账URL（如/checkout/），则不会触发钩子

最终原因 #

使用的TwentyTwentyFour默认主题未通过wc_get_checkout_url()获取结账URL，而是直接硬编码了链接地址，导致钩子无法被触发。

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