OpenAPI Generator生成含可空元素的数组失败问题求助

我在基于OpenAPI 3.0.1版本的swagger.json里定义了如下组件：

"ids": {  
  "type": "array",  
  "items": {  
    "type": "string",  
    "format": "uuid",  
    "nullable": true,  
    "x-nullable": true  
  },  
  "nullable": true,  
  "x-nullable": true  
}

但使用OpenAPI Generator生成代码时，发现没办法正确处理这个数组本身可空、同时数组内元素也支持为空的结构——生成的代码要么没正确标记元素可空，要么数组的可空性不符合预期。有没有过来人能帮忙支支招？

几个可能的解决方向： #

• 升级OpenAPI Generator版本：部分旧版本对OpenAPI 3.0原生的nullable字段支持不够完善，建议升级到v6.x及以上的稳定版本，新版本对可空类型的处理更贴合规范。
• 清理冗余的可空标记：OpenAPI 3.0已经原生支持nullable: true，x-nullable是OpenAPI 2.0时代的扩展字段，同时保留两者可能会让生成器产生混淆，建议只保留原生的nullable配置。
• 开启对应语言的可空支持：如果生成的是强类型语言（比如Java、C#）的代码，可以通过生成参数开启语言的可空特性。比如Java可以添加参数--additional-properties=useNullable=true，确保生成器能正确生成对应类型的可空元素。
• 调整Schema的可空定义写法：如果上面的方法都不生效，可以尝试用oneOf明确指定元素的可空性，写法如下：

"items": {
  "oneOf": [
    {
      "type": "string",
      "format": "uuid"
    },
    {
      "type": "null"
    }
  ]
}

这种写法更贴合OpenAPI规范的可空语义，大概率能被生成器正确识别处理。

内容来源于stack exchange