Linkerd重试功能失效求助：ServiceProfile配置后无重试行为

核心问题分析 #

Linkerd的重试逻辑由**发起请求的客户端侧代理（api-gateway的sidecar）**执行，而非服务端（report的sidecar）。你的场景中，服务端代理已匹配到路由，但客户端代理未匹配，这是重试不触发的关键原因。

具体排查与修复步骤 #

1. 验证ServiceProfile名称与目标服务FQDN匹配 #

ServiceProfile的name必须严格等于目标服务的完全限定域名（FQDN），格式为{service-name}.{namespace}.svc.cluster.local：

• 执行命令确认report服务的实际名称：

  kubectl get svc -n test-linkerd
  

• 对比ServiceProfile的name字段，确保与服务FQDN完全一致（当前配置为report.test-linkerd.svc.cluster.local，但linkerd viz routes输出中服务显示为portfolio-report，这里可能存在服务名称混淆，需重点确认）。

2. 确认客户端请求的目标地址 #

api-gateway必须直接请求目标服务的FQDN（如report.test-linkerd.svc.cluster.local），若使用短名report，需确保Kubernetes DNS正常解析，且无其他别名或服务路由干扰。

3. 检查客户端代理是否加载了ServiceProfile #

执行命令查看api-gateway的sidecar是否加载了目标服务的ServiceProfile：

linkerd diagnostics proxy-config -n test-linkerd deploy/api-gateway | grep -A 10 -B 5 "ServiceProfile"

若未找到对应配置，重新应用并等待sidecar刷新：

kubectl apply -f serviceprofile.yaml -n test-linkerd
sleep 30

4. 确认重试触发的错误场景 #

Linkerd仅对可重试错误触发重试，包括：

• 5xx状态码响应
• 连接超时、重置（如Pod终止时的连接关闭）
• 请求超时
  模拟场景时，需确保请求确实返回上述可重试错误，而非客户端提前断开连接。

5. 调整客户端请求超时 #

代理日志中的connection closed before message completed表明客户端（api-gateway）提前关闭了连接，可能是因为请求超时设置过短，短于Linkerd的重试TTL（当前配置为10s）。需调整api-gateway的请求超时时间，确保长于重试TTL。

6. 重新验证路由匹配 #

完成调整后，重新执行路由查看命令，确认客户端侧路由已匹配：

linkerd viz routes --to deploy/report -n test-linkerd -o wide deploy/api-gateway

若路由的ACTUAL_SUCCESS、ACTUAL_RPS等指标有数据，说明路由已正常匹配，重试机制可正常工作。

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