部署在Google Cloud Run的Ghost连接Cloud SQL MySQL出现通信包读取超时问题

你遇到的报错核心是Ghost内置的Knex数据库连接池配置与Cloud Run/Cloud SQL代理的连接限制不匹配，Knex库本身存在bug的概率极低，按照以下步骤排查修复即可：

1. 优先修正Ghost数据库配置补充Knex连接池参数 #

默认Ghost的Knex连接池配置没有适配无服务器环境的短连接特性，需要在database配置块下新增pool配置，完整配置参考如下：

"database": {
  "client": "mysql",
  "connection": {
    "socketPath": "/cloudsql/xxxxxxx",
    "user": "xxxxxxx",
    "password": "xxxxxxx",
    "database": "ghost1"
  },
  "pool": {
    "min": 0,
    "max": 5,
    "acquireTimeoutMillis": 30000,
    "createTimeoutMillis": 30000,
    "idleTimeoutMillis": 60000
  }
}

• min设为0是因为Cloud Run实例会被自动启停，保持最小连接数为0可以避免残留无效连接
• max设为5是因为单Cloud Run实例的并发数默认较低，过高的连接上限会直接打满Cloud SQL代理的连接配额
• 超时参数拉长到30秒是为了适配Cloud SQL代理首次建立Unix套接字连接的额外耗时

2. 排查Cloud SQL实例的连接限制 #

• 确认你的Cloud SQL实例的最大连接数配置没有被占满，可在Cloud SQL控制台的连接指标页查看实时连接数
• 检查Cloud SQL实例的用户授权是否包含cloudsqlproxy~前缀的主机规则，如果你之前只授权了公网IP段，需要补充允许来自cloudsqlproxy的连接请求，直接将对应用户的host设为%即可覆盖所有代理连接场景

3. 排查Cloud Run侧配置问题 #

• 确认你在Cloud Run连接配置中添加的Cloud SQL实例连接名完全匹配配置文件中socketPath的路径值，格式必须是/cloudsql/项目ID:区域:实例名，不能省略任何一段
• 确认Cloud Run服务的运行服务账号确实拥有目标Cloud SQL实例的Cloud SQL Client角色，注意角色授权需要针对实例本身生效，不要仅授予项目级别的通用权限
• 不要同时配置VPC连接器和Cloud SQL内置连接配置，二选一即可，优先使用Cloud Run内置的Cloud SQL连接能力，不需要额外配置VPC连接器即可通过Unix套接字连接Cloud SQL实例

4. 临时验证方案 #

你可以在Docker镜像中内置mysql客户端，启动时先执行mysql --socket /cloudsql/xxxxxxx -u xxxxxxx -pxxxxxxx ghost1命令验证套接字连通性，排除路径错误、凭据错误等基础问题。

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