文件处理错误排查
排查格式不支持、体积目标未达到、文件过期、额度不足及 API 鉴权失败。
更新于
先看具体失败的规则
确认问题属于格式、大小、尺寸、PDF 页数还是命名。转换成功不等于其他接收网站一定接受，请把下载结果与该网站的最新规则逐项对照。上传失败指南提供了更详细的检查顺序。
| 现象 | 建议操作 |
|---|---|
| 格式不支持或文件损坏 | 用原应用打开并导出支持的格式。只改扩展名无效。 |
| 未达到体积目标 | 降低图片尺寸或质量；扫描 PDF 可尝试深度压缩。检查可读性，仅在超标候选也有用时使用尽力模式。 |
| PDF 被拒绝 | 检查加密、附件和活动内容。有权处理时，可从可信原应用导出普通 PDF。 |
| 额度不足 | 等每日额度恢复，或登录使用账号额度。反复重试也可能消耗次数。 |
| 文件或下载过期 | 重新上传原件并创建新任务；工具存储不是长期网盘。 |
| API 返回 401 或 403 | 检查 Bearer 密钥、工具权限与账号等级。不要把 API Key 放进公开前端代码。 |
| 异步任务还在运行 | 按返回的任务地址进行有上限的退避轮询。断线后复用原幂等键，避免重复创建任务。 |
求助时无需发送隐私原件
请给 support@attachready.com 发邮件，说明工具地址、大致发生时间、错误码、浏览器版本、文件格式和大致体积。有任务 ID 时可以附上。不要发送 API Key、密码、证件或保密附件；不含敏感信息的最小示例更适合排查。