Nestjsx Crud库报Cannot read properties of null (reading 'parsed')，求解决方案及项目状态

背景 #

在全新项目中按照Nestjsx Crud官方快速开始步骤配置后，调用批量创建接口时触发以下错误：

报错详情 #

[Nest] 23136  - 08/24/2023, 11:07:03 AM   ERROR [ExceptionsHandler] Cannot read properties of null (reading 'parsed')
TypeError: Cannot read properties of null (reading 'parsed')
    at /Users/ilija/Documents/Projects/Private/crud-demo/node_modules/@nestjsx/crud-typeorm/src/typeorm-crud.service.ts:161:59
    at Array.map (<anonymous>)
    at UsersService.createMany (/Users/ilija/Documents/Projects/Private/crud-demo/node_modules/@nestjsx/crud-typeorm/src/typeorm-crud.service.ts:161:8)
    at UsersController.createManyBase (/Users/ilija/Documents/Projects/Private/crud-demo/node_modules/@nestjsx/crud/src/crud/crud-routes.factory.ts:233:27)
    at /Users/ilija/Documents/Projects/Private/crud-demo/node_modules/@nestjs/core/router/router-execution-context.js:38:29
    at processTicksAndRejections (node:internal/process/task_queues:95:5)

相关讨论 #

该错误在项目仓库的两个Issue中已有讨论：

• Issue #443
• Issue #830

疑问 #

1. 该错误是否有可行的修复方案？
2. Nestjsx Crud是否已被弃用，是否推荐转向dataui-nestjs-crud？

错误修复方案 #

从相关Issue的讨论来看，这个错误的核心原因是实体类缺少正确的TypeORM装饰器配置，常见场景包括：

• 实体类未添加@Entity()装饰器
• 主键字段未用@PrimaryGeneratedColumn或@PrimaryColumn标记
• DTO与实体类的字段映射不匹配，遗漏核心字段

你可以按以下步骤排查修复：

1. 检查所有实体类的装饰器配置，确保实体和主键的标记正确
2. 验证DTO的字段结构与实体类一致，没有缺失必填项
3. 尝试降级@nestjsx/crud-typeorm版本到4.6.2或5.0.0-alpha.3，部分开发者反馈此方法可解决该问题

项目状态与替代方案 #

Nestjsx Crud已处于维护停滞状态，仓库长期无更新，遗留Bug未得到修复。

dataui-nestjs-crud是Nestjsx Crud的活跃分支，完全兼容原库API，修复了大量Bug，支持最新版本的NestJS和TypeORM，开箱即用体验更稳定，是目前推荐的替代方案。

内容的提问来源于stack exchange，提问作者Ilija Vuk