OpenAPI中uniqueItems为true的数组最佳实践及生成Angular Set报400如何解决？

高版本OpenAPI Generator将标注了uniqueItems: true的数组映射为TypeScript的Set类型是符合语义的设计，但JSON标准本身不支持Set数据结构。Angular默认的HttpClient在序列化请求体时使用标准JSON.stringify()方法，该方法会将Set实例序列化为空对象{}，与后端期望的数组格式完全不匹配，因此触发400 Bad Request错误。

有两种可行方案，可根据业务需求选择：

方案1：调整生成器配置，直接生成数组类型 #

OpenAPI Generator的typescript-angular生成器提供了专门的配置参数关闭uniqueItems到Set的映射：

• 在命令行调用时添加额外参数：

  openapi-generator-cli generate -i your-spec.json -g typescript-angular -o output-path --additional-properties=uniqueItemsAsArray=true
  

• 如果使用配置文件管理生成参数，在openapi-generator-config.yaml中添加：

  additionalProperties:
    uniqueItemsAsArray: true
  

该方案生成的模型代码将和4.3.1版本一致，roles字段为Array<RoleDto>类型，同时保留uniqueItems的语义约束，你只需在业务代码中自行保证数组元素不重复即可。

方案2：保留Set类型，自定义请求序列化逻辑 #

如果想要保留Set类型贴合Java侧的Set语义，可以新增Angular HTTP拦截器，在请求发送前统一将所有Set实例转换为数组：

import { Injectable } from '@angular/core';
import { HttpRequest, HttpHandler, HttpEvent, HttpInterceptor } from '@angular/common/http';
import { Observable } from 'rxjs';

@Injectable()
export class SetToArrayInterceptor implements HttpInterceptor {
  intercept(request: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>> {
    if (request.body) {
      const processedBody = this.convertSetsToArray(request.body);
      request = request.clone({ body: processedBody });
    }
    return next.handle(request);
  }

  private convertSetsToArray(data: unknown): unknown {
    if (data instanceof Set) {
      return Array.from(data);
    }
    if (Array.isArray(data)) {
      return data.map(item => this.convertSetsToArray(item));
    }
    if (typeof data === 'object' && data !== null) {
      return Object.fromEntries(
        Object.entries(data).map(([key, value]) => [key, this.convertSetsToArray(value)])
      );
    }
    return data;
  }
}

之后将该拦截器注册到AppModule的providers数组中即可生效。

• 语义层面：uniqueItems仅作为约束标注，说明传输的JSON数组中不能出现重复元素，和前后端实现侧的具体类型（Java Set/TS Set/自定义去重数组）没有强制绑定关系。
• 传输层面：统一使用JSON数组作为传输格式，不要依赖语言特有的集合类型直接序列化传输，避免出现序列化不兼容问题。
• 校验层面：后端不能依赖前端保证元素唯一性，接口层必须对传入的数组做重复值校验，避免非法请求绕过前端约束。

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