使用Connexion开发Flask API时遇operationId解析及模块导入错误

错误原因 #

直接运行app.py时，脚本被当作顶层模块而非包的一部分，导致相对导入失效，且people模块未进入全局命名空间，Connexion解析器无法找到该模块。

解决方案 #

方案1：调整运行方式并导入people模块 #

1. 修改app.py，添加people模块导入，确保其加载到全局命名空间：

from flask import Flask
import connexion

app = connexion.App(__name__, specification_dir="./")
app.add_api("swagger.yaml")

# 导入people模块，让Connexion能识别到它
from . import people

2. 以包的方式启动应用：
   • 进入项目根目录的上级目录（即包含connexionTest文件夹的目录）
   • 执行命令：python -m connexionTest.app
   • 或通过Flask命令启动：
     Windows：set FLASK_APP=connexionTest.app && flask run
     Linux/macOS：export FLASK_APP=connexionTest.app && flask run

方案2：使用相对解析器（RelativeResolver） #

修改app.py，指定Connexion基于当前模块解析operationId，无需额外导入即可识别people.welcome：

from flask import Flask
import connexion
from connexion.resolver import RelativeResolver

app = connexion.App(__name__, specification_dir="./")
# 基于当前模块的路径解析operationId
app.add_api("swagger.yaml", resolver=RelativeResolver(__name__))

启动方式同方案1，必须以包的形式运行，不能直接执行python app.py。

额外注意 #

• 禁止直接运行app.py，这会破坏包结构的相对导入逻辑，导致模块识别失败。
• 确保项目根目录（connexionTest）下的__init__.py存在（你的项目已满足），这是Python识别包的必要条件。

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