Google Calendar API订阅通知时出现400 ParseError问题求助

首先明确：无论是普通Gmail账户还是Workspace账户，将primary作为calendarId是完全合法的，不会直接触发ParseError，这个字段不是导致问题的直接原因。

以下是针对偶发400 ParseError的常见排查方向和解决方法：

• 请求参数编码/格式问题
  偶发错误大概率和$address或$token的内容有关。如果这两个参数包含未正确编码的特殊字符（比如空格、&、"等），Google API在解析请求体时会触发ParseError。
  解决：确保$address是经过URL编码的合法webhook地址，$token如果是自定义字符串，避免包含未转义的特殊字符；如果是JSON格式的token，要确保是严格符合JSON规范的字符串。

• Channel ID重复冲突
  Google要求每个watch请求的id必须全局唯一，虽然文档说明重复ID会替换旧的通知渠道，但实际场景中如果短时间内重复使用同一个ID，可能偶发导致请求解析异常。
  解决：每次创建watch请求时生成全新的唯一ID，比如用uuid_create()或PHP的uniqid()结合随机字符串生成。

• Google PHP客户端库版本问题
  旧版本的Google PHP客户端库可能存在对象序列化的bug，偶发导致请求体格式错误，触发ParseError。比如某些版本在序列化Google_Service_Calendar_Channel对象时，会遗漏字段或生成不符合API要求的JSON格式。
  解决：将google/apiclient包升级到最新稳定版，排查是否有已知的序列化问题修复记录。

• Workspace账户的域安全限制
  部分Workspace管理员可能配置了API调用的安全策略（比如限制webhook的域名、启用API网关过滤等），导致请求被篡改或拦截，间接引发解析错误。
  解决：对触发错误的Workspace用户，建议联系管理员检查是否有针对Calendar API或webhook的限制策略，确保你的webhook地址在允许列表内。

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