使用Connexion的Flask服务器无法通过PyInstaller打包发布求助

错误原因 #

这个ValueError: The name '/swagger' is already registered for a different blueprint错误，本质是Connexion在PyInstaller打包后的运行环境中，重复注册了Swagger相关的Flask蓝图。

具体来说，Connexion默认会在第一次请求时延迟构建中间件栈并注册API蓝图，但PyInstaller打包后，Python模块的加载逻辑发生变化，导致这个过程被重复触发，Swagger的蓝图（默认名称为'/swagger'）被多次尝试注册，而Flask不允许同名蓝图绑定到不同对象。

解决方法 #

1. 给API指定唯一名称 #

在调用add_api时显式传入name参数，避免使用默认的'/swagger'名称，确保每个API蓝图的名称唯一：

app = connexion.FlaskApp(__name__)
# 给API指定唯一名称，比如'hello_world_api'
app.add_api('swagger.yaml', name='hello_world_api')

2. 提前构建中间件栈 #

禁用Connexion的延迟加载机制，在启动服务器前手动构建好中间件栈，避免第一次请求时重复初始化：

app = connexion.FlaskApp(__name__)
app.add_api('swagger.yaml')
# 提前构建中间件栈，不要等到第一次请求才触发
app._build_middleware_stack()
# 再启动服务器
app.run(host='0.0.0.0', port=8080, server='uvicorn')

3. 确保静态资源被正确打包 #

PyInstaller默认不会自动包含Swagger的UI静态文件和你的swagger.yaml配置文件，需要手动指定打包资源：

• 命令行打包时添加--add-data参数：

  pyinstaller --add-data "swagger.yaml:." --add-data "venv/lib/python3.x/site-packages/connexion/swagger-ui:connexion/swagger-ui" your_script.py
  

  （注意替换python3.x为你的Python版本）
• 或者编写PyInstaller的spec文件，在datas字段中添加资源路径：

  a = Analysis(
      ['your_script.py'],
      datas=[
          ('swagger.yaml', '.'),
          ('venv/lib/python3.x/site-packages/connexion/swagger-ui', 'connexion/swagger-ui')
      ],
      # 其他配置...
  )
  

4. 检查代码执行逻辑 #

确保add_api只被调用一次，避免在循环、装饰器或者会被重复执行的代码块中调用该方法。比如把app的初始化代码放在模块顶层，而不是某个会被多次调用的函数内部。

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