如何正确格式化IP地址以避免Meta Conversions API报错？

针对你遇到的error_subcode:2804007无效IP报错，结合你的情况，从以下几个方向排查解决：

• 获取真实用户IP（而非代理/CDN IP）
  如果你的网站使用了Cloudflare、Nginx反向代理、负载均衡等服务，$_SERVER['REMOTE_ADDR']拿到的是代理服务器的IP，而非用户真实公网IP——这类代理IP可能被Meta判定为无效。你需要通过转发头获取真实IP：

  function getValidUserIp() {
      // 优先取Cloudflare转发的真实IP（如果用了Cloudflare）
      if (!empty($_SERVER['HTTP_CF_CONNECTING_IP'])) {
          $ip = $_SERVER['HTTP_CF_CONNECTING_IP'];
      }
      // 通用反向代理转发头
      elseif (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
          // X-Forwarded-For可能包含多个IP，第一个是用户真实IP
          $ipList = explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']);
          $ip = trim($ipList[0]);
      }
      // fallback到REMOTE_ADDR
      else {
          $ip = $_SERVER['REMOTE_ADDR'];
      }
      return $ip;
  }
  $ipAddress = getValidUserIp();
  

  注意：如果使用X-Forwarded-For，要在服务器端配置只信任可信代理的转发头，防止IP伪造。

• 过滤无效/私有IP
  Meta不接受内网私有IP（如192.168.x.x、10.x.x.x）或保留IP段，你需要在发送前验证IP有效性：

  function isValidPublicIp($ip) {
      // 验证IP格式，同时排除私有/保留IP段
      return filter_var(
          $ip,
          FILTER_VALIDATE_IP,
          FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE
      ) !== false;
  }
  
  $ipAddress = getValidUserIp();
  // 如果是无效IP，跳过发送该字段
  if (!isValidPublicIp($ipAddress)) {
      $ipAddress = null;
  }
  

• 清除隐形字符
  即使var_dump显示IP正常，仍可能存在不可见控制字符（如UTF-8 BOM、换行符），可以在发送前清理：

  $ipAddress = trim($ipAddress, "\x00..\x1F\x7F");
  

• 确认字段位置正确
  确保IP字段放在user_data对象的client_ip_address键下，而非其他错误字段。正确的payload结构示例：

  $payload = [
      'user_data' => [
          'client_ip_address' => $ipAddress,
          'client_user_agent' => $_SERVER['HTTP_USER_AGENT'] // 建议同时发送UA，提升匹配率
      ],
      // 其他转化必填字段...
  ];
  

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