运行npm run start:dev时TypeOrm数据库连接错误求助

执行npm run start:dev启动NestJS项目时，触发TypeORM数据库同步报错，错误日志如下：

[Nest] 10504  - 20/01/2023, 15:47:27   ERROR [TypeOrmModule] Unable to connect to the database. Retrying (1)...
QueryFailedError: tables can have at most 1600 columns
    at PostgresQueryRunner.query (C:\Users\Public\Backend\src\driver\postgres\PostgresQueryRunner.ts:299:19)  
    at processTicksAndRejections (node:internal/process/task_queues:96:5)
    at PostgresQueryRunner.executeQueries (C:\Users\Public\Backend\src\query-runner\BaseQueryRunner.ts:609:13)
    at PostgresQueryRunner.addColumn (C:\Users\Public\Backend\src\driver\postgres\PostgresQueryRunner.ts:1039:9)
    at PostgresQueryRunner.addColumns (C:\Users\Public\Backend\src\driver\postgres\PostgresQueryRunner.ts:1053:13)
    at RdbmsSchemaBuilder.addNewColumns (C:\Users\Public\Backend\src\schema-builder\RdbmsSchemaBuilder.ts:737:13)
    at RdbmsSchemaBuilder.executeSchemaSyncOperationsInProperOrder (C:\Users\Public\Backend\src\schema-builder\RdbmsSchemaBuilder.ts:213:9)
    at RdbmsSchemaBuilder.build (C:\Users\Public\Backend\src\schema-builder\RdbmsSchemaBuilder.ts:92:13)
    at DataSource.synchronize (C:\Users\Public\Backend\src\data-source\DataSource.ts:317:9)
    at DataSource.initialize (C:\Users\Public\Backend\src\data-source\DataSource.ts:255:43)

错误原因分析 #

• PostgreSQL硬性限制：PostgreSQL单表最多允许1600列，这是数据库底层的固定限制，和数据插入操作无关，是表结构同步阶段触发的问题。
• TypeORM自动同步触发超限：从调用栈可以看出，TypeORM在执行DataSource.synchronize()（自动同步表结构）时，尝试给某张表添加新列，导致该表总列数突破1600的上限。
• 常见触发场景：
  • 实体类定义错误：比如通过循环逻辑生成大量重复列、装饰器配置错误导致冗余字段
  • 关联关系配置不当：一对多/多对多关系错误生成过多关联字段
  • 历史表结构残留：目标表原本列数已经接近1600，新增少量字段就触发了限制

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