Google Safe Browsing API含测试威胁URL请求返回空响应如何解决

核心排查项 #

• 缺失必要请求头：你提交的POST请求未携带Content-Type: application/json请求头，服务端无法正确识别JSON格式的请求体，即使请求体内容正确也会返回空匹配结果，优先补充该请求头后重试。
• 平台类型匹配范围过窄：你仅指定了WINDOWS作为唯一平台类型，官方测试恶意URL的威胁标记可能覆盖全平台或其他平台类型，可将platformTypes字段值替换为["ALL_PLATFORMS"]扩大匹配范围后重试。
• URL未做规范化处理：需按照官方规则对提交的URL先做规范化操作，包括处理多余的相对路径、正确编码特殊字符、补全缺失的路径分隔符等，避免因格式不匹配导致无法命中威胁库。
• API项目配置异常：确认你使用的API密钥对应的Google Cloud项目已启用Safe Browsing API服务，仅生成密钥未启用对应API也会出现无错误提示但无返回结果的情况。
• 请求体格式异常：检查提交的JSON请求体是否存在多余不可见字符、语法错误，避免服务端解析失败返回空结果。

验证标准 #

调整请求后重新提交，若配置正确，提交http://malware.testing.google.test后会返回对应MALWARE类型的威胁匹配结果，而非空JSON对象。

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