Flask+SQLAlchemy连接PostgreSQL时无法导入'db'的ImportError问题求助

一、导入db失败的原因与修复 #

问题根源 #

你的db对象和Flask应用的初始化代码都被放在了if __name__ == '__main__':代码块中。当你在Python控制台执行from database_functions import db时，这个代码块不会执行（此时模块是被导入而非作为主程序运行），导致db根本没被定义，自然触发ImportError。

修复方案 #

将app和db的初始化逻辑移出if __name__ == '__main__':块，同时采用Flask推荐的延迟初始化方式（先创建db对象，再绑定app），避免后续可能的循环导入问题。修改后的代码如下：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from werkzeug.security import generate_password_hash, check_password_hash
from cryptography.hazmat.primitives import serialization
import psycopg2
import configparser
import jwt
from datetime import datetime

# 先初始化db对象，暂不绑定Flask app
db = SQLAlchemy()

# 模型类定义放在db初始化之后
class SurveyData(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    codigo_do_projeto = db.Column(db.String(250))

if __name__ == '__main__':
    config = configparser.ConfigParser()
    config.read('database.ini')
    # 初始化Flask app
    app = Flask(__name__)
    # 用f-string简化数据库URI拼接，更易读
    app.config["SQLALCHEMY_DATABASE_URI"] = f"postgresql://{config['postgresql']['user']}:{config['postgresql']['password']}@{config['postgresql']['host']}:{config['postgresql']['port']}/survey_platform"
    # 将app绑定到已初始化的db对象
    db.init_app(app)
    
    # 若需要自动创建数据库表，添加以下代码（需在app上下文内执行）
    with app.app_context():
        db.create_all()

修改后，你在控制台执行from database_functions import db就能成功导入，因为db对象现在是模块级别的变量，无论模块是被导入还是主运行都会被定义。

二、本地未生成数据库文件的说明 #

你期望在项目目录下生成数据库文件，是混淆了不同数据库的特性：

• SQLite是文件型数据库，会在本地生成对应的.db文件；
• PostgreSQL是客户端-服务器架构的数据库，所有数据都存储在PostgreSQL服务器端，不会在你的项目目录下生成本地数据库文件。

验证连接是否成功的方法：

1. 确保PostgreSQL服务正在运行；
2. 运行你的Flask程序后，登录PostgreSQL服务器，检查是否存在survey_platform数据库，以及survey_data表是否被正确创建。

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