Stripe account.updated Webhook返回用户数据为null的问题排查

问题概述 #

• 基于React Native搭建的项目，采用Stripe Connect Express方案，按官方流程实现宿主账户注册（通过账户链接跳转浏览器完成注册流程）
• 搭建Webhook用于同步Stripe账户的charges_enabled字段，当前临时逻辑是将完整Stripe账户存入数据库（生产环境将移除该全量存储逻辑）
• 手动调用await stripe?.accounts.retrieve(user?.stripeID)能获取包含姓名、邮箱、地址等完整信息的账户对象，但Webhook触发时，返回的data.object.business_profile中大量个人信息为null
• 具体异常：关闭Webhook后，新创建的宿主在Stripe控制台能显示完整的姓名、邮箱等信息；开启Webhook后编辑姓名字段，Webhook返回的账户对象中对应个人信息变为null，导致数据库原有信息被覆盖，但银行账户、出生日期等信息未受影响

原因分析 #

1. Webhook的轻量化设计：Stripe Webhook返回的事件对象默认不会包含全部个人身份信息（PII），这类敏感字段不会在Webhook事件中传输，以此降低数据泄露风险。而accounts.retrieve是主动发起的账户查询请求，会返回账户的完整详情（包括PII，前提是你的API密钥拥有对应权限）。
2. 事件字段的增量返回特性：当触发account.updated这类事件时，Webhook仅返回发生变更的字段或部分核心字段，并非全量账户对象。如果直接用Webhook返回的对象覆盖数据库，未返回的字段会被设为null，进而覆盖原有有效数据。

解决方法 #

• Webhook触发+主动查询全量数据：不要直接使用Webhook返回的对象更新数据库，而是在Webhook接收到事件后，提取Stripe账户ID，调用await stripe?.accounts.retrieve(stripeAccountId)获取完整账户信息，再同步到数据库。这是最可靠的方案，能确保拿到所有需要的字段。
• 增量更新数据库字段：如果不想每次都发起全量查询，可在更新数据库时做判断，仅更新Webhook返回的非null字段，忽略null值字段，避免覆盖原有有效数据。例如在代码中添加条件：只有当Webhook返回的字段值不为null时，才更新数据库对应字段。
• 验证Webhook事件类型：确认你监听的Webhook事件是否匹配需求，比如是否需要针对特定的账户变更事件（如个人信息更新、状态变更）分别处理，而不是统一用全量账户覆盖逻辑。

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