Skyvern 自动化登录失败怎么排查【免费下载链接】skyvernAutomate browser based workflows with AI项目地址: https://gitcode.com/GitHub_Trending/sk/skyvern如果你的 Skyvern 自动化任务跑完后仍停在登录页或者在等待验证代码时超时第一步不是重跑而是确认失败现象。Skyvern 官方文档把登录失败归为几类常见模式凭证根本没被填入、凭证填错、2FA 代码过期或一直没收到、CAPTCHA 拦截、SSO 重定向、多步登录流程中途卡住每一类都有对应的检查命令和修复方式。本文按现象给出排查路径先看 run 状态与产物再对照失败模式然后核对凭证与 2FA 配置最后查看 AI 的决策过程。开始前需要两样东西失败 run 的run_id提交任务或启动 workflow 时返回调用 API 用的SKYVERN_API_KEY。下文命令中的$SKYVERN_API_KEY是本地环境变量YOUR_RUN_ID、YOUR_CREDENTIAL_ID、YOUR_IDENTIFIER是占位符需替换为你的实际值代码示例中出现的cred_xyz789、bp_abc123、bs_xyz789等 ID 均取自官方文档示例同样需要替换。第一步确认 run 状态与失败原因先查询 run 状态curl -X GET https://api.skyvern.com/v1/runs/YOUR_RUN_ID \ -H x-api-key: $SKYVERN_API_KEY重点看status和failure_reason两个字段。如果 run 是在 2FA 等某一步停下的失败原因本身往往就是直接线索。然后取两个关键产物。artifacts 端点支持用artifact_type过滤# 最终截图run 结束时的页面状态 curl -X GET https://api.skyvern.com/v1/runs/YOUR_RUN_ID/artifacts?artifact_typescreenshot_final \ -H x-api-key: $SKYVERN_API_KEY # 完整浏览器会话录像WebM curl -X GET https://api.skyvern.com/v1/runs/YOUR_RUN_ID/artifacts?artifact_typerecording \ -H x-api-key: $SKYVERN_API_KEYscreenshot_final用来判断 run 停在了哪个页面recording用来回看完整路径。官方文档给出的调试建议是先看最终截图确认停在哪再看录像还原怎么停到的。注意产物的signed_url会在 24 小时后过期过期后重新调用端点获取即可本地部署 Skyvern 时signed_url为null直接读取本地文件系统里的产物文件。按现象对照失败模式最终截图仍是登录页凭证没有被填入现象任务看似完成但登录从未发生最终截图是登录页。可能原因文档列出的三类credential 参数没有链接到 agent、引用了错误的credential_id、vault 连接失败。验证与修复确认 credential 存在curl -X GET https://api.skyvern.com/v1/credentials/YOUR_CREDENTIAL_ID \ -H x-api-key: $SKYVERN_API_KEY这个端点按设计只返回元数据名称、ID、用户名等永远不返回真实凭证值所以看不到密码内容属正常现象这一步是确认 ID 本身没写错。检查 agent 的参数配置确认 credential 参数链接到了 Login block。使用 Bitwarden、1Password 等 vault 时单独验证连通性确认 vault 凭证有效、collection/vault ID 正确并能独立于 Skyvern 正常访问 vault。站点提示用户名或密码无效现象自动化填入了凭证但站点页面报 Invalid username or password。可能原因vault 中存的凭证本身有误、站点期望的用户名格式不同邮箱或用户名、密码中的特殊字符引发问题。文档给出的排查顺序先用同一套凭证手动登录目标站点确认凭证本身可用。手动登录也失败问题在 vault 数据不在自动化。检查用户名格式。有些站点要邮箱有些要用户名文档给的对比示例是john.smith不行而john.smithcompany.com可以。建一个简单的测试任务验证 Skyvern 确实能取到这条 credential。在 vault 中重新录入凭证避免首尾空格这类复制粘贴错误。2FA 代码过期现象填入 TOTP 代码后报 Invalid code 或 Code expired。可能原因Skyvern 与 authenticator 之间的时钟偏差、代码在 30 秒窗口内取得太早、多字段输入耗时过长。文档给出的处理Skyvern 已自动处理时机问题当前代码剩余有效期不足 20 秒时会自动改用下一个代码因此过期通常说明链路其他环节有问题。使用推送代码模式邮件/短信转发时转发管道必须及时送达代码延迟超过 30 秒会直接过期。自托管部署要确保服务器时间经过 NTP 同步。偶发的时机问题在重试后往往会消失先重跑一次再深挖。2FA 代码一直没收到run 超时现象任务一直等待验证码最终超时。可能原因push 端点没有转发代码、totp_url返回错误、run 与 push 两侧的totp_identifier不一致。按以下顺序排查手动测试推送端点确认 Skyvern 能收到代码curl -X POST https://api.skyvern.com/v1/credentials/totp \ -H x-api-key: $SKYVERN_API_KEY \ -H Content-Type: application/json \ -d { totp_identifier: userexample.com, content: Your code is 123456, source: email }请求体中的totp_identifier和content是文档示例值替换为你自己的标识符和代码文本。确认 run 传入的totp_identifier与推送时使用的值完全一致# 两处的 totp_identifier 必须完全一致 result await client.login( credential_typeskyvern, credential_idcred_xyz789, totp_identifieruserexample.com, # ← 这里 ... ) await client.send_totp_code( totp_identifieruserexample.com, # ← 与这里一致 ... )用代码历史端点确认代码是否真的到达了curl -X GET https://api.skyvern.com/v1/credentials/totp?totp_identifierYOUR_IDENTIFIER \ -H x-api-key: $SKYVERN_API_KEY如果是Skyvern 主动轮询你的端点模式注意端点响应契约Skyvern 每 10 秒轮询一次最长 15 分钟暂无代码时返回HTTP 200加{verification_code: }不要返回 204、404 或 5xx。任何非 200 的 JSON 响应都会被视为契约违反整轮 run 都收到这类响应时run 会以OTP_TIMEOUT失败且failure_reason会报告实际收到的状态码——run 在 2FA 步骤失败时先看这个字段。登录页被 CAPTCHA 挡住现象登录页出现验证码挑战自动化被卡住。文档给出的处理手段换用住宅代理。很多 CAPTCHA 由数据中心 IP 触发result await client.run_task( urlhttps://portal.example.com/login, promptLog in to the portal, proxy_locationRESIDENTIAL, )Skyvern 的视觉模型会自动检测并尝试求解 reCAPTCHA v2/v3、hCaptcha、Cloudflare Turnstile 以及常见文本/数字图像验证码但求解没有保证遇到新型挑战或限流 IP 可能失败。复用浏览器会话或浏览器档案可以降低 CAPTCHA 触发频率站点看到的是有历史状态的浏览器而不是全新环境result await client.login( credential_typeskyvern, urlhttps://portal.example.com/login, credential_idcred_xyz789, browser_profile_idbp_abc123, )Cloudflare 等挑战会连续跳转多个验证页先把max_steps调大给求解器更多尝试机会仍不行再换RESIDENTIAL_ISP静态住宅 IP或加载曾通过该域名挑战的浏览器档案。Cloud UI 提供人工兜底进入Runs点开目标 run在浏览器流上点击Take Control手动完成验证码后释放控制权agent 会从原处继续。自托管部署不支持自动求解 CAPTCHA检测到验证码时 agent 会暂停 30 秒留给你在浏览器窗口里手动处理完成后自动继续。SSO/OAuth 重定向现象任务遇到 Sign in with Google/Microsoft 之类的 SSO 流程时失败。处理尽量改用直连凭证。SSO 流程跨多个域名自动化难度更高如果站点在 SSO 之外提供传统登录入口常在 Other login options 下面优先用它。必须走 SSO 时用浏览器会话维持认证状态首次 run 完成 SSO后续 run 复用同一会话# 首次运行完成 SSO result await client.run_task( urlhttps://portal.example.com/login, promptLog in using Google SSO, browser_session_idbs_xyz789, # 持久会话 ) # 后续运行复用已认证的会话 result await client.run_task( urlhttps://portal.example.com/dashboard, promptNavigate to reports, browser_session_idbs_xyz789, )填了用户名却进不了密码页多步登录现象任务填入用户名后无法进入密码页或漏掉后续步骤。处理调大max_steps。多步登录需要更多导航步数默认 10result await client.run_task( urlhttps://portal.example.com/login, promptLog in with my credentials, max_steps15, # 默认是 10 )用分步提示词引导流程result await client.run_task( urlhttps://portal.example.com/login, prompt 1. Enter the username and click Next 2. Wait for the password page to load 3. Enter the password and click Sign In 4. If 2FA is required, enter the code , )看录像产物确认流程具体断在哪一步。官方文档还有一条明确建议带凭证的登录流程应使用login()方法它会自动处理凭证获取和 2FArun_task()只用于不涉及凭证管理的通用自动化。查看 AI 的决策过程产物层面仍无法定位原因时检查 AI 当时的决策依据llm_request与llm_response产物理解 AI 当时在想什么llm_prompt实际发给 LLM 的指令用来验证你的提示词是否被正确理解llm_response_parsedAI 解析后提取出的动作确认它实际打算做什么screenshot_llm当时发给 LLM 的截图即AI 看到了什么。如果 AI 找不到某个元素再看visible_elements_tree产物确认该元素是否被检测到未检测到的元素可能在 iframe 里、动态加载或位于视口之外。常见错误信息速查Error含义处理FailedToGetTOTPVerificationCode向totp_url发起的 HTTP 请求失败检查端点可用性与响应格式NoTOTPVerificationCodeFound轮询超时未收到代码确认代码被推送或端点能返回代码TOTPExpiredError代码在输入过程中失效重试通常自动解决检查时机链路CredentialParameterNotFoundError引用的 credential 参数不存在核对 credential ID 与参数配置CredentialParameterParsingErrorcredential 数据解析失败检查 credential 格式是否符合预期 schemaCustomCredentialConfigurationError自定义 vault 服务配置有误核对 API base URL 与 token 设置run 以OTP_TIMEOUT失败的情况见上文2FA 代码一直没收到一节优先读failure_reason中报告的状态码。仍无法解决联系支持前准备的信息上述路径都走完后仍定位不到问题联系 Skyvern 支持时附上以下材料失败 run 的run_id该 run 的录像产物预期行为与实际行为的描述目标站点 URL如不涉密。参考文档登录失败排查处理 2FA存储凭证产物与调试CAPTCHA 与反爬检测【免费下载链接】skyvernAutomate browser based workflows with AI项目地址: https://gitcode.com/GitHub_Trending/sk/skyvern创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考