You need to enable JavaScript to run this app. 如何修复Nebular加载页面时出现的“Default pack is not registered”错误
优惠活动
大模型
产品
解决方案
定价
更多

如何修复Nebular加载页面时出现的“Default pack is not registered”错误

Nebular「Default pack is not registered」错误修复方案

错误核心成因

该报错属于Nebular主题系统的注册校验逻辑触发的异常,本质是主题初始化流程没有完成默认设计包的全局注册,和页面业务代码本身没有直接关联。

分步修复操作

  • 检查根模块的主题初始化配置完整性
    Nebular v9及以上版本,已将默认设计包从自动内置注册的逻辑调整为手动注册模式,必须在根模块的NbThemeModule.forRoot方法中传入默认包参数,否则会直接触发该报错。
    正确的根模块初始化参考写法:
    import { NbThemeModule, NbDefaultPack } from '@nebular/theme';
    
    @NgModule({
      imports: [
        // 第二个参数必须传入默认包实例,完成全局注册
        NbThemeModule.forRoot({ name: 'default' }, NbDefaultPack)
      ]
    })
    export class AppModule {}
    
  • 排查依赖版本匹配问题
    检查@nebular/theme、@eva-design/eva、@nebular/eva-icons三个核心依赖的版本号保持完全一致,跨大版本混用依赖时,不同版本对默认包的注册逻辑不统一,很容易触发校验报错。
  • 排查懒加载模块的配置冲突
    禁止在非根模块的懒加载子模块中调用NbThemeModule.forRoot方法注册主题包,子模块仅可通过NbThemeModule.forChild()引入已经在根模块完成全局注册的主题能力,重复注册会导致包注册逻辑被覆盖丢失。
  • 自定义主题场景补全注册项
    如果项目配置了自定义主题,需要确认主题注册逻辑中保留了default主题作为兜底项,不能只注册自定义主题项,否则主题初始化时找不到默认设计包会直接抛错。

高频踩坑场景

报错最常出现在Nebular版本升级之后,直接沿用v8及更早版本的初始化写法(仅传入主题名称、不传入默认包参数),没有适配新版本的手动注册要求。

内容的提问来源于stack exchange,提问作者btd1337

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 18:24:03