Skip to content

错误与排查 ​

错误格式:{ ok: false, error: { code, message, stage } }。

HTTPcode下一步
400INVALID_REQUEST检查 JSON、分享链接、scope 和参数组合
400INVALID_FIELD_SELECTOR检查字段路径和通配符
403UPSTREAM_ACCESS_DENIED确认分享已开启且具备访问权限
404BOARD_NOT_FOUND确认画板仍存在
404NOT_FOUND检查 API 路径
405METHOD_NOT_ALLOWED解析接口使用 POST
413PAYLOAD_TOO_LARGE请求体不能超过 32 KiB
415UNSUPPORTED_MEDIA_TYPE设置 Content-Type: application/json
502UPSTREAM_REQUEST_FAILED / INVALID_UPSTREAM_RESPONSE稍后重试;检查上游是否变化
504UPSTREAM_TIMEOUT改用 root 或减少递归读取需求
500INTERNAL_ERROR使用请求 ID 和脱敏日志定位

stage 区分 request、permission、boards、parse。服务端不会返回输入分享链接、短期令牌或上游原始错误正文。

tree 部分失败时可能仍然返回 200,但 meta.complete=false。检查 warnings,不要将缺失子画板当作空内容。官方接口不提供旧快照回退。

请求耗时可在 Server-Timing 和 meta.timings 中查看。权限与画板阶段慢需要检查上游;字段精简不会缩短这些阶段。

Milanote 上游接口未公开;生产环境请做好兼容性预案。