使用Nest.js的FilesInterceptor接收文件与数组参数报错求助

异常原因 #

当使用FilesInterceptor处理文件上传时，请求会以multipart/form-data格式发送，Express的默认表单解析器会把所有非文件的表单字段统一解析成字符串类型。你控制台打印的steps: '[]'就是明证——前端传入的数组被转成了字符串形式的数组字面量，而你的DTO里要求steps是数组类型，自然触发校验错误。

解决方案 #

有两种实用的处理方式：

1. 手动转换字段类型 #

在控制器方法里，把字符串格式的steps转成数组：

@Post('upload')
@UseInterceptors(FilesInterceptor('files'))
async uploadFiles(
  @UploadedFiles() files: Express.Multer.File[],
  @Body() body: YourDto,
) {
  // 手动转换steps字段
  if (typeof body.steps === 'string') {
    try {
      body.steps = JSON.parse(body.steps);
    } catch (err) {
      // 解析失败时抛出参数错误
      throw new BadRequestException('steps格式无效，请传入合法的数组JSON字符串');
    }
  }
  // 后续业务逻辑处理
}

注意：要提前和前端约定，把数组用JSON.stringify转成字符串后再传入，否则解析会失败。

2. 配置Multer解析器的extended选项 #

在Nest.js的main.ts里配置全局的body解析器，开启extended选项让它支持复杂类型解析：

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import * as bodyParser from 'body-parser';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  // 开启urlencoded的extended模式，支持解析复杂类型
  app.use(bodyParser.urlencoded({ extended: true }));
  await app.listen(3000);
}
bootstrap();

不过这种方式对multipart/form-data的支持不算特别稳定，更稳妥的还是手动转换字段类型。

进阶优化：自定义DTO校验器 #

如果用class-validator做校验，可以写个自定义验证器，自动处理字符串转数组的逻辑，同时完成校验：

import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments } from 'class-validator';

@ValidatorConstraint({ name: 'arrayOrJsonArrayString', async: false })
export class ArrayOrJsonArrayString implements ValidatorConstraintInterface {
  validate(value: any) {
    if (Array.isArray(value)) return true;
    if (typeof value === 'string') {
      try {
        const parsed = JSON.parse(value);
        return Array.isArray(parsed);
      } catch {
        return false;
      }
    }
    return false;
  }

  defaultMessage(args: ValidationArguments) {
    return `${args.property}必须是数组，或是能解析成数组的JSON字符串`;
  }
}

然后在DTO里使用这个验证器：

import { Validate } from 'class-validator';
import { ArrayOrJsonArrayString } from './custom-validators';

export class YourDto {
  @Validate(ArrayOrJsonArrayString)
  steps: YourStepType[]; // 替换成你的具体对象类型数组
}

这样既兼容了字符串形式的数组输入，又能保证校验逻辑严谨。

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