使用Flask-SQLAlchemy结合GCP TLS数据库连接器时遇属性错误如何解决？

问题分析 #

你遇到的AttributeError: 'dict' object has no attribute '_instantiate_plugins'错误，是因为Flask-SQLAlchemy 2.5.1在处理SQLALCHEMY_BINDS中的字典配置时，会将你传入的URL对象（由make_url生成）转换为字典结构，导致后续SQLAlchemy调用create_engine时，接收到的不是预期的URL对象而是字典，从而触发异常。

解决方法 #

直接使用SQLAlchemy的create_engine创建带有creator参数的引擎实例，将该实例直接赋值给SQLALCHEMY_BINDS的对应绑定键，绕开Flask-SQLAlchemy对URL的解析逻辑。

修改后的代码示例 #

...

from flask_sqlalchemy import SQLAlchemy
from google.cloud.sql.connector import Connector, IPTypes
import pg8000
from sqlalchemy import create_engine  # 新增导入

...   

db: SQLAlchemy = SQLAlchemy()

def create_web_app():
    app = Flask('ex')
    ...

    ip_type = IPTypes.PUBLIC
    connector = Connector()

    def getconn() -> pg8000.dbapi.Connection:
        conn: pg8000.dbapi.Connection = connector.connect(
            app.config["GCPTSLPROTECTED_INSTANCE_CONNECTION_NAME"],
            "pg8000",
            user=app.config["GCPTSLPROTECTED_DB_USER"],
            password=app.config["GCPTSLPROTECTED_DB_PASS"],
            db=app.config["GCPTSLPROTECTED_DB_NAME"],
            ip_type=ip_type,
        )
        return conn

    # 直接创建引擎实例
    gcp_engine = create_engine(
        "postgresql+pg8000://",
        creator=getconn
    )

    # 将引擎实例赋值给绑定
    app.config["SQLALCHEMY_BINDS"] = {
          "gcptslprotected": gcp_engine
    }

    ...
    app.config['SQLALCHEMY_URI'] = "sqlite:///./tests/data/test.db"
    
    db.init_app(app)
    ...

原理说明 #

通过直接传入引擎实例，Flask-SQLAlchemy会跳过内部的URL解析和引擎创建流程，直接使用你预先配置好的、带有GCP连接器creator的引擎，既保证了GCP自动TLS连接的正常工作，又避免了字典与URL对象转换导致的异常。

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