---
title: 设置请求超时
description: 本任务用于示范如何使用 Istio 在 Envoy 中设置请求超时。
weight: 40
aliases:
    - /zh/docs/tasks/request-timeouts.html
keywords: [traffic-management,timeouts]
owner: istio/wg-networking-maintainers
test: yes
---

本任务用于示范如何使用 Istio 在 Envoy 中设置请求超时。

{{< boilerplate gateway-api-support >}}

## 开始之前 {#before-you-begin}

* 按照[安装指南](/zh/docs/setup/)中的说明安装 Istio。

* 部署示例应用程序 [Bookinfo](/zh/docs/examples/bookinfo/)，
  包括[服务版本](/zh/docs/examples/bookinfo/#define-the-service-versions)。

## 请求超时 {#request-timeouts}

HTTP 请求的超时可以通过路由规则中的 timeout 字段来指定。
默认情况下，超时是禁用的，本任务中，会把 `reviews` 服务的超时设置为半秒。
为了观察效果，还需要在对 `ratings` 服务的调用上人为引入 2 秒的延迟。

1. 将请求路由到 `reviews` 服务的 v2 版本，它会发起对 `ratings` 服务的调用：

{{< tabset category-name="config-api" >}}

{{< tab name="Istio APIs" category-value="istio-apis" >}}

{{< text bash >}}
$ kubectl apply -f - <<EOF
apiVersion: networking.istio.io/v1
kind: VirtualService
metadata:
  name: reviews
spec:
  hosts:
    - reviews
  http:
  - route:
    - destination:
        host: reviews
        subset: v2
EOF
{{< /text >}}

{{< /tab >}}

{{< tab name="Gateway API" category-value="gateway-api" >}}

{{< text bash >}}
$ kubectl apply -f - <<EOF
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: reviews
spec:
  parentRefs:
  - group: ""
    kind: Service
    name: reviews
    port: 9080
  rules:
  - backendRefs:
    - name: reviews-v2
      port: 9080
EOF
{{< /text >}}

{{< /tab >}}

{{< /tabset >}}

2) 给对 `ratings` 服务的调用添加 2 秒的延迟：

{{< tabset category-name="config-api" >}}

{{< tab name="Istio APIs" category-value="istio-apis" >}}

{{< text bash >}}
$ kubectl apply -f - <<EOF
apiVersion: networking.istio.io/v1
kind: VirtualService
metadata:
  name: ratings
spec:
  hosts:
  - ratings
  http:
  - fault:
      delay:
        percentage:
          value: 100
        fixedDelay: 2s
    route:
    - destination:
        host: ratings
        subset: v1
EOF
{{< /text >}}

{{< /tab >}}

{{< tab name="Gateway API" category-value="gateway-api" >}}

Gateway API 尚不支持故障注入，因此我们现在需要使用
Istio `VirtualService` 来添加延迟：

{{< text bash >}}
$ kubectl apply -f - <<EOF
apiVersion: networking.istio.io/v1
kind: VirtualService
metadata:
  name: ratings
spec:
  hosts:
  - ratings
  http:
  - fault:
      delay:
        percentage:
          value: 100
        fixedDelay: 2s
    route:
    - destination:
        host: ratings
EOF
{{< /text >}}

{{< /tab >}}

{{< /tabset >}}

3) 在浏览器中打开 Bookinfo 的网址 `http://$GATEWAY_URL/productpage`，
   其中 `$GATEWAY_URL` 是入口的外部 IP 地址，如
   [Bookinfo](/zh/docs/examples/bookinfo/#determine-the-ingress-ip-and-port)
   文档中所述。

    这时可以看到 Bookinfo 应用运行正常（显示了评级的星型符号），但是每次刷新页面，
    都会有 2 秒的延迟。

4) 现在给对 `reviews` 服务的调用增加一个半秒的请求超时：

{{< tabset category-name="config-api" >}}

{{< tab name="Istio APIs" category-value="istio-apis" >}}

{{< text bash >}}
$ kubectl apply -f - <<EOF
apiVersion: networking.istio.io/v1
kind: VirtualService
metadata:
  name: reviews
spec:
  hosts:
  - reviews
  http:
  - route:
    - destination:
        host: reviews
        subset: v2
    timeout: 0.5s
EOF
{{< /text >}}

{{< /tab >}}

{{< tab name="Gateway API" category-value="gateway-api" >}}

{{< text bash >}}
$ kubectl apply -f - <<EOF
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: reviews
spec:
  parentRefs:
  - group: ""
    kind: Service
    name: reviews
    port: 9080
  rules:
  - backendRefs:
    - name: reviews-v2
      port: 9080
    timeouts:
      request: 500ms
EOF
{{< /text >}}

{{< /tab >}}

{{< /tabset >}}

5) 刷新 Bookinfo 页面。

    这时候应该看到 1 秒钟就会返回，而不是之前的 2 秒钟，但 `reviews` 是不可用的。

    {{< tip >}}
    即使超时配置为半秒，响应仍需要 1 秒，是因为 `productpage` 服务中存在硬编码重试，
    因此它在返回之前调用 `reviews` 服务超时两次。
    {{< /tip >}}

## 理解原理 {#understanding-what-happened}

本任务中，使用 Istio 为对 `reviews` 微服务的调用配置了半秒的请求超时。默认情况下请求超时是禁用的。
`reviews` 服务在处理请求时会接着调用 `ratings` 服务，用 Istio 在对 `ratings`
的调用中注入了两秒钟的延迟，这样就让 `reviews` 服务要花费超过半秒的时间来完成调用，
因此可以观察到超时。

可以观察到，Bookinfo 的页面（调用 `reviews` 服务来生成页面）没显示评论，而是显示了消息：
**Sorry, product reviews are currently unavailable for this book.**
这就是它收到了来自 `reviews` 服务的超时错误信息。

如果看过[故障注入任务](/zh/docs/tasks/traffic-management/fault-injection/)，就会发现
`productpage` 微服务在调用 `reviews` 微服务时，还有它自己的应用级的超时（3 秒）设置。
注意在本任务中使用 Istio 路由规则设置了半秒的超时。如果将超时设置为大于 3 秒（比如 4 秒），
则超时将不会有任何影响，因为这两个超时的限制性更强。更多细节可以参考[这里](/zh/docs/concepts/traffic-management/#network-resilience-and-testing)。

还有一点关于 Istio 中超时控制方面的补充说明，除了像本文一样在路由规则中进行超时设置之外，
还可以进行请求一级的设置，只需在应用的对外请求中加入 `x-envoy-upstream-rq-timeout-ms`
请求头即可。在这个请求头中的超时设置单位是毫秒而不是秒。

## 清理 {#cleanup}

* 删除应用程序的路由规则：

{{< tabset category-name="config-api" >}}

{{< tab name="Istio APIs" category-value="istio-apis" >}}

{{< text bash >}}
$ kubectl delete -f @samples/bookinfo/networking/virtual-service-all-v1.yaml@
{{< /text >}}

{{< /tab >}}

{{< tab name="Gateway API" category-value="gateway-api" >}}

{{< text bash >}}
$ kubectl delete httproute reviews
$ kubectl delete virtualservice ratings
{{< /text >}}

{{< /tab >}}

{{< /tabset >}}

* 如果您不打算探索任何后续任务，请参阅
  [Bookinfo 清理](/zh/docs/examples/bookinfo/#cleanup)的说明关闭应用程序。