Amazon_img/TROUBLESHOOTING.md

故障排查指南

查询超时问题诊断

如果遇到"查询超时，已查询XX次"的问题，请按以下步骤排查：

1. 检查任务ID是否正确

症状：查询时返回404错误或任务未找到

解决方法：

• 查看控制台输出的"完整响应数据"，确认任务ID是否正确获取
• 检查任务ID的类型和格式（应该是数字）
• 确认生图接口返回的响应格式是否符合预期

调试命令：

# 运行时会输出完整的API响应，检查任务ID字段
npm start

2. 检查API响应格式

症状：查询返回的数据格式不符合预期

解决方法：

• 查看控制台输出的"完整API响应"
• 确认 data.code 是否为 200
• 确认 data.data.status 是否存在
• 确认 data.data.image_url 字段名称是否正确

常见问题：

• API响应格式可能已更新，需要调整代码中的字段名
• 某些情况下 image_url 可能是 imageUrl 或其他名称

3. 检查图片生成状态

症状：状态一直显示"排队中"或"生成中"，从未变为"成功"

可能原因：

1. 图片生成时间过长：高分辨率（2K/4K）或复杂prompt需要更长时间
2. API服务繁忙：排队任务较多
3. 任务实际已失败：但状态未更新为失败

解决方法：

• 增加 MAX_QUERY_COUNT 到 180 或更高
• 增加 QUERY_INTERVAL 到 10000（10秒）
• 检查API服务状态
• 尝试降低图片分辨率（使用1K而不是2K）

4. 检查API密钥和权限

症状：返回401或403错误

解决方法：

• 确认 .env 文件中的 API_KEY 正确
• 检查API密钥是否过期
• 确认账户余额是否充足
• 检查API密钥是否有查询接口的权限

5. 检查网络连接

症状：请求超时或网络错误

解决方法：

• 检查网络连接
• 确认可以访问 https://api.wuyinkeji.com
• 检查防火墙设置
• 尝试增加请求超时时间

6. 手动测试API

使用curl测试查询接口：

# 替换 YOUR_API_KEY 和 TASK_ID
curl -X GET "https://api.wuyinkeji.com/api/img/drawDetail?id=TASK_ID" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json;charset:utf-8;"

使用curl测试生图接口：

curl -X POST "https://api.wuyinkeji.com/api/img/nanoBanana-pro" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json;charset:utf-8;" \
  -d '{
    "prompt": "test prompt",
    "imageSize": "1K",
    "aspectRatio": "1:1"
  }'

7. 查看详细日志

代码已增强日志输出，运行时会显示：

• ✅ 任务提交时的完整响应
• ✅ 每次查询的详细状态
• ✅ 每10次查询的完整API响应
• ✅ 所有错误信息

关键日志位置：

1. 任务提交后：查看"完整响应数据"，确认任务ID
2. 查询过程中：查看"查询结果详情"，确认状态值
3. 错误时：查看"完整错误响应"，了解具体错误原因

8. 常见错误码说明

错误码	说明	解决方法
200	成功	-
400	请求参数错误	检查请求参数格式
401	认证失败	检查API密钥
403	权限不足	检查API密钥权限
404	任务未找到	检查任务ID是否正确
500	服务器错误	稍后重试或联系API服务商

9. 推荐配置

对于稳定的图片生成，建议使用以下配置：

# 查询间隔：10秒（减少API调用频率）
QUERY_INTERVAL=10000

# 最大查询次数：180次（对应30分钟）
MAX_QUERY_COUNT=180

# 图片尺寸：1K（生成速度更快，适合测试）
IMAGE_SIZE=1K

10. 联系支持

如果以上方法都无法解决问题：

1. 收集完整的日志输出
2. 记录任务ID和错误信息
3. 联系速创API技术支持
4. 提供复现步骤和错误详情