用途:诊断阿里云 OSS 上传/下载失败,例如 403 AccessDenied、SignatureDoesNotMatch、RequestTimeout、EntityTooLarge、SlowDown、409 BucketAlreadyExists 等。做法是把用户报告的错误码、HTTP 状态与操作,经内置官方错误码目录映射到根因方向(权限、凭证/签名、客户端网络、工具用法、文件限制、服务端),区分客户端与服务端责任,并给出排障步骤及网络优化/传输加速建议。
主要能力:内置官方错误码目录与基于 472 个真实工单提炼的排障阶梯;支持错误码模糊匹配、EC 数字别名与 SDK 堆栈名路由;支持仅凭症状措辞给出候选方向;带非 OSS 产品(SSH、MySQL、RDS、CDN、k8s 等)越界拦截;可选 --question 触发官方文档校验(仅 help.aliyun.com,3 天缓存)。
使用方式:必须运行入口脚本,禁止仅凭自由推理诊断:python3 scripts/oss_transfer_error_diagnosis.py --error-code <code> [--http-status <n>] [--request-id <rid>] [--bucket <b>] [--operation <op>] [--question "<客户原话>"]. 读取其结构化 JSON 与 STATUS/NEXT_ACTION 后作答。退出码:0 为 OK 或 DEGRADED,1 为 FAIL(缺输入),2 仅 argparse 用法错误。
限制:零云 API 调用、只读,不做网络探测,不读写桶或对象,不需要也不接受 AK/SK/STS;不得编造错误码、限制或文档链接;不处理 DDoS 沙箱缓解、数据恢复、退款、预签名 URL 生成;结论建议的变更操作由客户自行执行。资料未提供具体价格与平台支持范围。