OpenAPI Generator生成python-flask脚手架时DELETE接口缺失body参数报错

本质是OpenAPI Generator的代码生成逻辑与Connexion新版本的默认行为不匹配，具体拆解：

• OpenAPI Generator生成python-flask脚手架时，会读取Schema中的x-codegen-request-body-name: body扩展字段，按照约定生成要求必填body入参的控制器方法，这一行为是基于旧版Connexion会自动注入请求体参数的逻辑设计的。
• Connexion 2.0及以上版本，依据HTTP规范对DELETE请求携带Body的非标准化定义，默认跳过DELETE请求的请求体解析与参数注入环节，不会把解析后的请求体对象作为命名参数传递给控制器函数。最终导致控制器要求的必填body参数始终无传值，触发TypeError: delete_thing() missing 1 required positional argument: 'body'错误。
• 注意：Schema中配置的x-amazon-apigateway-integration属于AWS API Gateway的自定义扩展，本地运行的Connexion服务完全不识别这类扩展规则，自然不会按照API Gateway的逻辑将DELETE请求转换为POST处理。

• 固定Connexion版本为兼容旧逻辑的版本
  修改生成项目的requirements.txt，将connexion版本锁定为1.x系列（例如connexion==1.5.4）。该版本Connexion不区分HTTP方法类型，只要接口定义了请求体，就会按照x-codegen-request-body-name指定的参数名将解析后的请求体注入控制器方法，完全匹配生成代码的预期，且可正常兼容项目使用的Python 3.6环境。
• 调整控制器函数签名，绕开必填参数校验
  直接修改生成的example_controller.py中的delete_thing方法，为body参数添加默认值：

  def delete_thing(body=None):  # noqa: E501
  

  现有控制器逻辑本身就是从connexion.request中直接读取JSON请求体完成反序列化的，不依赖Connexion传入的body参数。修改签名后，即使Connexion不传该参数，函数也不会触发参数缺失报错，可正常完成请求处理。
• 自定义代码生成模板，批量适配参数规则
  若需要反复生成代码、不想每次手动修改控制器逻辑，可以在本地新建自定义的控制器生成模板，将模板内的函数定义部分调整为参数带默认值的格式，在执行Docker生成命令时通过-t参数指定自定义模板路径，生成的代码会自动适配参数规则，从根源避免同类报错。
• 调整Connexion全局配置，开启DELETE请求体解析
  在项目初始化Connexion应用的代码（通常为openapi_server/__main__.py）中，创建Connexion App时传入对应配置参数，显式开启DELETE请求的Body解析逻辑，让Connexion主动将解析后的请求体参数注入控制器函数。

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