导入Enum触发Cannot read property 'user' of undefined错误的原因排查

算力阿峰

2026-5-25

问题分析与解决方案

这个错误说明你导入的 Roles 变量实际上是 undefined，根本没拿到定义的枚举。常见的原因有这几个：

相对路径错误：你写的导入路径 ../enums/roles 可能和实际文件位置不匹配。比如如果服务文件在 src/services/xxx.service.ts，而枚举文件在 src/enums/roles.ts，那路径是对的，但如果枚举文件在 src/common/enums/roles.ts，那路径就错了，导致导入失败，Roles 变成 undefined。
循环依赖问题：如果你的枚举文件和服务文件之间存在循环导入（比如服务文件导入枚举，枚举文件又间接导入了服务文件），就会导致模块初始化顺序出问题，Roles 还没被定义就被服务文件访问，结果就是 undefined。
TypeScript 模块配置问题：如果你的 tsconfig.json 里的模块配置（比如 module 选项）和项目的模块系统不兼容，可能会导致枚举的导出/导入行为异常。比如用了 CommonJS 但代码里用 ES Modules 的导入语法，或者反过来，可能会出现导出的枚举无法被正确识别的情况。

当你在服务文件里直接写不带 export 的枚举时，这个枚举属于服务文件的模块内部作用域，不需要跨模块导入，自然不会有导入失败的问题，服务方法可以直接访问到它。

你误以为枚举不能像类一样导入，其实这是误解——TypeScript 枚举完全支持跨模块导出和导入，和类、接口的导入方式没有本质区别。只要解决了上面提到的导入问题，带 export 的枚举一样可以正常使用。

检查导入路径：确认枚举文件的实际位置，对比导入路径是否正确。可以试试用绝对路径（如果项目配置了路径别名的话），比如 @/enums/roles，避免相对路径出错。
排查循环依赖：检查枚举文件和服务文件之间有没有互相导入的情况，或者通过其他文件形成的间接循环依赖，尽量解开这种循环。
验证模块配置：打开 tsconfig.json，确保 module 选项和项目的运行环境匹配（比如前端项目常用 ESNext 或 ES2020，Node.js 项目可以用 CommonJS），同时 moduleResolution 选项设置为 NodeNext 或 Node 来匹配模块系统。
查看编译后的代码：可以看看枚举文件编译后的 JavaScript 代码，确认枚举是否被正确导出。比如编译后的代码应该类似：
```
export var Roles;
(function (Roles) {
    Roles[Roles["user"] = 10] = "user";
    Roles[Roles["editor"] = 30] = "editor";
    Roles[Roles["admin"] = 50] = "admin";
})(Roles || (Roles = {}));
```
如果导出部分有问题，那就要检查 TypeScript 的编译配置了。

内容的提问来源于stack exchange，提问作者Volodymyr Humeniuk