👨💻 Google Cloud 故障排查：Cloud SQL 数据库连接失败的常见排查方法
在使用 Google Cloud Platform（GCP）中的 Cloud SQL 数据库时，偶尔会遇到连接失败的问题。出现这种情况可能由多种原因引起。以下是一些高效实用的排查方法，助你快速定位并解决问题：
1. 🔒 检查网络访问权限（Authorized Networks）
- 在 Cloud SQL 控制台中，确认你的客户端 IP 地址已经被添加到数据库实例的“授权网络”列表中。
- 如果你使用的是 Google Cloud 内部服务（如 Compute Engine、GKE），确保其所在的 VPC 网络已被授权。
- 避免使用
0.0.0.0/0 （开放所有 IP），这样会带来安全风险。
2. 🛡️ 检查防火墙设置
- 确保 Google Cloud 的 VPC 防火墙规则允许从你的客户端主机访问 Cloud SQL 实例的端口（MySQL 默认 3306，PostgreSQL 默认 5432，SQL Server 默认 1433）。
- 对于 Cloud SQL Proxy 方式，可以不用担心端口问题，但需要保证本地能访问 proxy 程序。
3. 👤 校验用户账号和权限
- 确认你正在使用正确的数据库用户名和密码。
- 验证该用户有权从你的客户端地址进行连接（有些数据库需要显式授权 host）。
- 检查账户是否被锁定或密码已过期。
4. 🌍 确认实例连接信息
- 核对你填入的 实例连接名称 或 IP 地址 是否正确。
- 区分内部 IP 和公共 IP，如果使用内部 IP，客户端必须和数据库实例处于同一个 VPC 网络下。
5. 📦 使用 Cloud SQL Auth Proxy（推荐）
- 通过 Cloud SQL Auth Proxy 连接可以减少网络和授权配置的复杂度，同时提升安全性。
- 确保代理程序已成功启动，并查看代理的日志，有无报错信息。
6. 🔄 数据库实例状态检查
- 在控制台确认 Cloud SQL 实例处于 RUNNABLE（运行中）状态，没有正在维护、升级或重启。
- 若刚创建/重启，稍等片刻再尝试连接。
7. 📝 查看错误日志与消息
- 阅读 Cloud SQL 实例的 操作日志 与 错误日志，查找有关连接失败的相关信息。
- 遇到常见报错如
Access denied、Timed out 或 Too many connections 时，根据提示修正。
8. ⏳ 检查连接数限制
- 如果收到
Too many connections 错误，说明数据库连接数已达上限。
- 可适当提高最大连接数，或优化应用程序的连接池策略，防止泄漏未关闭的连接。
9. ⚡ 服务账户与 IAM 权限
- 如通过 Cloud SQL Proxy 或 GCP 服务直接访问，需绑定合适的服务账户，并授予 Cloud SQL Client 权限。
10. 📚 参考官方文档 & 社区支持
以上方法能覆盖绝大多数 Cloud SQL 连接失败场景。建议结合实际架构和具体表现有针对性地逐步检查。祝你快速定位问题，恢复服务！🚀
