Swagger-UI/OpenAPI-generator是否支持多部分请求的分块自定义头部？

你提供的OpenAPI 3.0规范是符合官方标准的，但在Swagger UI和OpenAPI Generator中出现X-Custom-Header无相关引用的情况，原因如下：

Swagger UI的支持情况 #

Swagger UI目前对multipart/form-data请求的分块头部（即encoding.[field].headers配置）支持不完善，不会在UI界面中渲染对应的头部设置入口。这属于工具自身的功能缺失，尽管你的规范合法，但UI层暂未实现该特性的展示与交互。

OpenAPI Generator的支持情况 #

OpenAPI Generator对分块头部的支持取决于具体的语言模板：

• 部分老旧的HTTP客户端适配模板未实现分块头部的生成逻辑，导致生成的代码中没有相关内容。
• 部分较新的模板（如Java的okhttp模板、Python的requests模板）可能已经支持该特性，你可以尝试更新生成器版本或切换不同的语言模板测试。

若需确认规范的合法性，可使用OpenAPI Validator工具检查，确认结构合规后，问题根源即为工具的支持度限制。后续可关注Swagger UI和OpenAPI Generator的版本更新，它们大概率会在迭代中完善这部分功能。

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