Oxygen 部署后子路由刷新 404 怎么处理

现象#

站内跳转正常，但直接在地址栏打开 /collections/xxx 或刷新页面就 404。

原因#

• 静态托管按文件路径查找，未配置 SPA 回退到入口文件
• 路由文件命名不符合框架约定，构建时未生成对应路由
• 自定义域名仍指向旧托管，访问的是另一份产物

处理步骤#

1. 确认路由文件位于框架约定的目录（如 app/routes），文件名与路径匹配
2. 在托管配置里增加通配回退，把未匹配路径交给入口处理
3. 检查域名解析是否已指向当前环境，避免访问到旧部署
4. 对动态路由（集合、商品）补充 loader，避免运行时拿不到数据

验收标准#

任意子路由直接访问与刷新均返回 200；分享链接可正常打开。