Facebook Leadgen Webhook空数组值问题：PHP应用双账户对接异常求助

我之前也碰到过类似的跨账户Webhook数据不一致的问题，咱们一步步拆解排查：

1. 先锁定问题根源：原始数据是否为空？ #

你现在直接把POST数据转成数组，但首先得确认Facebook到底有没有推送数据过来。先临时加个日志记录原始输入：

// 先记录原始POST内容，别直接转数组
$rawInput = file_get_contents("php://input");
file_put_contents('webhook_debug.log', date('Y-m-d H:i:s') . " Raw Data:\n" . $rawInput . "\n\n", FILE_APPEND);

// 再做解析
$input = json_decode($rawInput, true);

如果日志里Raw Data是空的，那问题出在Facebook的推送环节；如果有内容但转成数组为空，那就是JSON解析的锅。

2. 对比两个账户的Webhook配置细节 #

把异常账户的配置和正常账户逐一核对：

• 订阅字段：确认是否勾选了leadgen字段，有时候重新配置时容易漏选或者没点保存。
• API版本：两个账户的Webhook是不是用了同一个Graph API版本？不同版本的推送格式可能有差异，尽量保持一致。
• 验证令牌：虽然验证通过了，但偶尔会出现令牌配置不一致的情况，再核对下代码里的令牌和Facebook后台的是否完全匹配。

3. 检查异常账户的权限与关联关系 #

• 应用权限：异常账户的页面是否给了应用pages_show_list和leadgen_retrieval权限？权限过期或者未正确授权的话，Facebook会停止推送有效数据。
• 表单关联：确认异常账户的线索表单是不是绑定到了关联你应用的页面上？有时候表单是在其他页面创建的，没和当前应用关联的页面绑定，导致数据推不出来。

4. 排查服务器端的接收限制 #

• 请求大小限制：检查php.ini里的post_max_size和upload_max_filesize，如果异常账户的线索表单字段多、数据量大，可能超过服务器限制导致请求被截断，转成数组就为空了。
• 安全拦截：服务器上的防火墙、Cloudflare规则或者CMS安全插件，是不是把Facebook的推送请求拦截了？可以临时关闭测试，或者把Facebook的官方IP段加入白名单。

5. 用Facebook测试工具验证 #

去Facebook开发者后台的Webhook设置里，用测试工具手动给异常账户推送一条leadgen测试事件，看看服务器能不能收到正常数据：

• 如果测试能收到，那可能是实际用户提交时的特殊情况（比如表单提交异常、Facebook临时推送故障）；
• 如果测试也收空数据，那肯定是配置环节出了问题。

6. 排查JSON解析的潜在问题 #

如果原始数据有内容但json_decode返回空，加个错误日志看看具体原因：

$input = json_decode($rawInput, true);
if (json_last_error() !== JSON_ERROR_NONE) {
    file_put_contents('json_error.log', date('Y-m-d H:i:s') . " 解析错误：" . json_last_error_msg() . "\n原始数据：" . $rawInput . "\n\n", FILE_APPEND);
}

常见的问题是编码不兼容（比如非UTF-8字符）或者数据格式损坏，根据错误提示再针对性修复。

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