Flask应用导入不一致问题求助：运行时router未定义

这问题我之前帮好几个开发者排查过，核心就是**Python模块搜索路径（sys.path）**在不同运行场景下的差异导致的。咱们一步步拆解原因和解决方案：

问题根源分析 #

你提到测试时能正常导入src.router，但直接运行app.py就报错NameError: name 'router' is not defined，结合你用dir()看到的模块差异，本质是两种运行方式下Python的模块搜索路径不一样：

• 运行测试时：比如用pytest这类测试框架，默认会自动把项目根目录添加到sys.path里，所以from src.router...能正确找到模块。
• 直接运行app.py时：如果你的工作目录不是项目根目录（比如在项目父目录下执行python project/app.py），或者Python没有把项目根目录加入搜索路径，就会找不到src模块，进而导致导入失败。

具体解决方案 #

1. 确保运行时的工作目录是项目根目录 #

这是最简单的解决方式：

• 打开终端，切换到你的项目根目录（也就是app.py所在的目录）
• 执行命令：python app.py

2. 手动将项目根目录添加到sys.path #

如果经常需要在不同目录下运行app.py，可以在app.py的最开头添加这段代码，强制把项目根目录加入搜索路径：

import sys
from pathlib import Path

# 获取app.py所在的目录（即项目根目录）
project_root = Path(__file__).parent
# 将项目根目录添加到模块搜索路径
sys.path.append(str(project_root))

# 之后再导入Flask和router
from flask import Flask
from src.router import ...  # 你的导入语句

3. 使用Python的-m参数以模块方式运行 #

这种方式更符合Python的模块规范，也能避免路径问题：

• 切换到项目根目录
• 执行命令：python -m app（注意这里不要加.py后缀）
  用-m参数运行时，Python会自动把当前工作目录（项目根目录）加入sys.path，导入逻辑和测试环境保持一致。

验证方法 #

你可以在app.py里添加一行代码，查看当前的sys.path，对比测试和直接运行时的差异：

import sys
print("当前sys.path:", sys.path)

这样就能直观看到两种场景下搜索路径的不同，确认问题所在。

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