配置Alembic对接Google Cloud Spanner时遇错误求助

1. 确认依赖安装与版本兼容 #

首先确保安装正确的SQLAlchemy Spanner方言包，且版本与SQLAlchemy、Alembic匹配：

• 安装命令：pip install sqlalchemy-spanner（PyPI官方维护包）
• 版本对应规则：
  • SQLAlchemy 2.x → sqlalchemy-spanner ≥ 1.4.0
  • SQLAlchemy 1.3.x → sqlalchemy-spanner ≤ 1.3.0
  • Alembic版本建议与SQLAlchemy版本同步（如Alembic 1.12+适配SQLAlchemy 2.x）

2. 修正数据库URL格式 #

spanner+spanner:///格式会触发KeyError，正确URL仅需单spanner前缀：

# alembic.ini 中正确配置
sqlalchemy.url = spanner:///projects/<project-id>/instances/<instance-id>/databases/<database-id>

或在env.py中设置：

config.set_main_option("sqlalchemy.url", "spanner:///projects/<project-id>/instances/<instance-id>/databases/<database-id>")

3. 强制触发方言注册 #

若自动注册失效，在env.py最顶部添加代码强制触发方言注册：

# 方式1：直接导入方言模块
from google.cloud.sqlalchemy_spanner import SpannerDialect

# 方式2：手动注册方言注册表
from sqlalchemy.dialects import registry
registry.register("spanner", "google.cloud.sqlalchemy_spanner", "SpannerDialect")

注：你之前用的spanner.spanner是错误的方言标识，应仅用spanner

4. 用虚拟环境隔离依赖干扰 #

如果旧环境残留问题，创建全新虚拟环境测试：

# 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows

# 安装指定版本依赖
pip install sqlalchemy==2.0.23 alembic==1.12.1 sqlalchemy-spanner==1.4.0

之后重新执行alembic init alembic初始化配置，再测试连接。

5. 先验证纯SQLAlchemy连接 #

排除Alembic干扰，先用纯SQLAlchemy代码确认连接与方言正常：

from sqlalchemy import create_engine

engine = create_engine("spanner:///projects/<project-id>/instances/<instance-id>/databases/<database-id>")
with engine.connect() as conn:
    result = conn.execute("SELECT 1")
    print(result.fetchone())

如果这段代码能运行，说明问题出在Alembic配置；若报错，重点排查方言安装或URL格式。

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