Flask应用搭建后出现ImportError: cannot import name app的问题求助

你的问题根源是循环导入（Circular Import），或者说不合理的应用结构导致的导入顺序错误。当前你把Flask实例app定义在site/views.py里，然后在site/__init__.py中导入它，同时views.py又导入了models.py的内容——如果models.py中存在间接依赖app的逻辑（哪怕你没完全贴出），就会触发循环导入，导致Python无法正确解析app的引用。

修复方案：重构为标准Flask项目结构 #

我们把Flask实例app的创建移到site/__init__.py中，让它成为应用的核心入口，其他模块从这里导入app，从根源上避免循环导入问题。

1. 修改site/__init__.py

把app的初始化逻辑移到这里，同时在app创建完成后再导入视图和模型：

from flask import Flask
import os

# 先初始化Flask实例
app = Flask(__name__)
app.secret_key = os.urandom(24)

# 必须放在app创建之后，避免导入时找不到app
from .views import *
from .models import graph

2. 修改site/views.py

不再自行创建app，而是从当前package导入已初始化的app：

from . import app
from .models import User, get_todays_recent_posts
from flask import request, session, redirect, url_for, render_template, flash

# 保留你所有的路由函数，比如：
@app.route('/')
def index():
    # 你的路由逻辑代码
    return render_template('index.html')

3. 修改run.py

现在直接从site导入配置好的app即可，无需重复设置secret_key：

from site import app

app.run(debug=True)

4. 检查site/models.py

如果models.py需要用到app（比如读取配置），确保从site导入，而非views：

from py2neo import Graph  # 补全你的py2neo导入语句
from . import app

# 示例模型逻辑
graph = Graph(app.config.get('NEO4J_URI', 'bolt://localhost:7687'))

为什么这样能解决问题？ #

通过把app的创建移到package的__init__.py中，我们确保了app在所有其他模块导入之前就完成初始化。视图和模型模块统一从__init__.py导入app，彻底切断了循环引用的可能性。

另外要注意：__init__.py中导入视图、模型的语句必须放在app创建之后，否则还是会出现导入错误。

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