使用Flask-SQLAlchemy连接Google Cloud SQL报错该如何解决？

首次连接报错原因 #

你最初的拼接代码存在占位符与format参数不匹配的问题：URI模板里的占位符是{db_user}、{db_password}、{db_name}，但你调用format时传入的参数名是user、password、database，变量无法正确替换，导致生成的连接URI非法，SQLAlchemy会默认尝试连接本地MySQL，因此抛出2003错误。

第二次报错原因 #

Flask-SQLAlchemy的SQLALCHEMY_DATABASE_URI配置项只接受字符串格式的数据库连接地址，你直接将create_engine生成的Engine对象赋值给该配置项，类型不匹配，因此抛出属性不存在的错误。

方案1：修正初始URI拼接逻辑 #

直接修正format的参数名，和模板占位符一一对应即可，无需调整其他逻辑：

SQLALCHEMY_DATABASE_URI = (
'mysql+pymysql://{db_user}:{db_password}@/{db_name}'
'?unix_socket=/cloudsql/{connection_name}').format(
    db_user=db_user, 
    db_password=db_password,
    db_name=db_name, 
    connection_name=connection_name
)
app.config['SQLALCHEMY_DATABASE_URI'] = SQLALCHEMY_DATABASE_URI

方案2：复用现有URL配置 #

如果你想保留原生创建引擎时的连接池参数，不需要提前创建Engine，只要把生成的URL对象转成字符串赋值给配置项，再把连接池参数放到SQLALCHEMY_ENGINE_OPTIONS即可：

query_string = {"unix_socket": f"/cloudsql/{connection_name}"}
driver_name = 'mysql+pymysql'

# 只生成URL对象，不提前创建Engine
db_url = sqlalchemy.engine.url.URL.create(
    drivername=driver_name,
    username=db_user,
    password=db_password,
    database=db_name, 
    query=query_string
)
# 转字符串赋值给URI配置
app.config['SQLALCHEMY_DATABASE_URI'] = str(db_url)
# 传入连接池配置
app.config['SQLALCHEMY_ENGINE_OPTIONS'] = {
    "pool_size":5,
    "max_overflow":2,
    "pool_timeout":30,
    "pool_recycle":1800
}

配置完成后正常初始化Flask-SQLAlchemy即可：

from flask_sqlalchemy import SQLAlchemy
db = SQLAlchemy(app)

• 本地开发环境需要启动Google Cloud SQL Auth Proxy，才能通过unix_socket路径连接云数据库；本地测试也可以临时改用公网IP的连接格式验证逻辑。
• 确保项目安装了PyMySQL依赖：pip install pymysql

内容的提问来源于stack exchange，提问作者Hikm Nasir