用途：这是一个 HubSpot API 常见错误速查参考，用于诊断和修复调用 HubSpot API 时遇到的失败请求。前提是已安装 @hubspot/api-client、配置好 API 凭据并能访问应用日志。
主要能力：按 HTTP 状态码与 category 匹配错误，给出真实响应体、成因和修复方式。401 对应 INVALID_AUTHENTICATION，常见原因是缺少 Authorization: Bearer 头、OAuth 访问令牌过期（30 分钟 TTL）或私有应用令牌被撤销/重新生成。403 对应 MISSING_SCOPES，需在私有应用设置中补充缺失 scope 并重新生成令牌。409 对应 CONFLICT，如联系人已存在，可先搜索再创建或使用批量 upsert。429 对应 RATE_LIMITS，响应头含 X-HubSpot-RateLimit-Daily、X-HubSpot-RateLimit-Secondly、Retry-After，应遵守 Retry-After 并可用 SDK 的 numberOfApiCallRetries 自动重试。400 校验错误包括属性不存在（PROPERTY_DOESNT_EXIST）和无效关联类型 ID，可先列出对象属性或核对关联类型 ID。404 对应 OBJECT_NOT_FOUND，记录可能已归档，可用 archived=true 查询。
使用方式：先看 HTTP 状态码和响应体，再按 category 匹配修复。文中提供若干诊断命令，例如用 curl 检查令牌与限流头，以及 catch-all 错误处理函数，记录 message、category、correlationId 和 errors，5xx 时查看 HubSpot 状态页。
适用场景：调试 HubSpot CRM 集成、排查认证与权限、限流、属性校验、关联和归档记录问题。
限制：资料仅覆盖上述错误类型，未提供其他错误码、完整 SDK 版本要求或收费信息；具体 scope 名称与关联类型 ID 需以实际账户和官方文档为准。