调试Flask应用时Werkzeug报错No module named run如何排查

• 这个错误是Flask开启调试模式时，Werkzeug自带的自动重载器工作异常导致的。调试模式默认开启代码变更热重载能力：Werkzeug会先启动一个监控进程，检测到文件改动时，就通过你定位到的subprocess.call逻辑拉起新的子进程运行最新代码，销毁旧进程完成重载。非调试模式不会启动这套父子进程机制，直接在当前进程运行应用，所以不会触发该问题。
• 抛出No module named run的直接原因是：重载器构造子进程启动命令时，错误地将run作为待执行的Python模块名，拼接出类似python -m run的启动指令，但当前Python解释器的模块搜索路径中不存在名为run的模块，子进程启动直接失败。
• 绝大多数场景下的触发原因分为两类：
  • 启动路径不匹配：你的应用入口文件名为run.py，但启动应用时的工作目录不是run.py所在的目录，比如在项目上级目录执行python project/run.py启动，重载器解析启动参数时会错误截断路径，仅提取到run作为模块名，又因为当前工作目录不在模块搜索路径中，就无法找到对应模块。
  • 环境变量配置错误：FLASK_APP环境变量被错误设置为run，没有正确指向存储Flask应用实例的文件路径，重载器读取该环境变量构造启动命令时，就会尝试加载不存在的run模块。

• 优先使用Flask官方推荐的启动方式：切换到项目根目录（即入口文件所在的目录）执行flask run命令，提前将FLASK_APP环境变量设置为准确的入口文件路径，比如入口为app.py时就设置为app.py。
• 如果习惯直接执行Python脚本启动，不要跨目录调用入口脚本，先切换到入口文件所在目录再执行启动命令。
• 如果不需要热重载能力，可以在启动时关闭重载器规避该问题，将启动代码修改为app.run(debug=True, use_reloader=False)即可。

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