一次调用没有得到预期正文，可能发生在网络、接口参数或生成结果层。把这些情况统统写成“模型不好用”，会让重试与排查失去方向。
先看请求是否被正常处理
保留不含秘密的状态码、错误类型、时间和请求标识。认证失败、配额不足和临时服务错误需要不同处理。不要将完整密钥或私人输入附在错误报告里，也不要对明确无效的参数持续重试。
再看结果状态而非只读文本
请求成功之后，仍应按接口文档查看候选、结束原因及相关限制信息。空文本、截断和无法完成任务不是同一个状态。遇到内容限制，应调整任务到合法、允许的用途，不通过编码或更换说法绕过保护。
为界面准备明确反馈
自拟文章生成工具可分别显示需要修正配置、稍后重试或保留未完成草稿，而不是统一显示成功。只有结果完整且通过业务校验后才发布。记录实际已完成的阶段，能避免用户误以为等待中的任务已经交付。
资料与继续学习
Google：API故障排查。资料查阅日期：2026年9月30日。步骤与练习由本站整理。
资料查阅与编辑日期：2026年9月30日。作者：玖柒。
© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
