常见问题排查

本文档整理了 superun 使用过程中用户反馈的常见问题及对应的解决方案,帮助你快速定位和解决问题.

---

​

数据回滾和修改异常问题

​

问题描述

用户反馈修改内容后第二天自动恢复旧版本,或内容消失併入其他分类.

​

解决方案

模型代码在数据加载失败时会重新初始化旧数据.建议採用以下方式:

• 使用单独后台管理数据:将数据管理与模型逻辑分离,避免数据加载失败时触发重新初始化
• 直接让模型修改数据:确保数据修改操作由模型直接处理,减少中间环节导致的数据不一致

---

​

AI 试衣生成失败问题

​

问题描述

用户反馈 AI 试衣生成功能报错,多次修复无效.

​

解决方案

此问题通常由 headers 参数导致 body 序列化问题引起.解决步骤:

1. 检查 API 请求中的 headers 参数
2. 让 AI 排查多余的 headers 参数
3. 确保 headers 与 body 的序列化格式一致
4. 移除不必要的 headers 配置

---

​

代幣不足后报错问题

​

问题描述

用户反馈代幣充值后会话异常终止,无法继续操作.

​

解决方案

1. 查看日志:检查系统日志,确认代幣充值后的具体错误信息
2. 使用檢修功能:在 superun 中使用檢修功能处理异常状态
3. 重新测试:修复后重新测试,确认会话可正常继续

💡 提示:如果问题持续存在,建议聯繫技术支持并提供相关日志信息.

---

​

后台地址和 APP 部署问题

​

问题描述

用户咨询后台地址和 APP 下载方式.

​

解决方案

当前限制说明:

• superun 目前只能生成网页应用,无法直接生成原生 APP
• 如需部署后台管理系统,需要先生成后台,然后再进行其他配置
• 后台地址会在生成后提供,具体位置取决于你的部署方式

建议流程:

1. 先使用 superun 生成后台管理系统
2. 获取后台访问地址
3. 如需移动端体验,可考虑使用响应式设计或 PWA（渐进式网页应用）

---

​

浏览器兼容性问题

​

问题描述

Safari（特别是老版本,如 Safari 16.1 / macOS 13）无法打开网站,显示空白页面,或某些网絡环境下无法访问.

​

解决方案

1. 推荐浏览器:使用 Chrome、Edge、Safari（新版本）等主流浏览器
2. 系统升级:升级 macOS 系统以获得最新版 Safari
3. 网絡测试:访问 https://net-test.superun.app/ 测试网絡连接
4. 设备建议:尽量使用电脑端操作,手机和 iPad 的适配还在完善中

---

​

预览和操作问题

​

问题描述

预览打不开但发布的链接可以正常访问,有代币但无法操作或打字,预览一直处于某个状态页面没有变化,或功能修复后又失效.

​

解决方案

1. 预览打不开:
   • 检查网络连接,访问 https://net-test.superun.app/ 测试
   • 尝试在新页面打开预览
   • 如果发布的链接可以访问,可能是预览环境的问题,刷新浏览器
2. 有代币但无法操作:
   • 需要先勾选”产生演示”,完成后才能进行对话修改
   • 确保项目已经完成初始演示生成
3. 预览状态不更新:
   • 点击”检修”功能进行修复
   • 刷新浏览器整个页面（不是页面内的刷新）
   • 如果检修后出现”执行”按钮,点击执行
   • 关闭浏览器重新打开项目
4. 功能反复失效:
   • 可能是 AI 在后续修改中把功能改回去了
   • 使用版本历史回滚功能恢复到之前正常工作的版本
   • 避免在和一个对话中反复修改,发现问题及时停止并换思路

---

​

性能优化问题

​

问题描述

网页加载慢,手机版慢.

​

解决方案

1. 检查网絡:可能是网絡问题,建议测试网絡速度
2. 优化图片:图片或文件太大可能导致加载慢,需要优化图片大小
3. 咨询 AI:描述清楚问题,让 AI 提供优化方案
4. 考慮用户体验:不能要求所有用户网速都很快,需要在设计时考慮加载性能

---

​

网络异常和任务卡住问题

​

问题描述

经常弹出”网络异常”提示,或任务一直处于”读取控制台日志”进程中.

​

解决方案

1. 网络异常:可能是请求量过高,等一会就好了;如果持续出现,联系技术支持
2. 任务卡住:联系技术支持,提供项目链接

---

​

如何提交新问题

如果你遇到其他问题,可以:

1. 查看本文档是否已有类似问题的解决方案
2. 聯繫技术支持团队
3. 在社区論壇发帖寻求帮助

---

superun 网站

了解更多产品功能和示例.