WooCommerce订阅结账自定义起始日期、计费频率不生效排查

• 常规post_meta更新方式完全失效的根源：WooCommerce Subscriptions的核心订阅参数（起始时间、计费周期、关联扣款日期）根本不存储在普通WordPress的post_meta表，它有专属的结构化存储层，订阅对象加载时会直接从专属存储读值，通过update_post_meta写入_schedule_start、_billing_interval等内置键的内容，会在实例化流程中被直接覆盖，插件根本不认这套写入值。
• 时机错误导致所有修改被覆盖的根源：
  • woocommerce_checkout_update_order_meta钩子触发时，订阅已经完成全流程创建、核心参数已经入库，此时修改参数既不会触发订阅定时计划的同步调整，写入的元值也会被插件的存储校验逻辑过滤。
  • wcs_create_subscription钩子触发时，订阅对象的所有核心参数已经完成初始化、关联流程已经走完，此时修改_schedule_start等内置字段，不会触发参数的重新校验和入库。
  • woocommerce_checkout_create_subscription钩子触发时，插件会在钩子执行完成后，自动从产品配置中拉取默认的日期规则、计费规则覆盖订阅对象值，开发者在钩子里通过update_dates硬编码的自定义参数，会被后续的产品默认值同步逻辑直接冲掉，这就是自定义参数不生效的核心原因。
• AJAX改产品参数完全失效的根源：WCS的计费规则是最后绑定在生成的订阅实例上的，而非全局产品配置。通过AJAX实时修改全局产品的内置元字段，一来会把产品默认配置改乱，所有进入结账页的用户都会看到被改动的参数；二来结账页的价格计算从加载完成开始就使用缓存的产品参数，根本不会实时读取动态修改的全局值，自然无法同步用户的选择。
• 日期校验报错的根源：WCS的update_dates方法有严格的依赖校验，仅修改起始日期不联动更新关联的next_payment、trial_end等派生日期时，就会触发“The next_payment date must occur after the start date”的一致性校验报错。

• 钩子选择上，替换为订阅参数计算阶段的woocommerce_checkout_calculate_subscription钩子，这个钩子的触发时机是订阅对象已创建、但还未同步产品默认配置、未执行最终入库校验的节点，此时修改参数不会被后续流程覆盖。
• 参数获取逻辑：从结账提交的POST数据中直接读取两个下拉框的原始值，不绕订单元数据、产品元数据中转：
  • 解析计费周期选项：周付对应billing_period=week、billing_interval=1；双周付对应billing_period=week、billing_interval=2；月付对应billing_period=month、billing_interval=1
  • 解析起始日期选项：将用户选择的固定日期转为UTC时间戳，匹配WCS的日期存储格式
• 订阅参数设置逻辑：直接调用订阅对象的公开方法设置参数，跳过会被覆盖的post_meta写入流程：
  • 调用$subscription->set_start_date( $user_selected_timestamp )设置用户选择的起始时间
  • 调用$subscription->set_billing_period( $parsed_period )、$subscription->set_billing_interval( $parsed_interval )设置用户选择的计费频率
  • 调用$subscription->recalculate_total_offsets()自动生成符合插件校验规则的关联派生日期（next_payment、trial_end、end_date等），无需手动硬编码设置关联日期，从根源上避免日期校验报错。
• 自定义值留存：将用户选择的原始选项值通过$subscription->add_meta_data( $meta_key, $meta_value )存入订阅自定义元字段，这类自定义键不会被插件的核心参数覆盖逻辑影响，可用于后续订单对账、用户端展示。

• 禁止在结账流程中通过AJAX修改全局产品的内置计费、日期元字段，会污染全站产品的默认配置，影响所有访客的结账流程。
• 不要在订单元数据更新的钩子中修改核心订阅参数，这类时机修改的参数不会同步调整订阅关联的定时扣款计划，会导致实际扣款时间和订阅展示规则不匹配。
• 不要手动硬编码设置next_payment、trial_end等派生日期，WCS有独立的时区偏移、扣款窗口匹配逻辑，手动设置的日期极易和定时任务的执行时间错位，引发漏扣、重复扣款的问题。

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