Azure Spring Apps部署SpringBoot应用遇HttpServerErrorException故障

1. 验证Git仓库配置与文件有效性 #

• 确认Git仓库地址（HTTPS/SSH）正确，私有仓库需检查凭据权限：
  • HTTPS协议：Azure Spring Apps中配置的用户名/密码需拥有仓库读取权限
  • SSH协议：公钥已添加至Git仓库的部署密钥列表
• 检查配置文件路径与命名规则：
  • Spring Cloud Config默认加载tech-service.yml、tech-service-default.yml、application.yml、application-default.yml，需确保仓库内存在对应文件，且search-paths（若配置）指向文件所在目录
  • 本地克隆仓库，验证文件内容无YAML语法错误（如缩进、冒号缺失）

2. 检查Azure Spring Apps Config Server状态 #

• 登录Azure门户，进入目标Spring Apps实例的Config Server页面：
  • 核对uri、label（分支）、search-paths参数，排除拼写错误
  • 查看Config Server运行状态，确认无启动失败或连接异常提示
• 使用Azure CLI验证配置有效性：

  az spring config-server validate --resource-group <你的资源组名> --service <你的Spring Apps实例名>
  

3. 排查应用侧配置细节 #

• 确认应用的spring.application.name配置为tech-service，与请求路径中的应用名匹配
• 若为本地调试或自定义配置，检查spring.cloud.config.uri是否指向Azure Spring Apps的Config Server地址（Azure内部部署无需手动配置，平台自动注入）
• 提取应用启动时的完整日志，查找500错误之外的具体异常信息（如Git仓库访问失败、文件不存在、YAML解析错误）

4. 测试Config Server端点可用性 #

• 直接访问Config Server端点验证返回结果：

  https://<你的Spring Apps实例名>.azuremicroservices.io/config/tech-service/default
  

  若返回错误，根据响应信息定位问题（如404表示文件不存在，401表示权限不足）

5. 确认Spring版本兼容性 #

• 核对Spring Boot与Spring Cloud版本匹配关系：2022.0.3（Kilburn）对应Spring Boot 3.0.x，避免跨版本混用
• 检查应用依赖树，排除Spring Cloud组件版本冲突（可通过mvn dependency:tree或./gradlew dependencies查看）

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