本文详解如何在 woocommerce 用户首次登录时精准跳转至指定页面（如地址确认页），并修复常见语法错误、变量作用域混淆及钩子执行时机问题，确保 `update_user_meta` 正确更新状态且重定向立即生效。

在 WooCommerce 中为新注册客户实现“首次登录跳转”是提升用户体验的重要环节（例如引导填写收货地址、完善资料或完成实名认证）。但许多开发者会遇到重定向失效、用户元数据未更新或 PHP 报错等问题——根源常在于钩子选择不当、变量命名错误或逻辑结构缺陷。

以下是一套经过验证、稳定可靠的实现方案：

✅ 核心要点说明

• 使用 woocommerce_login_redirect 过滤器（而非 init 或 wp_login）：它专为登录后重定向设计，接收 $redirect 和 $user 参数，执行时机恰在身份验证成功后、页面跳转前，完美兼顾重定向与元数据操作。
• 严格区分 $user_id 与 $id：函数内 $user->ID 是当前登录用户的 ID，而原代码中误用未定义的 $user_id 变量调用 update_user_meta()，将导致致命错误（Undefined variable）。
• 状态字段命名建议使用语义化键名（如 has_logged_in_before），值推荐布尔型（true/false）或整数（0/1），避免字符串比较带来的潜在风险。

✅ 修正后的完整代码（可直接集成至主题 functions.php 或专用插件）

// 新用户注册时标记“尚未首次登录”
function after_user_register( $user_id ) {
    update_user_meta( $user_id, 'has_logged_in_before', false );
}
add_action( 'user_register', 'after_user_register', 10, 1 );

// 登录时检查并执行首次跳转
function wc_custom_user_redirect( $redirect, $user ) {
    // 仅对 customer 角色生效
    if ( ! in_array( 'customer', (array) $user->roles ) ) {
        return $redirect;
    }

    $user_id = $user->ID;
    $shop_url = get_permalink( wc_get_page_id( 'shop' ) );
    $confirm_address_url = get_permalink( get_page_by_title( 'Conferma Indirizzo' ) );

    // 检查是否首次登录
    $has_logged_in = get_user_meta( $user_id, 'has_logged_in_before', true );

    if ( $has_logged_in === false || $has_logged_in === '0' || $has_logged_in === '' ) {
        // 更新状态为“已登录过”，防止重复跳转
        update_user_meta( $user_id, 'has_logged_in_before', true );
        return $confirm_address_url; // 首次跳转目标页
    }

    return $shop_url; // 非首次登录，返回商品页
}
add_filter( 'woocommerce_login_redirect', 'wc_custom_user_redirect', 10, 2 );

⚠️ 注意事项与最佳实践

• 页面存在性校验：get_page_by_title() 在多语言或缓存环境下可能不稳定，生产环境建议改用 get_page_by_path('conferma-indirizzo') 或直接使用页面 ID（如 get_permalink(123)）提升健壮性。
• 权限与安全性：确保目标页面（如“Conferma Indirizzo”）对已登录客户可见，且无额外访问限制逻辑干扰跳转。
• 调试技巧：临时添加 error_log("Redirecting user {$user_id}: " . print_r($has_logged_in, true)); 到函数中，配合 WP Debug 日志快速定位状态读取异常。
• 兼容性提示：该方案兼容 WooCommerce 6.0+ 及 WordPress 5.8+；若使用旧版 WooCommerce，请确认 wc_get_page_id('shop') 返回有效 ID（部分主题可能需手动设置 Shop 页面）。

通过以上实现，您将获得一个零错误、高可靠性、易于维护的首次登录重定向机制——既满足业务流程引导需求，又符合 WordPress 最佳编码规范。