用途:在遇到持续性问题、准备 Vercel 支持工单或需要团队协作排查时,收集一份完整的调试证据包,包含部署状态、函数日志、环境配置和构建输出。
主要能力:通过 Vercel CLI 与 API 收集部署检查信息(inspect.txt、deployment.json)、最近函数日志与事件时间线(function-logs.txt、events.json)、构建信息与路由函数映射(build-info.json、routes-functions.json)、环境变量名称列表(不含值)、项目配置、依赖版本、系统环境信息,以及抓取 Vercel 平台状态快照。最终打包为 vercel-debug-YYYYMMDD-HHMMSS.tar.gz 归档,便于附加到支持工单。
使用方式:需先安装并认证 Vercel CLI,具备目标部署访问权限,建议安装 jq。脚本按步骤执行:收集部署信息、函数日志、构建输出、脱敏环境状态、检查平台状态页,最后打包。示例命令包括 vercel inspect、vercel logs、vercel env ls,以及通过 curl 调用 Vercel API。
适用场景:Vercel 部署出现持续错误、函数超时、构建失败等问题时,用于整理证据并提交支持工单。
限制:环境变量值不会被采集,仅记录名称;函数日志可能因未调用或保留期过期而为空;若 VERCEL_TOKEN 未设置则无法调用 API;vercel inspect 失败可能因部署已删除或令牌过期。资料未提供具体收费、价格或平台支持范围等信息。