用途:诊断阿里云 OSS 预签名(签名/分享)URL 失效问题,并指导 V1 到 V4 签名迁移,例如“分享链接过期”“预签名 URL 报 SignatureDoesNotMatch”“升级 SDK 后 V1 签名被禁止”“V4 URL 报 x-oss-credential 错误”等。
主要能力:本地将用户粘贴的预签名 URL 作为纯字符串解析(不发送到任何位置,密钥与签名被掩码),识别签名版本(V1 的 OSSAccessKeyId+Expires+Signature 与 V4 的 x-oss-credential+x-oss-date+x-oss-expires+x-oss-signature),提取并评估过期时间(V1 为绝对时间戳;V4 为 x-oss-date + x-oss-expires,长期 AccessKey 最长 604800 秒即 7 天,STS 临时凭证最长 43200 秒即 12 小时),再按错误码、HTTP 状态、症状或原始问句,通过内置失败模式目录路由到根因方向,并给出 V4 升级兼容性检查清单与分享链接恢复步骤。
使用方式:必须通过运行脚本进行诊断:python3 scripts/oss_presigned_url_diagnosis.py,可使用可选参数 --url、--error-code、--http-status、--symptom、--question。读取脚本输出的结构化 JSON 后据此作答;遇到 STATUS: FAIL 需按 NEXT_ACTION 向用户索要缺失输入,遇到 STATUS: DEGRADED 需先索取区分性证据再下结论。
适用场景与限制:仅诊断预签名 URL 失效与 V1→V4 迁移准备,不涉及签名算法实现、生成签名 URL、DDoS 缓解、数据恢复或退款等;不执行任何写操作、阿里云 CLI 命令或云 API,不联网抓取或探测 URL,也不需要 AK/SK/STS 凭证。若无法匹配内置目录,应如实说明并索取预签名 URL 或完整错误响应体(Code、Message、RequestId)。涉及配置或用法问题时,脚本用 --question 先匹配内置知识,再对照官方 OSS 文档验证;如验证降级为离线,需明确说明“无法对照在线官方文档(离线)”。所有签名版本规则、有效期上限、失败模式与排障步骤均以脚本输出为准,不得编造错误码、限制或文档链接。更多细节与官方来源以资料中脚本与参考模块为准。