Spring Boot连接GCP MySQL报连接失败与应用默认凭证缺失异常求助
Spring Boot连接GCP Cloud SQL(MySQL)连接异常排查
异常现象
应用启动运行阶段抛出数据库连接失败错误,核心报错栈如下:
java.sql.SQLNonTransientConnectionException: Could not create connection to database server. Caused by: java.io.IOException: The Application Default Credentials are not available. They are available if running in Google Compute Engine. Otherwise, the environment variable GOOGLE_APPLICATION_CREDENTIALS must be defined pointing to a file defining the credentials
现有配置信息
当前application.properties中与GCP MySQL相关的配置(敏感参数已做隐写处理):
spring.cloud.gcp.sql.database-name=DemoDatabase spring.cloud.gcp.sql.instance-connection-name=xxxxxxxxxxx spring.datasource.initialization-mode=always spring.cloud.gcp.credentials.location=C:/Users/utkar/Downloads/spring-boot-7208e0222fb1.json spring.datasource.url=jdbc:mysql://google/DemoDatabase?cloudSqlInstance=XXXXXXXXXXX&socketFactory=com.google.cloud.sql.mysql.SocketFactory&useSSL=false spring.datasource.username=XXXXX spring.datasource.password=XXXXXX
常见排查修正方向
- 修复凭证文件路径的配置格式:Windows本地环境下配置凭证文件位置时,必须给路径加上
file:协议前缀,正确格式为file:C:/Users/utkar/Downloads/xxx.json;不加前缀时Spring会默认从类路径下查找资源,识别不到磁盘上的json凭证文件,直接跳过自定义凭证加载,触发“应用默认凭证不存在”的报错 - 核对实例连接名的一致性:配置项
spring.cloud.gcp.sql.instance-connection-name、JDBC URL中的cloudSqlInstance参数,二者值必须完全匹配GCP控制台内Cloud SQL实例的连接字符串(格式为项目ID:部署区域:实例名称),避免因实例标识不匹配导致连接通道建立失败 - 确认依赖完整性:需引入和Spring Boot版本匹配的
spring-cloud-gcp-starter-sql-mysql依赖包,该依赖会自动引入Cloud SQL SocketFactory与认证逻辑的相关实现,避免类加载缺失导致凭证读取失败 - 校验服务账号权限:确认json凭证对应的GCP服务账号,已经被授予Cloud SQL Client角色的基础访问权限,避免出现凭证合法但权限不足、连接被拦截的问题
- 临时验证方案:修改配置后仍无法连接时,可临时设置系统环境变量
GOOGLE_APPLICATION_CREDENTIALS为凭证文件的完整绝对路径,重启应用验证连接可用性,快速区分是配置加载逻辑问题还是权限、网络层面的问题
内容的提问来源于stack exchange,提问作者Utkarsh Sharma
相关产品推荐
相关产品推荐

