Flask连接SQLite3报错NameError: connect_db未定义问题排查

跟随Real Python的Discover Flask系列教程学习，未使用SQLAlchemy等第三方ORM工具，通过iPython shell连接SQLite3数据库时触发NameError，报错信息如下：

In [1]: from app import *

In [2]: c = connect_db()
---------------------------------------------------------------------------
NameError                                 Traceback (most recent call last)
Input In [2], in <cell line: 1>()
----> 1 c = connect_db()

NameError: name 'connect_db' is not defined

项目核心逻辑存放于包目录下的__init__.py，配套sql.py用于初始化库表和测试数据，已尝试拼写检查、重启环境、调整函数位置、重建数据库等操作均未解决问题。

核心问题是函数作用域错误：你写的connect_db()是定义在create_app()应用工厂内部的局部函数，仅能在create_app函数内部被访问，根本不会被from app import *导出到模块全局作用域，外部shell调用时自然找不到该名称。
除此之外代码还存在3个隐性问题：

• 存在无效语法行：from app install app为错误导入语句，会直接导致模块导入异常
• 应用工厂模式下未初始化全局app实例，文件底部if __name__ == '__main__'块直接调用app.run()本身就会触发NameError
• 数据库路径配置冲突：同时存在app.database = "sample.db"和app.config['DATABASE']两套路径配置，极易出现连错库的问题

按以下步骤调整代码即可解决：

1. 删除__init__.py中错误的from app install app行
2. 将connect_db移出create_app函数，改为接收app实例参数的全局函数，统一读取配置中的数据库路径，参考实现：

   import sqlite3
   # 其他原有导入保持不变
   
   def connect_db(app):
       db_path = app.config.get('DATABASE', 'sample.db')
       conn = sqlite3.connect(db_path)
       conn.row_factory = sqlite3.Row
       return conn
   
   def create_app(test_config=None):
       # 原有create_app内部逻辑，删除局部定义的connect_db函数
       # 把app.database = "sample.db"这行删掉，统一用config管理路径
       app.config.from_mapping(
           SECRET_KEY='dev',
           DATABASE=os.path.join(os.getcwd(), 'sample.db'), # 和sql.py创建的库路径保持一致
       )
       # 其余原有路由、装饰器逻辑保持不变
       return app
   

3. 修正文件底部的服务启动逻辑，适配工厂模式：

   if __name__ == '__main__':
       app = create_app()
       app.run(debug=True)
   

4. 在iPython shell中按正确流程调用，不要直接用from app import *导全局：

   from app import create_app, connect_db
   app = create_app()
   # 推入应用上下文
   ctx = app.app_context()
   ctx.push()
   # 建立数据库连接
   conn = connect_db(app)
   cur = conn.cursor()
   # 测试查询，验证连接正常
   cur.execute("SELECT * FROM posts")
   print(cur.fetchall())
   # 操作完成后关闭连接、弹出上下文
   cur.close()
   conn.close()
   ctx.pop()
   

你之前尝试调整connect_db在create_app内的位置不生效，是因为只要函数定义在另一个函数内部，不管位置怎么挪，它都是局部函数，外部模块永远无法直接导入调用。

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