本文详解 nestjs + postgresql 场景下使用 `jsonb` 类型字段时，因误用 `@isjson()` 导致“content must be a json string”错误的根本原因，并提供零侵入、类型安全的正确解决方案。
在 NestJS 应用中集成 PostgreSQL 并利用其 jsonb 类型存储结构化内容（如富文本配置、动态表单数据等）是一种常见且高效的做法。但开发者常因对验证装饰器语义理解偏差而踩坑——典型表现就是：接口接收合法 JSON 对象（如 { "messages": ["a"], "detail": "b" }），却抛出 content must be a json string 错误。
问题核心在于 @IsJSON() 装饰器的严格语义：它仅接受字符串形式的 JSON 文本（即 typeof value === 'string' && JSON.parse(value) 可成功），而非已解析的 JavaScript 对象。而 Postman 或前端发送的原始请求体是标准 JSON 对象字面量，经 NestJS 的 ValidationPipe 和 class-transformer 处理后，content 字段已被自动反序列化为对象（IContent 实例），此时再用 @IsJSON() 校验，必然失败。
✅ 正确做法是：移除 @IsJSON()，改用类型安全的结构化验证。PostgreSQL 的 jsonb 列天然支持任意嵌套 JSON 对象，NestJS + TypeORM 会自动将对象序列化为 JSON 字符串写入数据库，无需手动 stringify。
以下为推荐实现方案：
1. DTO 中移除 @IsJSON()，改用精准结构校验
// create-content.dto.ts
import { IsNotEmpty, ValidateNested, IsArray, IsString } from 'class-validator';
import { Type } from 'class-transformer';
export class ContentDto {
@IsArray()
@IsString({ each: true })
messages: string[];
@IsString()
detail: string;
}
export class CreateContentDto {
@ValidateNested()
@Type(() => ContentDto)
content: ContentDto;
}2. Entity 中保持简洁声明
// content.entity.ts
import { Entity, Column, PrimaryGeneratedColumn } from 'typeorm';
export interface IContent {
messages: string[];
detail: string;
}
@Entity()
export class Content {
@PrimaryGeneratedColumn('uuid')
id: string;
@Column('jsonb', { nullable: false, default: () => '{}' })
content: IContent; // TypeORM 自动处理序列化/反序列化
}3. Controller 保持默认验证管道
// content.controller.ts
@Post()
create(@Body() createDto: CreateContentDto) {
return this.contentService.create(createDto);
}? 关键注意事项：
- @Column('jsonb') 字段在 TypeORM 中默认支持对象 ↔ JSON 字符串双向转换，无需额外 transformer；
- 若需数据库层面默认值，使用 default: () => '{}'（SQL 表达式），避免 default: {}（JS 对象，在迁移中无效）；
- 如需深度校验（如 messages 数组长度、detail 最大长度），在 ContentDto 中添加对应装饰器（如 @IsNotEmpty()、@MaxLength(500)）；
- 禁止在 DTO 中对 jsonb 字段使用 @IsJSON() 或 @IsString() —— 它们与实际传输的数据类型（对象）冲突。
总结：@IsJSON() 是为校验 字符串格式的 JSON 文本（如 API 接收 raw string body）而设计，不适用于标准 REST JSON 对象体。拥抱 TypeScript 接口 + @ValidateNested + @Type 组合，既能保障运行时类型安全，又完全兼容 PostgreSQL jsonb 的原生能力，这才是 NestJS 生态下的最佳实践。
