常见错误与排查指南：生成失败、模糊、变形、跑偏怎么解决？
当 AI 生成用于电商生产环境时，最重要的是把问题变成可复现、可定位、可修正的流程。你不需要每次靠“玄学调参”，而是建立一套排查 Runbook：看到现象 → 判断原因 → 按步骤修复 → 把有效策略沉淀成模板。
本文按“现象 → 可能原因 → 解决步骤”的结构整理常见问题，并给出提升稳定性的预防性建议。
0) 先确认：是不是可访问性/网络问题？
如果你遇到的是“页面打不开、抓取诊断失败、DNS 无法解析”这类问题，它和生成质量无关，但会影响搜索引擎抓取与用户访问。
建议的最小验证：
- 首页、/pricing 是否 200
- /robots.txt、/sitemap.xml 是否 200
- 是否偶发失败（重试成功通常是短时波动）
如果访问层面稳定，再进入下面的生成问题排查。
1) 任务创建失败 / 生成失败
可能原因：
- 输入不完整（缺素材、参数不合法）
- 上游模型服务暂时不可用
- 触发安全/合规拦截
- 网络波动导致请求中断
排查步骤：
- 检查素材：是否空文件/损坏/分辨率过低
- 简化提示词：先用白底主图模板跑通
- 降低复杂度：先单张、先 1024、先 1:1
- 换一张更清晰的素材
- 记录任务信息（时间、模型、参数、错误提示）用于支持排查
2) 生成超时 / 一直处理中
可能原因：
- 队列拥堵（高峰期）
- 输出规格太重（高分辨率/多张/视频）
- 网络中断导致回调未返回
解决建议：
- 降低并发：把 10 张拆成 2×5
- 先降低规格：分辨率先 1024
- 若长时间无结果：取消后重试，并保留日志
3) 图片模糊 / 细节糊
可能原因：
- 素材像素不足
- 提示词未强调高清细节/纹理
- 输出分辨率过低
- 场景过复杂导致主体细节被牺牲
解决步骤：
- 优先换素材：更清晰、更干净
- 提示词增加：高清细节、清晰纹理、边缘干净
- 提升输出规格
- 场景图先“背景极简”，稳定后再丰富
4) 主体变形 / 结构不对
可能原因：
- 主体描述太少，模型自由发挥
- 未声明主体数量 1
- 参考图风格干扰主体结构
解决步骤：
- 主体描述增加关键结构点（鞋带、鞋底、拉链、按钮位置）
- 约束段写：主体数量 1，不要出现第二件商品/配件/包装盒
- 使用结构更清晰的素材角度
5) 白底不干净 / 背景出现纹理
解决步骤：
- 明确写：纯白背景（#FFFFFF），背景无纹理无阴影
- 加禁止项：无道具、无桌面、无人物
- 若需要阴影：写“柔和自然阴影”，避免强黑影
6) 出现文字/水印/乱码
说明： 生成文字通常不稳定。电商生产建议：
- 默认禁止任何文字/水印
- 卖点文字用后期模板化叠加（更可控、更合规）
提示词建议：
- 无文字无水印
- 不要生成任何标志/文字
7) 风格不一致（批量任务最常见）
一致性来自“模板化”，而不是“多跑几次”。建议固定：
- 风格词：高端极简、柔光棚拍、真实质感
- 构图：主体居中、1:1、留白一致
- 输出规格：分辨率与比例不变
并使用“风格锚点”：
- 固定参考风格图
- 固定模板提示词
详见：/docs/best-practices
8) 场景图主体不突出
解决步骤：
- 提示词加：商品为画面视觉中心
- 背景描述减少到 1~2 个关键词
- 明确禁止人物与复杂道具
9) 下载/导出失败
常见原因：网络波动、文件过大、浏览器缓存。
建议：
- 刷新重试
- 换浏览器/无痕
- 记录时间与链接用于排查
10) 预防：把“可控变量”锁死
想要稳定，最有效的策略是：
- 固定提示词模板（三段式）
- 固定输出规格（比例/分辨率）
- 固定审核清单（10 秒自检）
推荐你把模板沉淀到团队 SOP（或平台模板库）中。