From 73d6a4e6296e07a8573558a112ea8ba52d3b5c32 Mon Sep 17 00:00:00 2001 From: Deng Ming Date: Fri, 30 Dec 2022 23:56:31 +0800 Subject: [PATCH] =?UTF-8?q?=E8=B6=85=E6=97=B6=E6=8E=A7=E5=88=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- golang/README.md | 14 ++ golang/goroutine.md | 2 + microservice/README.md | 3 + microservice/availability.md | 8 ++ microservice/img/chain-timeout.png | Bin 0 -> 71989 bytes ...05\346\227\266\346\216\247\345\210\266.md" | 124 ++++++++++++++++++ 6 files changed, 151 insertions(+) create mode 100644 golang/README.md create mode 100644 microservice/README.md create mode 100644 microservice/img/chain-timeout.png create mode 100644 "microservice/\350\266\205\346\227\266\346\216\247\345\210\266.md" diff --git a/golang/README.md b/golang/README.md new file mode 100644 index 0000000..42740d3 --- /dev/null +++ b/golang/README.md @@ -0,0 +1,14 @@ +# Go 语言 + +## 面试题 + +### Go 语言时间精度问题 + +在 Go 语言里面,和时间相关的中间件或者框架都需要注意时间精度的问题。 + +我们用阻塞超时的例子来给大家描述时间精度可能源自哪些方面。例如说,我们在使用并发等待队列的时候,入队的超时时间设置了一秒,那么你究竟什么时候会收到超时错误,是不确定。这是因为: +- 时钟精度。时钟并不能在恰好一秒的时候就发出时钟中断; +- 阻塞:如果 goroutine 本身已经被阻塞了,那么从收到时钟中断,到唤醒 goroutine,到返回超时错误,需要一段时间。在 Go 里面还多了一个开销,就是返回超时错误意味着 goroutine 需要被调度到 P 上面执行。但是如果这个时候 P 忙着处理其它 goroutine,那么这个 goroutine 还需要等待 P 的调度(虽然 goroutine 本身是处于一种可以被调度的状态)。而造成阻塞的原因有很多: + - 和 channel 交互,例如发数据到满了的 channel,或者从一个空的 channel 里面接受数据 + - 竞争锁,别的 goroutine 持有锁一直没有释放,那么 goroutine 就会一直被阻塞 + diff --git a/golang/goroutine.md b/golang/goroutine.md index 09c2a2a..751b725 100644 --- a/golang/goroutine.md +++ b/golang/goroutine.md @@ -93,6 +93,8 @@ PS:煎鱼大佬的文章都很浅显易懂,即便是难题也能说得很容 - 互斥锁忘记解锁 - 同步锁使用不当 +(前面这种回答太干了,你可以加点例子来刷亮点)例如在 RPC 调用,或者数据库查询里面,如果没有设置超时时间,那么大量 goroutine 会被阻塞,直到拿到响应。 + (同样聊排查作为亮点)排查主要用`runtime.NumGoroutine`或者`pprof`工具。`pprof`会返回所有带有堆栈跟踪的`goroutine`列表。 #### 类似问题 diff --git a/microservice/README.md b/microservice/README.md new file mode 100644 index 0000000..178dab6 --- /dev/null +++ b/microservice/README.md @@ -0,0 +1,3 @@ +# 微服务面试题 + +- [超时控制](超时控制.md) \ No newline at end of file diff --git a/microservice/availability.md b/microservice/availability.md index 616e010..da39601 100644 --- a/microservice/availability.md +++ b/microservice/availability.md @@ -1,5 +1,13 @@ # 微服务可用性 +微服务可用性这个部分,也就是通俗意义上说的服务治理部分。大体上在一般人的概念里面,它主要包括: +- 熔断 +- 限流 +- 降级 +- 隔离 +- 重试 +- 超时控制 + ## 面试题目 ### 怎么保证微服务的可用性? diff --git a/microservice/img/chain-timeout.png b/microservice/img/chain-timeout.png new file mode 100644 index 0000000000000000000000000000000000000000..bc96b760049d3ba7b4d0c0397677db888e72982e GIT binary patch literal 71989 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 literal 0 HcmV?d00001 diff --git "a/microservice/\350\266\205\346\227\266\346\216\247\345\210\266.md" "b/microservice/\350\266\205\346\227\266\346\216\247\345\210\266.md" new file mode 100644 index 0000000..52379ed --- /dev/null +++ "b/microservice/\350\266\205\346\227\266\346\216\247\345\210\266.md" @@ -0,0 +1,124 @@ +# 超时控制 + +分析:超时控制在微服务里面,是一个咋一看很容易,但是讨论起来又可以在平凡之中刷出足够亮点的话题。 + +超时控制最基本,也就是大多数人能够想到的超时控制也就是 A 调用 B,然后超时是 3s 这种超时。那么想要把超时控制回答好,那么就需要深入理解这几个话题: +- 为什么要做超时控制?需要举例子说明超时控制没做,会有什么影响; +- 超时控制怎么做?这里面我们会进一步细分单次调用的超时控制,以及在这个基础上的全链路超时控制是如何实现的; +- 超时之后能否中断正在执行的业务逻辑; + +## 面试题 + +### 为什么要做超时控制? +分析:如果单纯从理论上来说,那么可以总结为客户端总是希望在预期的时间内拿到响应的,而不管这个响应是正常响应还是异常响应。那么超时就是为了保证这一点。在超时控制里面还有一种比较特殊的形态,即链路超时控制。例如在 A -> B -> C -> D 的时候在整条链路上设置一个超时时间。例如在起点 A 处设置一个超时时间 1s,那么意味着在 A 收到请求到 A 从 B 中拿到响应的整条链路,超时时间不能超过 1s。这种链路超时控制,也可以看作是为了让调用者在确定的时间段内拿到响应。只不过这个调用者就是用户本身。 + +从另外一个角度来说,超时也是为了节省资源。我们可以预期的是,在超时之后,后续的步骤应该会被中断掉,并且及时释放资源,例如 TCP 连接,数据库连接之类的。 + + +所以总结,超时控制的目标: +- 让调用者能够在预期的时间内拿到响应。而在链路超时控制里面,则是希望用户可以在确定的时间内拿到响应,提升用户体验。 +- 及时释放资源 + +为了增强说服力,可以额外举例子,两种做法带来的后果: +- 例如在 APP 首屏的请求里面设置整个链路超时时间不超过 100ms,这会迫使后端去优化程序性能以满足这种性能要求 +- 缺乏超时控制(或者超时时间设置得不对)会引起资源泄露。例如在微服务调用里面,如果没有超时控制,那么发起调用的 goroutine 会被阻塞,直到拿到响应。又或者在 DB 查询里面,没有超时控制,在数据库性能偶然抖动的情况下,可能导致数据库连接消耗干净,同时引起 goroutine 泄露。 + +注意,这里我们说 goroutine 泄露,是 Go 专属的。Java 之类的语言,依赖的是线程,那么缺乏超时控制会不会导致线程长期阻塞,则取决于语言细节,以及框架的线程模型。 + +可以认为,最基础的回答就是答出两条核心目标,刷亮点则在于解释如果超时控制设置不当会有什么后果。对于 Go 语言开发来说,这也是一个典型的可能引起 goroutine 泄露的场景。 + +答:(基本回答)超时控制一般是为了两件事: +- 确保调用者能够在预期的时间内拿到响应,即便是一个超时响应也好过完全没有响应。例如 APP 首页等关键 API 上,在链路超时控制(这里是一个引导,因为面试官可能接下来就是面你链路超时控制机制了)里面,设置整条链路的超时时间不超过 100ms。 +- 及时释放资源。例如在 RPC 调用里面或者数据库查询里面,设置超时时间。如果没有设置的话,那么 goroutine 或者连接之类的东西一直被占用,引起资源泄露,即 goroutine 泄露或者连接无法被复用(在这个地方要小心,如果面试官捕捉到了 goroutine 泄露这几个关键字,那么可能会进一步考察 goroutine;如果面试官捕捉到了连接复用几个关键字,那么可能会进一步面连接复用的原理)。 + +#### 类似问题 +- 超时如果没有设置,或者值没有设置好,会出现什么问题?要注意,超时没设置,或者设置过长,会浪费资源,典型例子就是 goroutine 长时间得不到释放(或者 TCP 链接长时间被占用)。但是过短也不行,因为过短意味着你会经常超时,而没有办法拿到正常的响应 + + +### 如何计算超时时间? +分析:这个问题是指,假如说你要发起一个 RPC 调用,A->B,那么设置多长的超时时间比较好。这个东西,要从两个角度考虑: +- 从用户体验的角度考虑 +- 从开发者的角度 + +从政治正确的角度来说,那么肯定是从用户体验的角度来考虑的。也就是说如果产品经理觉得用户只能等待一秒,那么意味着你的接口的超时时间就应该是一秒。一秒内,不管你有没有处理完毕,拿到正常的响应,你都要明确告诉用户。也就是用户体验上的一个原则:一个坏消息都好过没有消息。这也就是说,超时时间完全不是由我们研发人员控制的,而是纯粹的一种用户体验设计上的事情。 + +当时实际上,受制于产品经理的水平,以及技术架构的缺陷,我们并不能总是站在用户体验的角度考虑超时时间。这种情况下,超时时间就只能是依赖于研发人员去确认了。 + +对于一个已经上线的接口来说,例如 B。那么 A 调用 B 的超时时间可以设置为 99 线,或者 999 线。这取决于公司的可用性目标。不过有两个值是肯定不能用的,中位数或者平均值。中位数意味着一半的请求会超时,而平均值则是接近一半的请求会超时。 + +对于一个没有上线的接口来说,因为不知道 99 线或者 999 线,那么这个时候就可以通过压测来确定这两个值。如果无法压测,那么只能根据代码来手动分析。例如说如果一个数据库查询大概是 10ms, 而 B 接口发起了三个数据库查询,那么至少要 30ms,从容估算的可以取 100ms。 + +这个东西很像计算限流阈值。所以你可以在面试的时候顺便引导过去限流。应该说,跟响应有关的数据基本上都可以通过这种方式来确定。 + +最后要强调一下超时时间只是一个建议值,例如说设置了1秒钟作为超时时间,那么可能1.2秒才最终超时。这就引申出来时间精确度的问题,时间精确度这个是和语言相关的。 + +答案:计算超时时间可以考虑从两个角度考虑: +- 从用户体验的角度考虑,也是最佳方案(不得不吐槽,这就是政治正确的说法,面试官绝对不敢说不对)。那么可以要求产品经理给出具体的超时参数,比如说用户能够最多容忍这个接口多长时间内返回数据 +- 否则的话,我们研发人员可以考虑自己确定超时时间。如果是调用一个已有的接口,那么可以利用观测到的响应时间数据,选用 99 线或者 999 线来作为超时时间。(稍微刷一下亮点)但是不能选用中位数或者平均值之类的,因为这意味着有相当多的请求会超时。而如果一个接口还没有上线,那么可以考虑压测来确定超时时间(这里你可以稍微提一下,限流的阈值也可以通过压测来确定。那么话题就可能引向限流)。如果连压测也做不了(这并不稀奇,能够随时执行压测的公司是凤毛麟角),那么只能通过代码分析来确定超时时间。例如说 B 接口上有三次数据库查询,如果每次数据库查询的时间是 10ms,那么就可以估计 B 数据库查询就要花掉 30ms,再预留一些 buffer,就可以认为调用 B 的超时时间在 100ms。 + +(如果你记得你使用的语言,或者你面试的语言时间精度问题,就在这里接着刷亮点)大多数时候,我们并不能预期系统或者中间件的超时处理是很精确的,这主要是源于巴拉巴拉(转到讨论不同语言的时间精度问题) + +#### 相关问题 +- 如何确定限流阈值 +- 时间精度问题 + +### 怎么实现超时控制? +分析:一般来说,其实不太会直接问怎么实现超时控制,一般都是问怎么实现链路超时控制。 + +我们的回答也分成两块: +- 和语言相关的进程内超时控制。例如在 Go 里面基本上就是利用 context.Context 来实现进程内超时控制; +- 全链路超时控制; + +重点放在全链路超时控制上。全链路超时控制核心要解决: +- 计算剩余超时时间 +- 跨进程传递剩余超时时间 + +首先我们看一个例子: + +![链路超时](img/chain-timeout.png) + +基本步骤是: +- 客户端最开始的时候,链路超时时间是 3s。一般在 BFF 里面会设置好整个链路的超时时间,而后逐步传递; +- 客户端自己业务花掉了 0.5s,那么链路剩余超时时间就是 (3-0.5) = 2.5s 了; +- 客户端准备发起 RPC 调用,RPC 客户端将剩余超时时间编码进去请求里面,传递到服务端; +- RPC 服务端收到请求之后,发现剩余超时时间是 2.5s,但是网络传输花了 0.5s(怎么知道花了 0.5s),那么剩余超时时间就是 2s; +- RPC 服务端将请求和剩余超时时间都交给用户的业务代码,业务执行花掉 0.5s,那么还剩下 1.5s; +- 接下来,不管服务端要继续调用 RPC 服务,还是要调用 http 接口,都要将 1.5s 继续传递下去; + +所以可以注意到,整个链路超时控制,其实沿着整条调用链路,将剩余超时时间一层一层传递下去,每一个步骤都要严格控制自己的超时时间不能超过整个链路的剩余超时时间。 + +在进程间,或者说跨网络传递超时时间主要依赖于采用的通信协议。例如说如果我们的微服务是依赖于 gRPC 的,那么这个链路剩余超时时间是在 gRPC 底层的 HTTP 头部中传递。而如果我们采用的是 Dubbo 协议,那么链路剩余超时时间是在 Dubbo 协议的 attachment 部分传递的。(虽然 Dubbo 协议本身有一个超时的字段,但是好像并没有用来做链路超时控制,存疑)。如果是其它协议,那么就要看具体的协议设计了。一般来说都是在协议的元数据中传递。如果你知道面试官公司用的是什么协议,那么你可以提前了解一下面试官使用的协议是否支持链路超时控制,如果支持的话,那么它的剩余超时时间是怎么在网络之间传递。 + +在这种超时控制下,还有一个细节,就是客户端调用服务端的时候,谁来控制这个超时? +- 在客户端计时:也就是客户端自己有一个计时器,时间到了就认为超时了,而后不会再管服务端的响应 +- 客户端和服务端同时计时:也就是客户端有一个计时器,时间到了就给用户代码一个超时响应;而服务端也有自己的计时器,如果服务端超时了,那么服务端将直接返回一个超时响应(其实也可以什么响应都不返回,因为服务端可以认为客户端早就已经返回了)。相比之下,因为服务端也维持住了计时器,所以超时之后服务端可以及时释放资源(主要是连接) + +唯一要注意的就是,超时控制是不能仅仅在服务端这边控制的。假如说只在服务端这边有一个计时器,然后超时了,那么服务器返回的超时响应,很可能在半路就丢掉了,而客户端根本没有收到。 + +另外一个问题是传递的超时时间,究竟是什么? +- 第一种传递的方案就是直接传递剩余超时时间,也就是我们在图里面画的,1.5s 这种。不过大多数时候不是直接传这种字符串,而是传数字,例如以毫秒作为的数字。这种方案的缺陷在于难以计算网络传输时间。如果面试问到怎么计算,那么标准答案依旧是测试,在平均请求大小的情况下,完全复刻线上环境,测试两个节点之间通信的延迟。一般来说,除非是跨城市机房通信,或者跨国通信,否则相比超时时间,网络传输时间基本可以忽略笔记; +- 第二种传递的方案就是传递超时时间戳。超时时间戳一般来说传递 64 位数字就可以。但是如果想要使用更少字节来传输,那么可以考虑使用毫秒数,并且该毫秒数不需要从 1970 年开始计数,而是可以用最近的,比如说从 2020 年开始的。这种方案并没有什么缺陷,只不过如果时钟不同步的问题比较严重的话,那么可能导致超时控制不准。但是一般超时时间至少都有几十毫秒,很少有时钟不同步会在几十毫秒这个量级; + +总结起来,如果你想要回答好这个问题,就要讲清楚: +- 链路超时控制的大概流程 +- 链路超时控制在哪一边控制 +- 剩余超时时间是怎么传输的 +- 剩余超时时间在网络中传输,传输的究竟是什么? + +回答: +超时控制大体上分成两种,一种是进程内的超时控制,一种是链路超时控制。进程内的超时控制是和语言相关的,例如说在 Go 里面就是采用了 context.Context 来控制超时。 + +而链路超时比较复杂。(先把整个流程大概说一下)举例来说,在调用链路 A -> B -> C 中,如果 A 设置了整个链路的超时时间是 3s,如果 A 本身花了 0.5s 调用,然后发起调用 B,网络传输花了 0.5s,那么 B 收到请求之后剩余的超时时间就剩下 2s,如果 B 本身花费了 0.5s,而后发起调用 C,如果网络传输也花了 0.5s,那么 C 收到请求之后剩余超时时间只有 1s 了。 + +一般来说,对于不支持链路超时控制的微服务框架来说,它们只需要在客户端维持一个计时器。在超时之后直接返回一个超时响应。而支持链路超时控制的微服务框架,那么可以选择同时在客户端和服务端计时。(这里不要继续回答下去,等面试官问为什么要在服务端也启动一个计时器,核心就是为了释放连接,不需要将相应写回给客户端)。 + +(开始讨论细节,也就是刷亮点了,首先讨论怎么传递链路超时控制)在链路超时控制中,关键的一点是每一次发起调用的时候,都需要计算剩余超时时间,而后将剩余超时时间传递给服务端。(开始展示自己的知识面广)一般来说,RPC 协议里面都会预留一个部分,用于传递链路元数据,链路剩余超时时间就属于链路元数据的一部分。例如在 gRPC 里面,链路剩余超时时间是在 HTTP 协议的头部中传递的。 + +(继续讨论传输的内容)大部分情况下,剩余超时时间都是传递毫秒数,而后服务端收到请求之后减去网络传输时间(这里依旧是引导面试官问怎么确定网络传输时间,也就是在分析中说的,测试,注意要跟面试官强调剩余超时时间一般都很大,那么只要不是跨大陆或者跨国通信,那么基本可以忽略不计),得到的就是服务端剩余超时时间。 + +另外一种做法是传递超时时间戳,(这里是刷亮点)超时时间戳可以选在从 2020 年开始的时间戳,并且以毫秒为单位,这样四个字节就够了。(紧接着继续刷亮点,讨论时钟同步问题)这种方案的隐患在于如果时钟不同步的话,超时控制会不准确(本来就不准确,那么面试官就可能问你为什么超时控制不准确,你就可以看**如何计算超时时间**中的讨论)。不过相比超时时间几百毫秒,时钟不同步的那一点点误差,完全可以忽略不计。 + +#### 相关问题 +- 本地超时控制是怎么做的?如果从本质上来说,都是依赖于时钟中断,剩下的就是不同语言机制就不太一样了 +- 什么是全链路超时控制? +- 怎么在链路中传递超时时间?要回答两个点,不同协议是怎么传的和传递的究竟是什么,注意刷亮点 \ No newline at end of file