开发与 AI 故障排查

常见问题复制标题链接

分阶段定位 AI 请求复制标题链接

1. 提交前：输入是否有效，所选模型是否仍启用。
2. 认证与校验：会话、所有权、端点策略和版本是否通过。
3. 额度预留：平台服务是否开放，余额是否可覆盖请求。
4. 供应商调用：协议、模型 ID、超时与结构化能力。
5. 结果校验：字段完整性、HTML 清理和事实引用。
6. 保存与结算：版本冲突、D1 写入、实际用量与退款。

不要把全部失败都当成“模型不稳定”。稳定错误码能帮助判断是否应重试；图片创建中断不应自动再次创建。

调试信息复制标题链接

记录请求阶段、错误码、耗时与资源 ID，避免记录模型密钥、完整简历和供应商认证头。跨账户问题使用两个测试账户验证，不能只靠隐藏按钮判断权限。

继续阅读API 错误边界、计费与AI 验证矩阵。