使用openapi-generator生成Python-Flask代码时API规范更新覆盖控制器逻辑的解决方法

• 分层分离业务逻辑（最推荐）
  把控制器里的自定义业务逻辑全部抽离到独立的服务层模块，比如在项目里新建services/目录，创建shop_service.py这类文件存放业务代码。生成的控制器只保留路由映射、参数校验和调用服务层方法的逻辑，比如：

  # 生成的控制器文件
  from services.shop_service import get_shop_detail
  
  def shop_unique_id_get(unique_id):
      return get_shop_detail(unique_id)
  

  这样就算控制器被重新生成，只要服务层文件不被生成器触碰，自定义业务逻辑就不会丢失，同时还符合MVC的分层设计规范。

• 配置生成器跳过覆盖指定文件
  用OpenAPI Generator的配置文件（比如openapi-generator-config.yaml）指定不需要覆盖的控制器文件。可以添加如下配置：

  skipOverwrite: true
  # 或者针对特定文件设置
  ignoreFileOverride:
    - path: ./controllers/shop_controller.py
      skipOverwrite: true
  

  注意这种方式下，如果API规范有路由、参数的变更，需要手动同步控制器里的对应部分，适合API结构不频繁变动的场景。

• 基于生成的基类控制器扩展
  让生成器生成带后缀的基础控制器类（比如BaseShopController），然后自己编写子类控制器继承这个基类，把自定义逻辑放在子类里。在生成配置里设置：

  controllerSuffix: Base
  

  生成的控制器会以Base结尾，你自己的ShopController继承它，重写或扩展方法，业务逻辑写在子类中。生成器只会更新基类文件，不会影响你的子类。

• 版本控制手动合并（兜底方案）
  每次生成代码后，用Git的diff工具对比生成前后的控制器文件，手动把自定义逻辑合并到新生成的文件里。这种方式效率低，容易出错，只适合临时应急或者小范围变更的场景。

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