使用unix_socket+aiomysql在Cloud Run连接MySQL失败，求排查连接串问题

核心问题分析 #

你的连接串存在参数冲突：同时指定了host/port和unix_socket。使用Unix Socket连接MySQL时，客户端会忽略host和port配置，直接读取指定的socket文件，但SQLAlchemy的URL构造逻辑会因参数冲突导致解析异常，这是连接失败的主要原因。

正确的连接串构建方式 #

移除host和port参数，将unix_socket作为查询参数传入URL.create：

from sqlalchemy.engine import URL

connect_url = URL.create(
    'mysql+aiomysql',
    username=<USER>,
    password=<PASSWORD>,
    database=<BANCO DE DADOS>,
    query={"unix_socket": "/cloudsql/project:region:instance"}
)

对应的原生URL格式为：

mysql+aiomysql://<USER>:<PASSWORD>@/<BANCO DE DADOS>?unix_socket=/cloudsql/project:region:instance

Cloud Run部署的必要配置 #

除了连接串，还需确保以下配置正确：

• 启用Cloud SQL连接：部署Cloud Run服务时，必须添加对应Cloud SQL实例的连接（指定project:region:instance格式的实例名），Cloud Run会自动将socket挂载到容器的/cloudsql目录。
• 服务账号权限：为Cloud Run使用的服务账号分配Cloud SQL Client角色，确保其具备访问Cloud SQL实例的权限。
• 依赖版本兼容：安装兼容版本的依赖包，建议使用sqlalchemy 1.4+和aiomysql 0.10+，确保异步连接逻辑正常运行。

额外排查点 #

• 验证容器内/cloudsql/project:region:instance文件是否存在：可在Cloud Run服务中添加调试命令查看目录内容。
• 检查MySQL用户权限：确保数据库用户允许通过socket连接（默认localhost权限即可覆盖socket连接场景）。

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