Angular5项目npm build失败：模块声明undefined值错误

数据老陈

2026-5-21

解决Angular 5库打包时"Unexpected value 'undefined' declared by the module"报错

我之前在构建Angular库的时候也踩过类似的坑，结合你的依赖链（simple-kaishi → kaishi → ngx-admin-lte）和报错信息，这个问题基本是模块声明/导出异常或者packagr配置没处理好第三方依赖导致的，给你几个具体的排查和解决步骤：

检查Kaishi库的NgModule配置
首先去核对kaishi的核心模块（比如KaishiModule）里的declarations、exports、imports数组，有没有不小心引入了未正确导出的组件/模块，或者路径写错导致模块加载失败变成undefined。
举个例子：如果你的模块里写了imports: [NgxAdminLteModule, SomeMissingModule]，后者找不到的话就会触发这个报错，一定要确保每个导入的模块都能正确被解析。
修正ng-packagr的配置文件
因为kaishi依赖了ngx-admin-lte，你需要在ng-package.json里把它加入白名单，避免packagr忽略这个依赖导致模块缺失：
```
{
  "$schema": "./node_modules/ng-packagr/ng-package.schema.json",
  "dest": "./dist",
  "lib": {
    "entryFile": "src/public_api.ts",
    "whitelistedNonPeerDependencies": ["ngx-admin-lte"]
  }
}
```
同时确认src/public_api.ts里正确导出了所有需要对外暴露的模块和组件，没有漏写或者路径错误：
```
export * from './lib/kaishi.module';
// 按需导出其他公共组件/服务
```

清理缓存后重新构建
缓存问题经常会引发这类奇怪的报错，试试执行以下命令彻底清理后重新构建：

# 清理npm缓存
npm cache clean --force
# 删除依赖和锁文件
rm -rf node_modules package-lock.json
# 重新安装依赖
npm install
# 删除之前的打包产物
rm -rf dist
# 重新打包
npm run packagr

核对ngx-admin-lte的版本兼容性
你使用的是ngx-admin-lte的develop分支，这个分支可能包含未稳定的代码，或者和Angular 5的版本不兼容。建议切换到对应Angular 5的稳定tag版本，再重新安装依赖后尝试打包，避免因为第三方依赖的问题导致模块导出异常。