如何在PHP中获取Facebook通知Webhook并排查接收异常？

可能的原因及修复方案 #

1. REQUEST_METHOD 判断失效 #

Facebook Webhook回调确实是POST请求，但部分服务器环境（如CGI模式、反向代理场景）下，$_SERVER['REQUEST_METHOD']可能无法正确识别请求方法。可以换一种更可靠的判断逻辑，结合请求头和请求方法双重验证：

<?php
// 替代原有的REQUEST_METHOD单一判断
$isValidPost = ($_SERVER['REQUEST_METHOD'] === 'POST') 
               && isset($_SERVER['CONTENT_TYPE']) 
               && strpos($_SERVER['CONTENT_TYPE'], 'application/json') !== false;

if ($isValidPost) {
    // 先保存原始JSON内容，避免解码失败丢失信息
    $rawJson = file_get_contents('php://input');
    // 追加写入日志，方便后续排查
    file_put_contents('callback.test.txt', $rawJson . "\n---\n", FILE_APPEND);
}
?>

2. php://input 读取为空 #

去掉判断后生成空文件，核心问题是php://input没有读取到内容，常见诱因：

• PHP配置限制：检查post_max_size、upload_max_filesize参数，确保其值大于Facebook Webhook发送的Payload大小（通常几百KB足够）。可在代码中临时输出配置值排查：

  <?php
  echo "post_max_size: " . ini_get('post_max_size') . "<br>";
  echo "upload_max_filesize: " . ini_get('upload_max_filesize') . "<br>";
  ?>
  

• POST数据被提前消耗：如果代码中提前使用了$_POST、$_REQUEST，或者服务器/框架自动解析了JSON请求体，会导致php://input的内容被耗尽。确保在读取php://input前，不要调用任何会读取POST数据的变量或函数。
• 目录写入权限不足：虽然生成了空文件，但仍需确认PHP进程对当前目录有写入权限。可临时切换到系统临时目录测试：

  <?php
  file_put_contents('/tmp/callback.test.txt', file_get_contents('php://input'), FILE_APPEND);
  ?>
  

3. Webhook订阅配置遗漏 #

确认Facebook后台的Webhook订阅字段已正确勾选（比如消息、通知等你需要捕获的事件），测试时必须使用平台提供的「发送测试事件」功能，避免自定义模拟请求的格式不符合要求。

调试技巧 #

1. 记录全量请求日志，不管请求类型：

<?php
$logContent = date('Y-m-d H:i:s') . "\n"
              . "请求方法: " . $_SERVER['REQUEST_METHOD'] . "\n"
              . "内容类型: " . $_SERVER['CONTENT_TYPE'] . "\n"
              . "内容长度: " . $_SERVER['CONTENT_LENGTH'] . "\n"
              . "原始数据: " . file_get_contents('php://input') . "\n\n";

file_put_contents('webhook_debug.log', $logContent, FILE_APPEND);
?>

通过日志可以明确Facebook是否真的发起了请求，以及请求的具体内容。
2. 检查服务器访问日志（如Apache的access.log、Nginx的access.log），确认Facebook的IP是否成功访问了回调URL，请求状态码是否为200（非200则说明服务器返回了错误，需查看PHP错误日志排查语法或运行时问题）。

内容的提问来源于stack exchange，提问作者Tech Stack by Antra