1 事故背景
- 管理端执行
pnpm run build（含 nitro/vite）连续失败，阻塞发布。 - 主要症状：
EISDIR导入目录、缺失@vue/compiler-sfc、@vue/shared解析失败，Nitro SSR 构建中断。
2 影响范围
- 管理端生产构建（vite + nitro SSR）无法产出可用包。
- 受影响分支：当前工作分支（未提及合并）。
3 关键时间线
- 发现：运行
pnpm run build报Could not load ... build/src/store，后续@vue/compiler-sfc缺失。 - 处置：
- 修正 Nitro/Vite alias：补充
components、composables，并在 Nitro 使用import.meta.url保证路径解析。 - 依赖补齐：新增
@vue/compiler-sfc、@vue/shared。 - 还原导入习惯：保持原始
components/...、composables/...入口，不强制index.ts后缀。
- 修正 Nitro/Vite alias：补充
- 验证：
pnpm run build成功，Nitro SSR 构建通过。
4 根因分析
- alias 解析偏移
- Nitro 默认基于
build/utils.ts的路径解析，未传入import.meta.url时pathResolve错指向build/src，导致EISDIR。
- 依赖缺失
unplugin-icons在 SSR 构建需要@vue/compiler-sfc，项目未显式安装。- Vite SSR 构建依赖
@vue/shared，未在 admin 包声明。
- 导入调整策略不当
- 强制加
index.ts后缀非必要，易引入额外路径歧义；保持约定式目录入口更稳定。
5 处置与修复
- 配置：
apps/admin/build/utils.ts：新增 aliascomponents、composables。apps/admin/nitro.config.ts：alias 同步且传入import.meta.url，避免偏移。
- 依赖：
- admin/package.json：新增
@vue/compiler-sfc、@vue/shared。
- admin/package.json：新增
- 代码：
- 恢复业务导入为约定入口（不强制
index.ts后缀）。
- 恢复业务导入为约定入口（不强制
- 验证：
- 执行
pnpm run build（含 Nitro SSR）已通过，生成.output成功。
- 执行
6 预防与改进
- Alias 对齐：将 tsconfig、Vite、Nitro 的 alias 长期保持一致，避免路径漂移。
- SSR 依赖白名单：将 SSR 必需依赖（如
@vue/compiler-sfc、@vue/shared）纳入 package.json 并定期审计。 - 构建前检查：在 CI 增加
pnpm run build（含 SSR）作为必跑项，提前暴露 alias/依赖问题。 - 变更策略：避免大规模后缀重写，优先修正 alias 与入口配置。
7 当前状态
- 管理端
pnpm run build已通过，Nitro SSR 正常产物可运行。 - 无新增类型错误；后续如需扩展 alias，请同步到 Vite/Nitro/tsconfig。
贡献者
ruan-cat