如何解决Spring Boot Docker部署时UnsatisfiedDependencyException异常

错误根因说明 #

该报错是Spring Cloud GCP Pub/Sub组件初始化时未获取到有效GCP项目ID导致的自动校验失败。

排查处理方案 #

• 校验依赖必要性
  若你的应用实际不需要使用GCP Pub/Sub能力，直接从build.gradle中移除spring-cloud-gcp-starter-pubsub相关依赖即可跳过该校验，直接解决报错。
• 配置文件中硬编码项目ID
  在应用的application.properties或application.yml中添加项目ID配置：

  # application.properties示例
  spring.cloud.gcp.project-id=gcp-training-01-303001
  

  # application.yml示例
  spring:
    cloud:
      gcp:
        project-id: gcp-training-01-303001
  

• 启动容器时通过环境变量注入
  不想把项目ID写死在配置文件的场景下，可以在启动命令中通过环境变量传递参数，Spring Cloud GCP会自动读取对应变量：

  docker run --rm -p 8080:8080 -e SPRING_CLOUD_GCP_PROJECT_ID=gcp-training-01-303001 gcr.io/gcp-training-01-303001/spring-boot-dockerapp
  

  注意：你原有命令末尾多余的.需要删除，否则会被当作参数传递给应用引发额外问题
• 非GCP环境运行补充配置
  若你是在本地/非GCP云环境运行容器，除配置项目ID外，还需要补充服务账号密钥配置：通过spring.cloud.gcp.credentials.location参数指定密钥文件路径，或者通过GOOGLE_APPLICATION_CREDENTIALS环境变量传递密钥路径。如果是在GKE、Cloud Run等GCP官方资源上运行，只要资源绑定了对应权限的服务账号，组件会自动从环境元数据中拉取项目ID，不需要手动配置。

内容的提问来源于stack exchange，提问作者Vinotha Ramasamy