SuperAPI AI 工具集

apify-common-errors

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:这是一个 Apify 常见错误的快速诊断参考技能,帮助开发者在 Actor 运行失败或 API 调用报错时,从错误信号定位到具体原因并应用修复。

主要能力:覆盖十类常见错误,包括 Actor 运行 FAILED、TIMED-OUT、429 限流、401 未授权、构建失败、代理连接失败(502)、反爬拦截(403/Captcha)、内存溢出、数据集推送过大(413)以及 Actor 未找到(404)。每类错误都给出原始签名、原因、诊断方法和可直接复制的修复方案,完整目录位于 references/error-reference.md。

使用方式:先捕获精确错误,从运行状态或 API 响应中取得 Status/StatusMessage 或 ApifyApiError 消息与 HTTP 代码;再匹配错误签名,在表格中找到对应条目并查阅参考文件;随后先诊断再改代码,运行失败时通过 API 或 Console 拉取日志;最后应用修复、重新运行并用诊断命令确认恢复。

前置条件:需要将 Apify API token 导出为 APIFY_TOKEN,可访问 Apify Console 查看运行与构建日志,PATH 中需有 curl 和 jq,apify CLI 可选。

诊断命令示例:curl -s https://api.apify.com/v2/health | jq '.';curl -s -H "Authorization: Bearer $APIFY_TOKEN" https://api.apify.com/v2/users/me | jq '.data.username';npm list apify-client apify crawlee 2>/dev/null;curl -s -H "Authorization: Bearer $APIFY_TOKEN" "https://api.apify.com/v2/acts/USER~ACTOR/runs?limit=1&desc=true" | jq '.data.items[0] | {status, statusMessage, startedAt, finishedAt}'。

错误处理参考:400 修复输入参数;401 检查 token;403 检查权限;404 核实资源 ID;408 可退避重试;413 减小批量;429 与 500+ 由客户端自动重试。

适用场景:Apify Actor 项目调试、API 集成排错、代理与反爬问题处理。限制:资料未提供具体收费、价格或平台支持范围等信息。