用途：该技能是 PostHog 常见错误的快速参考，帮助定位并修复最常见的十类 PostHog 错误与异常，适用于遇到 PostHog 报错、调试失败请求或排查集成问题的场景。
前提条件：已安装 PostHog SDK、已配置 API 凭证、可访问错误日志。
使用方式：第一步，在日志或控制台中查看错误消息与错误码；第二步，将错误与文档中记录的案例进行匹配；第三步，按对应错误的解决步骤操作。输出为已识别的错误原因、已应用的修复以及验证后的解决结果。
覆盖的错误案例：认证失败（Authentication error: Invalid API key），原因是 API 密钥缺失、过期或无效，可用 echo $POSTHOG_API_KEY 验证密钥是否已设置；速率限制超限（Rate limit exceeded. Please retry after X seconds.），原因是短时间内请求过多，解决方案为实现指数退避，可参考 posthog-rate-limits 技能；网络超时（Request timeout after 30000ms），原因是网络连接或服务器延迟问题，可通过增大超时时间解决，例如 const client = new Client({ timeout: 60000 });。
快速诊断命令：curl -s https://status.posthog.com 检查 PostHog 状态；curl -I https://api.posthog.com 验证 API 连通性；env | grep POSTHOG 检查本地配置。
升级路径：使用 posthog-debug-bundle 收集证据，查看 PostHog 状态页，携带请求 ID 联系支持。
限制：资料仅列出上述三类错误的具体信息，其余常见错误未提供细节；未提供收费、价格、平台或效果等信息。