Ubuntu下用SQLAlchemy经Cloud SQL Proxy连接GCP PostgreSQL认证失败怎么解决

你可以通过psql正常连接说明Cloud SQL实例、代理、账号密码本身没有问题，报错指向密码认证失败，核心原因集中在Python连接配置、数据库驱动兼容性两个方向，常见具体原因如下：

• 代码中硬编码/读取的密码存在多余空格、特殊字符转义错误、大小写拼写错误
• 未指定sslmode=disable参数，pg8000驱动默认发起SSL认证，和本地代理的无SSL连接逻辑冲突
• pg8000驱动对你的PostgreSQL服务端版本（13.3）的认证协议（比如scram-sha-256）兼容性不足
• 连接URL生成时参数拼接异常

1. 先验证密码正确性
   执行非交互式psql命令确认密码无误：

PGPASSWORD=你的实际密码 psql "host=127.0.0.1 port=5432 sslmode=disable dbname=myDBname user=myUser" -c "SELECT 1;"

如果命令执行成功，排除密码本身错误问题，继续往下排查。

2. 校验代码内密码参数
   打印代码中db_pass变量和生成的连接URL，确认没有多余字符：

# 在创建URL后添加打印逻辑
url = sqlalchemy.engine.url.URL.create(
    drivername="postgresql+pg8000",
    username=db_user,
    password=db_pass,
    host=db_hostname,
    port=db_port,
    database=db_name
)
print("数据库密码：", repr(db_pass))
print("生成的连接URL：", url)

确认密码没有多余的换行、空格，URL参数符合预期。

3. 增加SSL模式配置
   在创建引擎时添加connect_args参数，和psql连接逻辑保持一致关闭SSL：

pool = sqlalchemy.create_engine(
    url,
    connect_args={"sslmode": "disable"},
    **db_config
)

修改后重新运行脚本测试是否可以正常连接。

4. 更换兼容性更好的驱动
   如果上述步骤无效，将pg8000驱动更换为更通用的psycopg2：

• 先安装依赖：pip install psycopg2-binary
• 修改drivername参数：drivername="postgresql+psycopg2"
  重新运行脚本测试，psycopg2作为PostgreSQL官方推荐的Python驱动，对不同版本的认证协议兼容性远好于纯Python实现的pg8000。

5. 极端情况排查
   如果仍然报错，可以登录Cloud SQL控制台查看实例的数据库flag配置，确认没有强制开启客户端SSL、没有修改默认密码认证算法的配置；同时确认cloud_sql_proxy进程运行正常，没有被防火墙限制端口。

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