通过WhatsApp Business调用Web Service时出现503错误求助

一、先搞定Meta请求的准入问题 #

• 服务器防火墙/WAF可能拦截了Meta的IP：WhatsApp Business的请求来自Meta官方服务器，而非用户浏览器。检查服务器防火墙、云服务商WAF的拦截规则，将Meta公布的WhatsApp Business IP段加入白名单。
• 对比请求头差异：WhatsApp的请求头和浏览器完全不同，比如User-Agent是Meta专属标识，无浏览器常规字段。如果你的Web服务有基于请求头的验证（比如防爬虫规则），很可能误判拒绝请求。去服务器日志中提取WhatsApp请求的完整头信息，和浏览器请求做对比，调整验证逻辑。

二、适配WhatsApp的资源返回规则 #

• 控制PDF生成超时：WhatsApp对请求响应的超时阈值约为10秒，如果PDF生成过程（比如从数据库拉取数据再渲染）耗时超过这个时间，会直接被判定为服务不可用并返回503。要么优化生成逻辑提速，要么改成异步生成：先给用户发送“文件正在生成，稍后发送”的消息，生成完成后主动推送给用户。
• 确认Content-Type和文件大小：必须将返回头的Content-Type设为application/pdf，不要错设为text/html或其他类型；另外WhatsApp单文件限制为100MB，超过该阈值也会触发错误。

三、服务器日志和配置深挖 #

• 紧盯访问/错误日志：直接查找WhatsApp请求对应的日志条目，确认503是Web服务本身返回的，还是反向代理（如Nginx）、负载均衡返回的。比如Nginx的error.log中如果出现connection timed out或no upstream available，说明上游服务无响应。
• 检查连接数限制：如果WhatsApp的请求并发量突然上升，超过Web服务的最大连接数配置（比如Apache的MaxClients、Nginx的worker_connections），也会返回503。可临时调大参数测试。

四、WhatsApp平台侧的配置检查 #

• 验证Webhook状态：如果是通过Webhook触发PDF服务，先确认Webhook的验证是否通过，回调URL有没有填写错误。
• 排查账号风控：新注册的WhatsApp Business账号可能有发送文件/外部链接的限制，前往Meta Business Manager查看账号是否被标记异常，或是否触发了风控规则。

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