排查Dapr服务调用在Azure容器应用中出现500错误的方法

一、先确认基础配置正确性 #

• 核对customers服务的app-id：Azure Container Apps中Dapr的app-id由DAPR_APP_ID环境变量定义，确保调用代码里的"customers"和目标服务的该变量值完全匹配（大小写敏感）。
• 验证目标服务可用性：直接访问customers服务的health-check端点（通过Azure Container Apps公网URL或内部域名），确认服务自身未抛出500错误——本地正常不代表部署后依赖（如数据库、环境变量）无问题。

二、开启Dapr Debug日志（核心排查步骤） #

在Azure Container Apps中配置Dapr日志级别：

1. 进入目标Container App的配置页，找到环境变量设置项
2. 添加或修改DAPR_LOG_LEVEL为debug
3. 重启服务后，在Azure Portal的日志面板中，用查询语句AppType="dapr-sidecar"筛选Dapr sidecar日志
4. 重点关注：
   • 服务发现日志，确认Dapr能否找到customers服务实例
   • 请求链路日志，查看请求在sidecar间传递时的异常细节
   • 目标服务sidecar是否接收到请求，以及转发至应用时的错误信息

三、检查服务调用的细节配置 #

• 确认HTTP方法与路由匹配：代码中使用HttpMethod.Get调用"health-check"，需确保customers服务的该端点确实为GET方法，且路由无额外前缀（同时确认DAPR_APP_PORT配置的端口与应用监听端口一致）。
• 核对Dapr通信协议：若服务使用gRPC而非HTTP，需在调用时指定协议，或确保sidecar配置兼容。

四、排查应用自身日志 #

• 查看customers服务的应用日志：确认health-check端点的logger.LogInformation("health check called")是否有输出，若无则说明请求未到达应用，问题出在Dapr转发或服务发现环节；若有日志仍返回500，则需排查应用内部异常（如缺失环境变量、依赖服务不可用等）。

五、验证网络与Dapr启用状态 #

• 确认服务处于同一环境：Azure Container Apps内部服务发现仅在同一Environment内生效，若orders与customers分属不同环境，需配置VNet peering或改用外部访问。
• 检查Dapr启用状态：两个服务均需开启Dapr功能，在Container App配置页确认"Dapr enabled"为开启状态。

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