Shopify 报错排障

Shopify 切换语言后页面 404 怎么修

现象#

点语言切换后跳到 /zh-cn/... 但返回 404,或跳到首页。

原因#

  • 该语言未在 Markets/语言设置中发布
  • 语言切换链接拼错前缀(大小写或连字符)
  • 页面在该语言下没有翻译版本且未配置回退

处理步骤#

  1. 后台「设置 → 语言」确认目标语言已添加并发布
  2. 用 {{ request.locale.iso_code }} 与 routes.root_url 生成切换链接,不要硬编码
  3. 配置默认语言回退,避免未翻译页面 404
  4. 检查 hreflang 与实际 URL 是否一致

验收标准#

各语言切换都能打开对应页面,URL 前缀正确,未翻译内容回退默认语言。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。