常见问题与运维排错速查 (FAQ)

在日常使用 SymbolFlow Appsuite 管理外贸独立站的过程中，如果您遇到了非预期的现象，请先查阅本篇排错指南。绝大多数问题都属于配置流程或网络缓存的正常现象，按照以下步骤即可快速解决。

---

1. 为什么在后台修改了商品内容，线上网站没有更新？

这是初学者最容易遇到的问题。请按照 三步排查法 逐一确认：

排查步骤：

1. 检查是否点击了「发布」 (Publish) 按钮： Payload CMS 支持草稿箱机制。如果您只是修改了文字并点击了“存为草稿 (Save Draft)”，线上网站是不会展示的。必须点击右上角的 「发布」 (Publish) 按钮。
2. 检查是否在 Appsuite 面板触发了站点编译部署： 因为 Appsuite 是高性能的静态编译网站，后台数据库保存后，正式的线上网站展厅需要经过一次编译生成。请回到 SymbolFlow 平台控制台，在对应站点卡片上点击 「立即构建部署」 (Deploy)。
3. 检查本地浏览器缓存： 由于生产环境启用了强缓存策略，您的浏览器可能仍然保留着旧版本的网页。请在电脑键盘上按下快捷键强制刷新：
   • Windows / Linux：Ctrl + F5
   • macOS：Cmd + Shift + R

---

2. 为什么修改了英文页面的布局 (Layout)，中文页面没有同步变化？

原因说明：

为了满足跨境出海企业在不同国家展示完全不同营销模块的诉求（例如：面向欧美市场展示环保合规报告，面向中东市场展示大型工程案例），Appsuite 将页面底层的 layout（页面模块区） 设定为了语言独立相关字段 (Localized)。

解决办法：

修改英文页面的布局模块后，中文页面的模块不会自动随之改变。

• 您需要在 Payload CMS 页面顶部切换语言下拉菜单至 中文 (zh)；
• 在中文环境下，根据需要增删或调整对应的模块；
• 分别在各个语言环境下点击 「发布」 (Publish)。

---

3. 在控制台绑定域名时，提示“域名信息尚未就绪，请稍后再试”？

原因说明：

在 Appsuite 控制台点击“保存修改”时，后台自动化程序会通过权威 DNS 根服务器实时查询您的域名解析记录（CNAME 或 TXT）。

由于全球域名服务商（如阿里云、腾讯云、GoDaddy、Namecheap）将 DNS 记录广播到全球各个机房通常需要 3 到 10 分钟 的传播时间（DNS Propagation Delay）。

解决办法：

1. 确认您在域名商处填写的记录值完全正确（无多余空格、未选错记录类型）；
2. 保持耐心，静候 5~10 分钟；
3. 回到控制台重新点击 「保存修改」 即可顺利通过。

---

4. Excel 批量导入规格时，系统报错如何处理？

如果在导入 Excel 规格表时遇到弹窗报错，通常是由于表格结构与规范不符引起的：

常见报错信息	故障根本原因	快速纠错方案
Missing required sheet "SKUs"	工作簿中缺少名为 SKUs 的标签页	确保 Excel 第 1 个 Sheet 名称严格为 SKUs，区分大小写
Missing required sheet "Dictionary"	工作簿中缺少名为 Dictionary 的标签页	确保 Excel 第 2 个 Sheet 名称严格为 Dictionary
Column header mismatch	表头名称与后台 specColumns 定义不一致	检查 Excel 的 D 列及后续列名，必须与后台参数列的 Column Key 完全一致（如 thread, d, h）
Image file not found in ZIP	压缩包内找不到表格所引用的图片文件名	检查 ZIP 包内的图片文件名是否包含特殊符号，或与表格第 E 列的文件名存在大小写差异

[!TIP] 官方建议： 强烈建议直接前往 官方配套样例包与模板资源下载中心 下载我们提供的标准标杆文件 VD-Sample.xlsx，在其基础上修改数据，以避免任何格式兼容性问题。

---

5. 如何重置管理后台管理员密码？

如果您遗忘了 Payload CMS 管理员账号密码：

1. 登录 SymbolFlow 平台总控控制台（app.symbolflow.com）；
2. 找到您的 Appsuite 应用实例，进入 设置 (Settings) 选项卡；
3. 在管理用户安全凭证栏目中，点击 「重置管理员密码」 (Reset Admin Credentials)；
4. 系统将生成新的安全随机密码，您可使用该凭证重新登录管理后台。