前端装载与访问故障

前端排查路径

宿主菜单、运行期注册表、联邦资源与平台契约构成装载链路。按失败位置检查，菜单权限、脚本加载与后端认证分别排查。

一、没有 AI 菜单

检查当前顶部应用、后端角色菜单和 /ai/** 路径。只有注册表条目而没有授权菜单时，宿主不会装载该业务。

二、模块加载失败

1. 检查线上 remotes.json 中 AI 的 enabled、版本和 entry。
2. 打开该 manifest，核对 HTTP 状态、appVersion、buildId 与 ./remote 出口。
3. 检查远端入口和分包是否返回正确的 JS，而不是宿主 HTML。
4. 核对共享依赖矩阵、契约 major 与部署 base。

HTML 被当作脚本

资源请求返回 200 仍可能是错误内容。出现 < 等脚本语法异常时，先看响应正文和内容类型，再核对 Nginx 的静态资源 404 规则。

三、独立开发认证失败

1881 的开发身份与按钮只用于开发展示，接口是否已认证以请求结果为准。检查开发凭证是否来自正确的后端、是否过期、租户是否一致。

出现平台句柄不可用时，检查 @saber/micro 根与子路径是否按工程 Vite 配置一起预构建，共享包是否产生重复实例。

四、刷新或分享链接 404

宿主页面路由回落到宿主 index.html；分享页面路由回落到其 share.html；AI 静态资源缺失直接返回 404。三类路径分别配置回落规则。

五、新版本未生效

核对浏览器实际请求的 manifest、注册表版本与入口缓存头。已打开的旧页面继续持有旧模块，刷新后再对照 buildId；业务配置变更还要核对资源发布版本。