如何修复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
相关产品推荐
相关产品推荐

