WooCommerce、WordPress更新后，woocommerce_created_customer钩子数据更新失效

你观测到的所有异常表现，本质是WordPress和WooCommerce最新版本调整了用户创建流程的执行时序与元数据写入规则，并非真的存在并发竞态：

• 重复元数据问题的来源：最新版WordPress（6.4+）对wp_insert_user()的元数据处理逻辑做了调整，不再对所有传入的核心元数据键做唯一性校验，会对first_name这类WP原生识别的键直接执行带空值的插入；同时WooCommerce核心的兼容层会在用户创建流程中，再独立写入一次空的first_name元数据。这两次写入都发生在你挂载的自定义回调执行之前，而且因为没有设置元数据唯一性标记，会直接在wp_user_meta表留下2条空值记录。等你的回调执行update_user_meta()时，函数只会更新查询到的第一条匹配记录，剩下的空值记录会和你写入的有效值并存，完全匹配你看到的“一条有效、一条空值”的数据库现象。
• 钩子写入失效的来源：最新版WooCommerce（8.0+）调整了钩子执行顺序，在触发woocommerce_created_customer和WP核心user_register钩子前，就已经完成了WC_Customer实例的初始化、核心属性的预写入，同时会自动为新用户附加默认的customer角色。所有第三方挂载在后置动作钩子里的写入逻辑，执行时机已经晚于核心流程的预写入步骤，自然会出现写入值被空值覆盖、设置的角色被自动追加customer的问题。
• 筛选钩子写入billing字段失效的来源：woocommerce_new_customer_data筛选钩子返回的参数会直接传入wp_insert_user()，但这个函数只解析WP核心内置的用户字段与原生元数据白名单，所有带billing_前缀的自定义字段根本不在解析范围内，会在参数处理阶段被直接丢弃，根本不会触发写入动作。
• 自定义测试元数据正常落库的原因：这类自定义键既不在WP核心的预写入列表，也不在WooCommerce的属性预写入列表，流程不会在你的回调执行前提前写入空值，你的update_user_meta()逻辑执行时没有前置记录冲突，自然可以正常写入。

结合调整后的流程逻辑，可以通过以下方式重构原有逻辑，从根源上解决写入失效、重复元数据、角色叠加的问题：

• 核心字段与自定义角色全部前置处理
  • 自定义角色（如customer_pending）不要放在后置动作钩子里设置，直接在woocommerce_new_customer_data筛选钩子里修改返回数组的$data['role']参数。这个字段是WP原生识别的参数，会直接被wp_insert_user()写入用户记录，后续WooCommerce初始化用户时检测到已有自定义角色，不会再自动叠加默认的customer角色，可靠性最高。
  • WP核心原生字段（如first_name）如果从注册表单获取到了有效值，直接在同一个woocommerce_new_customer_data钩子的返回数组中赋值，这样WP在创建用户的第一步就会写入正确的有效值，从根源上避免后续预写入的空值覆盖、重复记录问题。
• WooCommerce专属字段后置匹配流程时序
  • 所有billing_前缀的字段（如billing_first_name）不要放在woocommerce_new_customer_data钩子里传值，因为会被WP直接丢弃。可以在前置钩子中把获取到的表单值存到全局静态变量里，等所有核心预写入流程走完后，在woocommerce_after_customer_object_load钩子中调用update_user_meta()写入对应值。这个钩子是WC_Customer实例完全初始化完成后才触发的，此时不会有任何前置的空值写入冲突。
• 适配旧逻辑的快速调整方案
  • 如果暂时不想重构流程，也可以在原有自定义回调的最开始，先调用delete_user_meta($customer_id, 'first_name')把所有已存在的重复空值记录全部删掉，再重新写入有效值，避免update_user_meta()只更新单条记录导致的重复问题。
  • 角色设置逻辑中，在调用set_role('customer_pending')的同时，同步调用remove_role('customer')移除默认角色，避免后续WC流程自动叠加customer角色导致的权限不符合预期。

• 不要依赖update_user_meta()处理重复元数据：当数据库里同一个元数据键存在多条记录时，该函数只会更新查询到的第一条匹配记录，剩下的重复记录会长期留存，极易导致前后台读取数据时出现偶发的取值混乱。
• 不要在woocommerce_new_customer_data钩子里传任何billing_前缀的字段，这些值会被WP直接丢弃，不会产生任何写入效果，徒增排查成本。
• 不要把自定义角色的设置逻辑放在所有后置的用户创建钩子里，WooCommerce会在对象初始化时自动校验默认customer角色的存在，后置修改极易出现角色叠加的问题，优先在前置筛选阶段指定角色是最稳定的方案。

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