如何在NestJS中使用Sequelize.js为Postgres定义对象数组字段？

你遇到的核心问题是：使用DataType.ARRAY(DataType.JSON)时，Postgres仅存储无结构的JSON数据，TypeScript接口仅在编译时生效，运行时无法校验数组内对象的结构，导致存入的products变成无类型对象。以下是两种可行的解决方案：

方案一：JSONB数组+应用层校验 #

改用Postgres的JSONB类型（比JSON更高效且支持索引），同时在模型中添加自定义校验逻辑，确保每个数组元素符合结构要求：

import {Column, DataType, Model, Table} from "sequelize-typescript";

export interface IProductItem {
    productId: string;
    quantity: number;
}

interface ICartsCreationAttrs {
    userId: number;
    products: IProductItem[];
}

@Table({tableName: 'carts'})
export class CartsModel extends Model<CartsModel, ICartsCreationAttrs> {

    @Column({type: DataType.INTEGER, unique: true, autoIncrement: true, primaryKey: true})
    id: number;

    @Column({type: DataType.INTEGER, unique: true, allowNull: false})
    userId: number;

    @Column({
        type: DataType.ARRAY(DataType.JSONB),
        allowNull: false,
        validate: {
            validateProductArray(value: IProductItem[]) {
                if (!Array.isArray(value)) throw new Error('products必须是数组');
                
                value.forEach(item => {
                    if (typeof item.productId !== 'string') {
                        throw new Error('每个product必须包含字符串类型的productId');
                    }
                    if (typeof item.quantity !== 'number' || item.quantity < 1) {
                        throw new Error('每个product的quantity必须是≥1的数字');
                    }
                });
            }
        }
    })
    products: IProductItem[];
}

方案二：拆分为关联表（推荐复杂场景） #

如果需要数据库层面的强类型约束，可将products拆分为独立表，通过一对多关联实现，完全规避无类型问题：

1. 创建购物车商品模型 #

import {Column, DataType, ForeignKey, Model, Table} from "sequelize-typescript";
import {CartsModel} from "./carts.model";

@Table({tableName: 'cart_products'})
export class CartProductModel extends Model<CartProductModel> {
    @Column({type: DataType.INTEGER, unique: true, autoIncrement: true, primaryKey: true})
    id: number;

    @ForeignKey(() => CartsModel)
    @Column({type: DataType.INTEGER, allowNull: false})
    cartId: number;

    @Column({type: DataType.STRING, allowNull: false})
    productId: string;

    @Column({type: DataType.INTEGER, allowNull: false, defaultValue: 1})
    quantity: number;
}

2. 修改购物车主模型 #

import {Column, DataType, HasMany, Model, Table} from "sequelize-typescript";
import {CartProductModel} from "./cart-product.model";

interface ICartsCreationAttrs {
    userId: number;
}

@Table({tableName: 'carts'})
export class CartsModel extends Model<CartsModel, ICartsCreationAttrs> {

    @Column({type: DataType.INTEGER, unique: true, autoIncrement: true, primaryKey: true})
    id: number;

    @Column({type: DataType.INTEGER, unique: true, allowNull: false})
    userId: number;

    @HasMany(() => CartProductModel)
    products: CartProductModel[];
}

额外优化：请求DTO校验 #

在NestJS层面添加DTO校验，确保请求数据在到达服务层前就符合结构要求：

import {IsArray, IsInt, IsString, Min, ValidateNested} from "class-validator";
import {Type} from "class-transformer";

class ProductItemDTO {
    @IsString()
    productId: string;

    @IsInt()
    @Min(1)
    quantity: number;
}

export class CreateCartDTO {
    @IsInt()
    userId: number;

    @IsArray()
    @ValidateNested({each: true})
    @Type(() => ProductItemDTO)
    products: ProductItemDTO[];
}

在控制器中启用ValidationPipe即可自动校验请求数据。

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