Flask(Connexion)包模式下extra_files无法触发重载问题咨询

核心原因分析 #

你遇到的现象是正常的，核心问题在于运行方式与Flask监控逻辑不匹配：

• pip install -e .仅保证模块源码修改后能被Python解释器读取，但Flask默认重载机制只监控当前工作目录下的文件。用python -m thing.app.main启动时，工作目录未必是项目源码目录，导致监控失效。
• Connexion对Flask的封装会修改部分默认行为，直接传递extra_files如果路径范围不全或路径错误，也无法触发重载。

pyenv环境的影响排查 #

pyenv本身不会导致该问题，但需确认两点：

• 执行pip install -e .和python -m thing.app.main用的是同一个pyenv环境，避免跨环境的模块引用混乱。
• 用pip show thing查看Location字段，确认指向的是你的项目源码目录，而非pyenv的site-packages下的静态拷贝。

用extra_files实现重载的正确姿势 #

要让extra_files生效，需满足两个条件：开启调试模式，且传入所有需要监控的文件的绝对路径。示例代码如下：

# thing/app/main.py
import connexion
from pathlib import Path

# 定位项目根目录（适配setup.py所在层级）
PROJECT_ROOT = Path(__file__).parents[2]

# 递归收集项目下所有Python文件
extra_files = [str(p.resolve()) for p in PROJECT_ROOT.rglob("*.py")]
# 若需监控其他类型文件（如swagger.yml、配置文件），可追加路径
extra_files.append(str(PROJECT_ROOT / "swagger.yml"))

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

if __name__ == "__main__":
    # 必须开启debug模式，Flask重载仅在此模式下生效
    app.run(port=5000, debug=True, extra_files=extra_files)

替代方案与watchdog的适用场景 #

• 最简替代：直接从项目根目录执行python thing/app/main.py启动，而非python -m。此时Flask默认监控当前目录下的文件，配合pip install -e .的可编辑模式，无需额外配置即可触发重载。
• 当需要监控非Python文件，或extra_files方案仍失效时，可使用watchdog实现自定义监控：
  1. 安装依赖：pip install watchdog
  2. 编写监控脚本，监听项目目录的文件变更事件，触发应用重启；也可使用flask-watchdog等封装库简化操作（需注意与Connexion的兼容性）。

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