<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Claran&apos;s Blog</title><description>Claran 的个人博客，记录后端、Agent 与计算机基础。</description><link>https://www.claran-blog.work/</link><language>zh-CN</language><atom:link href="https://www.claran-blog.work/rss.xml" rel="self" type="application/rss+xml"/><item><title>底层笔记：计算机组成原理</title><link>https://www.claran-blog.work/posts/CO/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/CO/</guid><description>底层P1 - 计算机组成原理学习笔记</description><pubDate>Wed, 15 Jul 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-前言-1&quot;&gt;前言&lt;/h2&gt;&lt;p&gt;暑假开始了，我学习底层的路也开头了。第一部分就是&lt;strong&gt;计算机组成原理&lt;/strong&gt;，也是算是三部曲里最简单的一部分，主要还是啃COD——《计算机组成与设计：硬件/软件接口》这本书，然后没事看看B站上的《计算机科学速成课》扫盲，且学新东西必然的与AI斗智斗勇&lt;/p&gt;
&lt;p&gt;底层还是太有意思了，越学越能感觉到计算机的奇妙，fantastic !&lt;/p&gt;

&lt;h2 id=&quot;article-计组-1&quot;&gt;计组&lt;/h2&gt;
&lt;h3 id=&quot;article-计算机基础-1&quot;&gt;计算机基础&lt;/h3&gt;&lt;p&gt;有些内容作为计算机基础，例如ASCII、计算机组成部件、二进制集成等，不再记录&lt;/p&gt;

&lt;h4 id=&quot;article-二进制与算术运算-1&quot;&gt;二进制与算术运算&lt;/h4&gt;
&lt;h5 id=&quot;article-补码-1&quot;&gt;补码&lt;/h5&gt;&lt;p&gt;一切计算机底层的基础——二进制，作为最实际，也是历史演化而来的一条路，0或1，true or false，不再赘述&lt;/p&gt;
&lt;p&gt;我们知道，一个标准的int类型变量占4个字节（32位），能记录的数值是 2³¹ - 1 到 -2³¹。为什么呢？这是因为补码的特殊计数方式&lt;/p&gt;
&lt;p&gt;在说补码之前，我们先来讲原码：我们知道二进制本身就能表示含语义的十进制数字，例如1101就是13。但是由于晶体管只含有0/1两种语义，那么二进制该怎么保存负数呢？原码是这样解决的：例如对于一个八位二进制，我们把它的最高位定为表示正负的位次，也就是说，该位次的二进制在第八位表示正负，剩下的七位表示数值的绝对值。于是&lt;code&gt;0000 0101&lt;/code&gt;就表示5，而&lt;code&gt;1000 0101&lt;/code&gt;则表示-5。这样一来，这个八位原码能表示的数值就是[&lt;code&gt;1111 1111&lt;/code&gt;-127,&lt;code&gt;0111 1111&lt;/code&gt;127]&lt;/p&gt;
&lt;p&gt;但是原码这样的表示方式也带来了很多问题：&lt;code&gt;0000 0000&lt;/code&gt;和&lt;code&gt;1000 0000&lt;/code&gt;分别表示了同语义的+0和-0，且在做二进制加减法时我们不能直接将两个二进制值相加，也就不能使用通用的加法器解决加减问题，需要做特殊处理，这也会让计算机底层组件成本更高，性能更低&lt;/p&gt;
&lt;p&gt;因此，我们通常使用另一种方式来表示有符号整数——补码。补码的定义是：对于非负数，二进制最高位为0，剩下n-1位为数值；对于负数：表示为2^n-x，即对二进制取反码再+1。这样一来，我们提到的0的语义问题解决了，甚至加减法能用同一套加法器&lt;/p&gt;
&lt;p&gt;为什么呢？我们实际来模拟一下：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;对于5-3，我们视为5+(-3)：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;转化为二进制有 0101 + 1101:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; 0101&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;+1101&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;-----&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;10010 -&amp;gt; 我们把溢出位舍弃，得 0010 = 2，即5-3=2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;同时我们又能发现：-3 = 1101 ，语义上可以理解为最高位-8加上剩余位101 = 5，即-8+5=-3&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;端倪初现：补码就是让符号位MSB和其他bit一起进Carry运算，本质上是模运算的硬件实现&lt;/p&gt;
&lt;p&gt;所以我们能解释int的取值了：最大值为&lt;code&gt;01111111 11111111 11111111 11111111&lt;/code&gt; = 2^31 - 1，最小值为&lt;code&gt;10000000 00000000 00000000 00000000&lt;/code&gt; = -2^31，无符号整型最大值为&lt;code&gt;11111111 11111111 11111111 11111111&lt;/code&gt; = 2^32 - 1&lt;/p&gt;

&lt;h5 id=&quot;article-算术运算-1&quot;&gt;算术运算&lt;/h5&gt;&lt;p&gt;搞清了补码，我们也就弄清了算术运算&lt;/p&gt;
&lt;p&gt;对于加减法，我们直接将二进制相加即可&lt;/p&gt;
&lt;p&gt;对于乘法，通常使用位运算与加法的组合。我们知道位运算中左移一位表示乘二，所以乘法器通常可以通过判断乘数的每一位是否为 1，决定是否把被乘数左移后加到结果中，例如5 * 3 = = 5 * (2 + 1) = = (5 &amp;lt;&amp;lt; 1) + 5 ，看作 &lt;code&gt;0000 0101&lt;/code&gt; = 5 左移一位变为 &lt;code&gt;0000 1010&lt;/code&gt; = 10。但是这样做时间过于复杂，我们可以使用加法树并行来优化，这里先按下不表&lt;/p&gt;
&lt;p&gt;对于除法，类似于乘法，我们在位运算中右移 + 减法即可&lt;/p&gt;

&lt;h3 id=&quot;article-硬件-自底到顶层层抽象-1&quot;&gt;硬件：自底到顶层层抽象&lt;/h3&gt;&lt;p&gt;我们先回到计算机世界最底层的二进制表示，再一层层向上封装抽象，理解 ALU、RAM 和 CPU 的基本组成  &lt;/p&gt;

&lt;h4 id=&quot;article-alu-1&quot;&gt;ALU&lt;/h4&gt;&lt;p&gt;ALU，即算术逻辑单元，负责完成 CPU 中最基础的算术运算和逻辑运算。现在看看我们怎么从底层一步步封装到ALU的&lt;/p&gt;

&lt;h5 id=&quot;article-物理底层-晶体管-1&quot;&gt;物理底层：晶体管&lt;/h5&gt;&lt;p&gt;你只需要知道晶体管这个东西能在物理上实现通过电流表示固定的两种状态，进而实现表示0/1就行了&lt;/p&gt;

&lt;h5 id=&quot;article-逻辑门-1&quot;&gt;逻辑门&lt;/h5&gt;&lt;p&gt;既然说道0/1，就不得不说到布尔代数，这也是所有二进制算法的起点&lt;/p&gt;
&lt;p&gt;布尔代数有三个基本操作：NOT，AND，OR，XOR，它们各自代表的含义我相信不难理解&lt;/p&gt;
&lt;p&gt;我们可以把这些基础操作结合晶体管实现几个基本单元，叫做&lt;strong&gt;布尔逻辑&lt;/strong&gt;，我们不关心具体实现，把这些结构的基础结构进行封装，就有了&lt;strong&gt;逻辑门&lt;/strong&gt;：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/booldor.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
实际上，这是XOR逻辑门的组成原理


&lt;h5 id=&quot;article-半加器和全加器-1&quot;&gt;半加器和全加器&lt;/h5&gt;&lt;p&gt;接下来，我们可以使用逻辑门来构造一个能够执行二进制加法的装置&lt;/p&gt;
&lt;p&gt;最基础的是&lt;strong&gt;半加器&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/halfadder.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
由XOR和AND逻辑门做成的半加器

&lt;p&gt;半加器能够处理两个单位二进制相加的运算，并返回一个单位结果和进位标志&lt;/p&gt;
&lt;p&gt;但是半加器只能将两个单位二进制数加在一起，并不能处理前面有进位的情况，这种情况我们就需要一个&lt;strong&gt;全加器&lt;/strong&gt;，用来计算3个单位二进制数相加的情况：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/fulladder.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
由两个半加器做成的全加器

&lt;p&gt;全加器能够处理三个单位二进制相加的运算，并返回一个单位结果和进位标志&lt;/p&gt;
&lt;p&gt;现在，我们就能处理两位以及三位二进制单位相加的情况了。但是很显然，半加器和全加器都只能够处理单位数的二进制运算，那我们怎么处理多位二进制的运算呢？&lt;/p&gt;
&lt;p&gt;我们把全加器和半加器再进行抽象包装，然后用七个全加器和一个半加器做成一个&lt;strong&gt;8位行波数位加法器&lt;/strong&gt;，简称&lt;strong&gt;加法器&lt;/strong&gt;&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/8bitadder.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
由七个全加器和一个半加器做成一个的8位行波数位加法器

&lt;p&gt;这样的一个算术单元已经能处理两个基本数的运算了&lt;/p&gt;
&lt;p&gt;需要注意的是，如果结果超过8位，会产生overflow（溢出），会导致单元甚至系统出错，我们可以使用更多位的算术单元解决这个问题&lt;/p&gt;

&lt;h5 id=&quot;article-逻辑单元-1&quot;&gt;逻辑单元&lt;/h5&gt;&lt;p&gt;除了加法，CPU 还需要执行各种逻辑判断，例如：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;与运算&lt;/li&gt;
&lt;li&gt;或运算&lt;/li&gt;
&lt;li&gt;异或运算&lt;/li&gt;
&lt;li&gt;取反运算&lt;/li&gt;
&lt;li&gt;判断结果是否为 0&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这些功能可以由逻辑门组合成&lt;strong&gt;逻辑单元&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/logic1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
检查输入是否全为0的逻辑单元


&lt;h5 id=&quot;article-alu-2&quot;&gt;ALU&lt;/h5&gt;&lt;p&gt;我们做把加法器、逻辑单元等单元组合到一起，就能得到一个&lt;strong&gt;ALU，即算术逻辑单元&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/fullALU.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
一个基础ALU

&lt;p&gt;这个ALU可以接收一个操作码并处理两个8位二进制数的基本运算，并判断是否溢出、结果是否为零或者小于零&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/8bitadder.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
基础的ALU包含这8个算术功能


&lt;h4 id=&quot;article-ram-1&quot;&gt;RAM&lt;/h4&gt;&lt;p&gt;解决了运算的问题，接下来我们来看看怎么将数据保存起来，并最终解决RAM，即内存的实现&lt;/p&gt;

&lt;h5 id=&quot;article-锁存器-1&quot;&gt;锁存器&lt;/h5&gt;&lt;p&gt;首先，我们先看看怎么做一个存1位的电路，也就是&lt;strong&gt;锁存器&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;这一块的实现真的很fantastic，可以看看这个视频：&lt;a href=&quot;https://www.bilibili.com/video/BV1EW411u7th?spm_id_from=333.788.videopod.episodes&amp;amp;vd_source=9092b836d715e0b8217104d324e4ce30&amp;amp;p=6&quot;&gt;&lt;strong&gt;计算机科学速成课 | 寄存器 &amp;amp; 内存&lt;/strong&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/and-or-latch.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
AND-OR锁存器的组成原理

&lt;p&gt;这样的一个AND-OR锁存器可以存储一位的二进制信息，但是用“复位”和“设置”来控制锁存器，还是有点复杂，于是我们可以层这个样子：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/gatelatch.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
一个门锁（Gated-latch）

&lt;p&gt;这种结构允许我们用“数据输入”线和“允许写入线”来控制信息存储&lt;/p&gt;
&lt;p&gt;现在，我们又可以把门锁向上抽象，包装为一个不关心细节的整体结构，像这样：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/boxedgatelatch.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
抽象的门锁


&lt;h5 id=&quot;article-寄存器-1&quot;&gt;寄存器&lt;/h5&gt;&lt;p&gt;只存储一位信息并没有什么用处，但如果我们并排放8个锁存器，这样就可以存储8位信息，例如一个8位数字。一组这样的锁存器就叫做&lt;strong&gt;寄存器&lt;/strong&gt;。寄存器能存储一个数字，大小取决于其&lt;strong&gt;位宽&lt;/strong&gt;，现在大多数电脑都使用64位宽的寄存器&lt;/p&gt;
&lt;p&gt;写入寄存器前，要先启用所有锁存器，我们可以用一根线链接所有“允许输入线”，设为 1 ，然后用8条数据线发数据，再将“允许写入线”改为 0 ，这样就可以存储n位信息。例如一个八位寄存器：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/8bitregister.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
一个八位寄存器的结构


&lt;h5 id=&quot;article-矩阵存储-1&quot;&gt;矩阵存储&lt;/h5&gt;&lt;p&gt;问题来了：如果只存8位数字很简单，但如果我们要存64位数字，就需要用到至少129根线；256位要用513根线，大大增加了物理成本&lt;/p&gt;
&lt;p&gt;解决方法是&lt;strong&gt;矩阵&lt;/strong&gt;。在矩阵中，我们不并排放置锁存器，而是做成网格&lt;/p&gt;
&lt;p&gt;我们要存256位数据，就用16x16网格的锁存器，要启用某个锁存器，就打开对应的行线和列线&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/2561.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;并且，我们在锁存器前加一个AND逻辑门，只有当行线和列线均为1，AND门才输出1，这个锁存器才被启用，这样就可以选择使用单个锁存器&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/2562.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;这种行列排列法，用一根“允许写入线”连所有寄存器，并且由于写入数据需要行列线均被打开，能保证每次只有单个锁存器被使用，我们也就可以只用一根“数据传输线”连所有锁存器来存数据。类似地，我们也可以只用一根“允许读取线”从一个指定的锁存器中读取数据&lt;/p&gt;
&lt;p&gt;这样一来，我们只需要用16+16+1+1+1=35条线就能做到256位存储&lt;/p&gt;

&lt;h5 id=&quot;article-多路复用器-1&quot;&gt;多路复用器&lt;/h5&gt;&lt;p&gt;同时，我们可以把一个锁存器所在地位置称为“&lt;strong&gt;地址&lt;/strong&gt;”，例如一个12行8列的锁存器。由于行列数都是16，我们可以使用4位数来表示地址，所以12行8列也可以说成地址&lt;code&gt;1100 1000&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;为了将地址转换成物理上的行和列，我们需要用&lt;strong&gt;多路复用器&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;因为有16行16列，我们使用两个1到16多路复用器：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/dlfyq1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;使用两个这样的多路复用器管理地址后，我们便做成了一个&lt;strong&gt;256位内存&lt;/strong&gt;，于是我们又提升了一个抽象：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/RAM1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-ram-2&quot;&gt;RAM&lt;/h5&gt;&lt;p&gt;可惜的是，即使是256位内存也干不了任何事&lt;/p&gt;
&lt;p&gt;我们可以把这些内存单元并排放置，一行八个，可以存256个8位数字，八位也是一个字节。为了存8位数字，我们同时8个256位内存一样的地址，每个地址存一位，总共能存256字节的数据，这样我们就做成了一个&lt;strong&gt;可寻址内存——RAM&lt;/strong&gt;：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/RAM2.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
可寻址内存

&lt;p&gt;我们再次向上抽象，得到这样的RAM结构：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/RAM3.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
RAM

&lt;p&gt;我们的RAM就这样做出来了&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;内存的一个重要特性就是：可以随时访问任何位置，所以才叫做“&lt;strong&gt;随机存取存储器（Random Access Memory）&lt;/strong&gt;”，即RAM&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;同时，我们使用寄存器这样实现RAM叫做&lt;strong&gt;SRAM&lt;/strong&gt;，即静态随机存取存储器&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-cpu-1&quot;&gt;CPU&lt;/h4&gt;&lt;p&gt;之前，我们设计并实现了加法器、ALU、寄存器、RAM等部件，现在我们来看看怎么用这些部件构建一个中央处理单元——CPU&lt;/p&gt;
&lt;p&gt;首先我们要知道，程序由一个个操作组成，这些操作叫做“指令”。如果是数学指令，例如加减乘除，CPU会让ALU进行数学运算；也可能是内存指令，CPU会和内存通信，然后读/写值&lt;/p&gt;
&lt;p&gt;现在我们来构建CPU，推荐视频：&lt;a href=&quot;https://www.bilibili.com/video/BV1EW411u7th?spm_id_from=333.788.videopod.episodes&amp;amp;vd_source=9092b836d715e0b8217104d324e4ce30&amp;amp;p=7&quot;&gt;&lt;strong&gt;计算机科学速成课 | 中央处理器(CPU)&lt;/strong&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-cpu的构成-1&quot;&gt;CPU的构成&lt;/h5&gt;&lt;p&gt;首先，我们使用上次搓的RAM，&lt;strong&gt;再加上4个寄存器A、B、C、D&lt;/strong&gt;存储临时数据，用来实现CPU执行内存指令的操作&lt;/p&gt;
&lt;p&gt;然后，我们给CPU支持的所有指令分配一个ID，叫做指令表。例如&lt;code&gt;0010&lt;/code&gt;表示&lt;code&gt;LOAD_A&lt;/code&gt;，将当前地址的内存值放进寄存器A中：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/CPU1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
一个简单的指令表

&lt;p&gt;然后，我们还需要两个寄存器来完成CPU：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;其一，用一个寄存器跟踪程序运行到哪里了，我们叫它“&lt;strong&gt;指令地址寄存器&lt;/strong&gt;”，用来存当前指令的内存地址&lt;/li&gt;
&lt;li&gt;其二，用一个寄存器存当前指令，叫“&lt;strong&gt;指令寄存器&lt;/strong&gt;”&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;最终结构是这样的：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/CPU2.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
CPU执行内存指令的基础构成


&lt;h5 id=&quot;article-cpu的运行-1&quot;&gt;CPU的运行&lt;/h5&gt;&lt;p&gt;当启动计算机时，所有寄存器从0开始&lt;/p&gt;
&lt;p&gt;然后，CPU进入这些阶段：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;首先，进入“取指令阶段”，CPU将“指令地址寄存器”连到RAM，把RAM里的值复制到“指令寄存器”里&lt;/li&gt;
&lt;li&gt;然后，来到“解码阶段”，分析指令寄存器里的值，并把值转换成操作码和数据，并进一步把操作码映射成指令&lt;/li&gt;
&lt;li&gt;接下来，来到“执行阶段”，执行指令对应的操作&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;我们可以把CPU内部控件，除了四个寄存器以外的部件都进行抽象包装，得到这样的结构：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/CPU3.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;同时，对于一些需要计算的指令，如ADD，我们需要将ALU集成到CPU中进行运算：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/CPU4.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-cpu时钟-1&quot;&gt;CPU时钟&lt;/h5&gt;&lt;p&gt;CPU循环的运行还需要CPU时钟的操控，时钟负责管理CPU的节奏，以精确的间隔触发电信号，而控制单元会用这个电信号推进CPU的内部操作&lt;/p&gt;
&lt;p&gt;CPU“取指令 -&amp;gt; 解码 -&amp;gt; 执行”的速度叫“时钟速度”，单位是赫兹Hz&lt;/p&gt;
&lt;p&gt;CPU组成 - 指令集 - CPU循环 - 时钟/赫兹&lt;/p&gt;
&lt;p&gt;加上CPU时钟后，我们便构建了一个完整的CPU：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/CPU4.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
一个完整的CPU组成


&lt;h3 id=&quot;article-机器码-汇编语句与指令集-1&quot;&gt;机器码、汇编语句与指令集&lt;/h3&gt;&lt;p&gt;我们说到，CPU可以执行特定指令，这个指令就是机器码，不同的机器码代表不同的指令，例如“将寄存器A与寄存器B的值相加并吧结果存在寄存器A里”&lt;/p&gt;
&lt;p&gt;但是，机器码是一串二进制数据，直接由人来书写和阅读都非常困难。因此，人们设计了汇编语言，并通过汇编器把可读的汇编语句转换成机器码。例如&lt;code&gt;0001 1111&lt;/code&gt;，我们可以设计机器码的前4位表示操作行为，后4为表示数值，如果 0001 表示 LOAD B，而 1111 表示地址 15，那么这条机器码就可以表示 &lt;code&gt;LOAD B, 15&lt;/code&gt;，即将 RAM 里地址为 15 的复制值到寄存器 B 里&lt;/p&gt;
&lt;p&gt;这就是汇编语句，是机器码的人类可读写法，而指令集 ISA 就是 CPU 支持的所有机器指令的集合。不同指令集有各自不同的机器码格式，也通常有不同的汇编语法&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;操作含义&lt;/th&gt;
&lt;th&gt;x86 / x86-64&lt;/th&gt;
&lt;th&gt;ARM / AArch64&lt;/th&gt;
&lt;th&gt;MIPS&lt;/th&gt;
&lt;th&gt;RISC-V&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;数据移动&lt;/td&gt;
&lt;td&gt;&lt;code&gt;mov eax, ebx&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;mov x0, x1&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;move $t0, $t1&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;mv x5, x6&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;加法&lt;/td&gt;
&lt;td&gt;&lt;code&gt;add eax, ebx&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;add x0, x1, x2&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;add $t0, $t1, $t2&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;add x5, x6, x7&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;减法&lt;/td&gt;
&lt;td&gt;&lt;code&gt;sub eax, ebx&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;sub x0, x1, x2&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;sub $t0, $t1, $t2&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;sub x5, x6, x7&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;乘法&lt;/td&gt;
&lt;td&gt;&lt;code&gt;imul eax, ebx&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;mul x0, x1, x2&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;mul $t0, $t1, $t2&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;mul x5, x6, x7&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;除法&lt;/td&gt;
&lt;td&gt;&lt;code&gt;idiv ebx&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;sdiv x0, x1, x2&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;div $t1, $t2&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;div x5, x6, x7&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;读取内存&lt;/td&gt;
&lt;td&gt;&lt;code&gt;mov eax, [ebx]&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ldr x0, [x1]&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;lw $t0, 0($t1)&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;lw x5, 0(x6)&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;写入内存&lt;/td&gt;
&lt;td&gt;&lt;code&gt;mov [ebx], eax&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;str x0, [x1]&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;sw $t0, 0($t1)&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;sw x5, 0(x6)&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;比较&lt;/td&gt;
&lt;td&gt;&lt;code&gt;cmp eax, ebx&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;cmp x0, x1&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;slt $t0, $t1, $t2&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;slt x5, x6, x7&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;无条件跳转&lt;/td&gt;
&lt;td&gt;&lt;code&gt;jmp label&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;b label&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;j label&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;j label&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;条件跳转&lt;/td&gt;
&lt;td&gt;&lt;code&gt;je label&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;beq label&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;beq $t0, $t1, label&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;beq x5, x6, label&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;函数调用&lt;/td&gt;
&lt;td&gt;&lt;code&gt;call func&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;bl func&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;jal func&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;jal ra, func&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;函数返回&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ret&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ret&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;jr $ra&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;ret&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;blockquote&gt;
&lt;p&gt;不同指令集的汇编语法差异很大。比如 x86 常见写法是“目标在前，来源在后”，而 MIPS、RISC-V 这类 RISC 指令集通常采用“三操作数格式”，也就是 操作 目标, 来源1, 来源2。&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3 id=&quot;article-cpu流水线-1&quot;&gt;CPU流水线&lt;/h3&gt;
&lt;h4 id=&quot;article-概述-1&quot;&gt;概述&lt;/h4&gt;&lt;p&gt;我们前面提到过CPU的运行原理，而在实际上，CPU还会使用&lt;strong&gt;流水线&lt;/strong&gt;提高指令吞吐率&lt;/p&gt;
&lt;p&gt;单周期处理器中，一条指令必须完整走完取指、译码、执行、访存、写回之后，下一条指令才开始。流水线把一条指令的执行过程拆成多个阶段，让多条指令同时处在不同阶段中，就像生产线一样&lt;/p&gt;
&lt;p&gt;流水线把指令执行拆成若干阶段，例如：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;text&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;IF -&amp;gt; ID -&amp;gt; EX -&amp;gt; MEM -&amp;gt; WB&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;ul&gt;
&lt;li&gt;&lt;code&gt;IF&lt;/code&gt;：Instruction Fetch，取指。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;ID&lt;/code&gt;：Instruction Decode / Register Read，译码和读寄存器。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;EX&lt;/code&gt;：Execute，执行 ALU 运算或计算地址。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;MEM&lt;/code&gt;：Memory Access，访问数据存储器。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;WB&lt;/code&gt;：Write Back，写回寄存器&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;而对于一条完整的CPU循环，需要顺序执行这五个操作，我们假设每个操作需要一个CPU时间，那么一个完整CPU循环需要5个时间，这不符合我们对高性能的需求。同时，我们注意到，循环中每个阶段涉及到的硬件是不同的，那么意思就是说，我们可以在同一时间安排不同循环的多个阶段一起工作，就像这样：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/lsx.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
一个单周期、非流水线的指令执行过程（上）
一个流水线的指令执行过程（下）

&lt;p&gt;这样一来，当我们使用流水线后，原来5时间才能运行一次，现在只需要1时间就能运行一次了&lt;/p&gt;

&lt;h4 id=&quot;article-流水线冒险-1&quot;&gt;流水线冒险&lt;/h4&gt;&lt;p&gt;在使用流水线时，当某一条指令不能正常顺序执行时，我们就将其称之为&lt;strong&gt;冒险&lt;/strong&gt;，一般将其分为三类：&lt;/p&gt;

&lt;h5 id=&quot;article-结构冒险-1&quot;&gt;结构冒险&lt;/h5&gt;&lt;p&gt;结构冒险，是指一条本来在某个时钟周期计划要执行的指令，由于硬件缺乏对当前要执行的所有指令的支持，而不能执行的情况&lt;/p&gt;
&lt;p&gt;简单来说，就是在&lt;strong&gt;物理上不支持某个流水线设计&lt;/strong&gt;，例如两个指令同时在某个内存地址或寄存器上操作的情况，这个较为简单，无需多言&lt;/p&gt;

&lt;h5 id=&quot;article-数据冒险-1&quot;&gt;数据冒险&lt;/h5&gt;&lt;p&gt;数据保险，是指由于指令执行所需的数据暂时不可用而造成将要执行的指令不能在原定时钟周期内执行的情况，也就是&lt;strong&gt;数据依赖导致的停顿&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;例如流水线中有两个加法指令：s0=t0+t1; t2=s0+t3;&lt;/p&gt;
&lt;p&gt;很显然在流水线中，当第二个指令开始执行时，第一个指令才执行到第一个步骤“取值”；而当第二个指令开始执行“译码和读寄存器”时，第一个指令才走到“执行ALU”这一步，还没有将修改后的s0值通过第四步“访问寄存器”存入新值，导致第二个指令在寄存器中读到的值还是旧数据，所以为了让第二个指令读到新值，我们必须在流水线当中引入三个气泡（即停顿），造成了性能浪费&lt;/p&gt;
&lt;p&gt;我们有一种最原始的解决方法：加硬件——我们在ALU和要接受数据的流水线间拉一条路，一旦ALU生成了运算的结果，该结果就能立即传输到下一条线的输入。这个过程称为&lt;strong&gt;数据定向&lt;/strong&gt;或&lt;strong&gt;数据旁路&lt;/strong&gt;，就像这样：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/lsx2.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-控制冒险-1&quot;&gt;控制冒险&lt;/h5&gt;&lt;p&gt;控制冒险，是指在某个周期内应当被执行的指令由于当前取得的指令不是这条真正需要的指令不能被执行的情况，简单点说，就是分支延迟延迟跳转导致的指令错开&lt;/p&gt;
&lt;p&gt;通俗地讲，控制冒险就是程序遇到跳转等地址操作跳跃的情况下，取得跳转操作目标地址的时间在执行下一条指令之后，导致当指令跳转时，在跳转前就错误地执行了本不该在跳转前执行的操作&lt;/p&gt;
&lt;p&gt;让我们举一个例子，在五级流水线中：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;text&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;IF  -&amp;gt; ID  -&amp;gt; EX  -&amp;gt; MEM -&amp;gt; WB&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;取指   译码   执行   访存   写回&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;假设当前指令是 &lt;code&gt;jump&lt;/code&gt; 等跳转指令，这类指令实际上取得跳转目标地址的结果过程在 &lt;code&gt;EX&lt;/code&gt; 执行这一步，这代表在执行到这一步之前，如果流水线继续运作，会导致在&lt;code&gt;jump&lt;/code&gt;后操作本该被跳过的指令，直到ex获得取值并执行跳转，就像这样：》&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;text&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;周期 1：读取分支指令&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;周期 2：读取分支后面的指令 A&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;周期 3：读取指令 B，同时才确定分支应该跳转，此时错误地额外读了AB指令&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;要解决这个问题，除了死板地阻塞，计算机采用&lt;strong&gt;分支预测&lt;/strong&gt;的方法处理分支。具体的预测方式有：&lt;/p&gt;
&lt;p&gt;最简单的是 &lt;strong&gt;总是遇测分支未执行&lt;/strong&gt;，即预测不产生分支（跳转），在审核时候都顺序执行，如果遇到跳（即预测错误）就冲刷流水线，CPU 会把错误路径上已经进入流水线的指令标记为无效，然后重新取正确指令&lt;/p&gt;
&lt;p&gt;即使是这样，也略显力不从心，于是，一种更复杂的分支是预测方法是 &lt;strong&gt;总是预测一些分支成功而一些分支失败&lt;/strong&gt;，也就是在某些指令后固定预测分支成功，即不跳转，执行下一条；或者在某些指令后总是预测分支失败，即跳转，并猜测跳转地址&lt;/p&gt;
&lt;p&gt;比如在下面的go代码中：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; excute&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        fallback&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;我们就总是预测for循环成功，不跳转，继续执行下一轮循环；并且总是预测&lt;code&gt;if err != nil&lt;/code&gt;失败，就跳转到if的下一条指令。这样预测，就能达到这个程序的理想预测状态&lt;/p&gt;
&lt;p&gt;但是这些预测方法仍然不满足需求，都是以固定的规律进行预测，我们称之为 &lt;code&gt;静态预测&lt;/code&gt;，不会根据程序运行情况改变，当遇到复杂业务时预测概率就飘忽不定，大幅影响服务器性能。而现在常用的预测方式都是&lt;code&gt;动态预测&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;最简单的就是&lt;strong&gt;1-bit预测器&lt;/strong&gt;，它为分支保存一个二进制状态，0表示上一次没有跳转，下次预测不跳转；1表示上一次发生了跳转，下次预测跳转。这样一来，当分支真正执行后，预测器用实际结果覆盖原来的状态：上次跳转，那么下次预测跳转；上次不跳，那么下次预测不跳。1-bit 预测器的问题是过于敏感。只要出现一次反常结果，它就会立刻改变预测方向&lt;/p&gt;
&lt;p&gt;进阶地为了避免预测器被一次偶然结果带偏，我们可以使用 &lt;strong&gt;2-bit 饱和计数器&lt;/strong&gt;，它包含四个状态：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;00：强不跳转&lt;/li&gt;
&lt;li&gt;01：弱不跳转&lt;/li&gt;
&lt;li&gt;10：弱跳转&lt;/li&gt;
&lt;li&gt;11：强跳转&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;状态转换规则为 强不跳 &lt;code&gt;00&lt;/code&gt; &amp;lt;-&amp;gt; 弱不跳 &lt;code&gt;01&lt;/code&gt; &amp;lt;-&amp;gt; 弱跳 &lt;code&gt;10&lt;/code&gt; &amp;lt;-&amp;gt; 强跳 &lt;code&gt;11&lt;/code&gt;。也就是，每次发生跳转就让计数器+1，否则-1。预测时只需要观察最高位，00、01 预测不跳转；10、11 -&amp;gt; 预测跳转。2-bit 预测器的核心优势就是具有一定“惯性”,通常需要连续出现两次相反结果，才会真正改变预测方向&lt;/p&gt;
&lt;p&gt;CPU 不能只保存一个预测状态，因为程序中存在大量不同的分支指令。为此，CPU 会使用 &lt;strong&gt;BHT&lt;/strong&gt;（Branch History Table，分支历史表）&lt;/p&gt;
&lt;p&gt;BHT 可以理解为一张由分支指令地址索引的表，PC会进到BHT，找到对应的 1-bit 或 2-bit 预测状态，预测跳转或不跳转&lt;/p&gt;
&lt;p&gt;不过，只知道“会跳转”还不够，CPU 还必须知道应该跳到哪里。因此，CPU 还会使用 BTB（Branch Target Buffer，分支目标缓冲）&lt;br /&gt;BTB 主要保存分支指令地址和其映射的预测的目标地址缓存，写一次跳转就直接尝试使用地址缓存跳转&lt;/p&gt;
&lt;p&gt;不过现在多使用更先进的分支预测技术，此处不再阐释&lt;/p&gt;

&lt;h3 id=&quot;article-层次结构的存储器与高速缓存-1&quot;&gt;层次结构的存储器与高速缓存&lt;/h3&gt;
&lt;h4 id=&quot;article-概述与提要-1&quot;&gt;概述与提要&lt;/h4&gt;&lt;p&gt;接下来，就让我们来到高速缓存的部分，这也是计组对于上层开发者而言最重要的部分，我们要接触并了解CPU Cache 及其衍生机制&lt;/p&gt;
&lt;p&gt;在这之前，我们要先知道局部性原理：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;时间局部性&lt;/strong&gt;：如果一个数据项被引用，那么在不久的将来它很可能再次被引用&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;空间局部性&lt;/strong&gt;：如果某个数据项被引用，与它地址相近的数据项可能很快会被引用&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;其次，我们再介绍一下SRAM和DRAM：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;SRAM 是 Static RAM，静态随机访问存储器。它通常用类似触发器的电路保存 bit，只要不断电，数据就能稳定保持，不需要周期性刷新&lt;/li&gt;
&lt;li&gt;DRAM 是 Dynamic RAM，动态随机访问存储器。它通常用电容中的电荷表示 bit，但电容会漏电，所以必须周期性刷新&lt;/li&gt;
&lt;/ul&gt;
&lt;blockquote&gt;
&lt;p&gt;我们之前手搓的RAM在构造上严格来说属于SRAM&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;SRAM 和 DRAM 都是易失性随机访问存储器，断电后数据都会丢失。它们的主要区别在于存储一个 bit 的电路结构不同，因此速度、成本、容量也不同&lt;/p&gt;

&lt;h4 id=&quot;article-cpu-cache-1&quot;&gt;CPU Cache&lt;/h4&gt;&lt;p&gt;我们要知道，CPU 的运算速度远快于 DRAM 的访问速度。如果 CPU 每执行几条指令，都必须停下来等待主存返回数据，那么即使 CPU 的计算单元非常快，大部分时间也会浪费在等待内存上，而这样的速度差异是由物理硬件上的线路和距离带来的&lt;/p&gt;
&lt;p&gt;因此，我们希望CPU操作的主存尽可能地接近CPU本身，于是就有了&lt;strong&gt;CPU Cache&lt;/strong&gt;，一块存在于CPU内部的”主存”，CPU Cache 就是位于 CPU 与主存之间的小容量高速存储器，CPU Cache 使用速度较快的 SRAM，保存主存中一部分数据的副本&lt;/p&gt;
&lt;p&gt;这样一来，CPU操作内存地址的路径就变成了&lt;code&gt;CPU -&amp;gt; CPU Cache -&amp;gt; DRAM 主存&lt;/code&gt;，这就是为什么这一章主要讲解“层次结构的存储器”。当 CPU 需要读取某个数据时，会优先检查 Cache：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;text&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;CPU 请求数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;检查 CPU Cache&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── 找到：直接使用缓存中的数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    └── 没找到：从下一层存储读取，并装入 Cache&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;现代处理器通常不只有一级 Cache，而是使用多级高速缓存：&lt;code&gt;CPU Core -&amp;gt; L1 Cache -&amp;gt; L2 Cache -&amp;gt; L3 Cache -&amp;gt; DRAM 主存&lt;/code&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;L1 Cache 是一级高速缓存，通常离 CPU 核心最近，&lt;strong&gt;速度最快，容量最小&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;L2 Cache 是二级高速缓存，位于 L1 Cache 和更低层存储之间。它比 L1 慢，但容量通常更大；比主存快得多，但容量小得多&lt;/li&gt;
&lt;li&gt;. . . . . .&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;当 L1 miss 时，先去 L2 查找。如果 L2 命中，就不必直接访问更慢的主存，从而降低 L1 miss 带来的平均缺失损失&lt;/p&gt;

&lt;h4 id=&quot;article-cache-line-1&quot;&gt;Cache Line&lt;/h4&gt;&lt;p&gt;CPU Cache 通常不会只保存程序当前请求的一个变量，而是以一段连续数据为单位，在 Cache 与下层存储之间进行传输，这个基本单位称为Cache line/Cache block/高速缓存块。可以说，CPU Cache的基本单位就是Cache Line，当CPU需要读取一个 8 字节的数据，他就会以一定策略（下文介绍）去Cache Line中查找数据。&lt;/p&gt;
&lt;p&gt;还记得空间局部性吗？如果某个数据项被引用，与它地址相近的数据项可能很快会被引用。在这里，如果发生缓存缺失，CPU 不会只从主存读取 8 个字节，而是把包含它的一整条 64 字节 cache line 都装入 Cache，这样当程序读取numbers[0]时，后面的若干元素也可能被一起带入 Cache，程序继续顺序访问 numbers[1]、numbers[2] 时，就有较大概率直接命中缓存，这正是 CPU Cache 对空间局部性的利用&lt;/p&gt;

&lt;h4 id=&quot;article-映像高速缓存-1&quot;&gt;映像高速缓存&lt;/h4&gt;&lt;p&gt;我们知道了 Cache 和 Cache Line 的构造和作用，那么地址是怎么定位寻址到Cache Line的呢？答案是映像高速缓存&lt;/p&gt;

&lt;h5 id=&quot;article-直接映像高速缓存-1&quot;&gt;直接映像高速缓存&lt;/h5&gt;&lt;p&gt;首先，我们来看最直接的一种高速缓存，就是&lt;strong&gt;直接映像高速缓存&lt;/strong&gt;，一种每个主存地址对应于高速缓存中唯一地址的高速缓存结构&lt;/p&gt;
&lt;p&gt;对直接映像的高速缓存而言，主存地址和高速缓存地址的典型映射通常比较简单，比如几乎所有的直接映射高速缓存都使用以下方式：（块地址）取模（高速缓存中块的数目）。这种映射的优点在于，如果高速缓存块的数目是 2 的幂，取模的计算就可以很简单，只需要取块地址的低 log2 位，因此可以通过低位直接访问高速缓存。同时，由于每个高速缓存的地址可能对应于主存中多个不同的地址，我们怎么知道高速缓存中的数据项是否就是所请求的字呢？我们可以考虑在高速缓存中添加&lt;strong&gt;标记&lt;/strong&gt;，这些标记必须包含能够判断高速缓存中的字是否为所请求的字的地址信息。标记只需包含地址的高位部分，即地址中没有用作高速缓存下标的那些位。在此之外，我们还需要一种方式判断高速缓存块中确没有有效信息。最常用的方法是加一个&lt;strong&gt;有效位&lt;/strong&gt;，来说明一个块是否含有一个有效地址。如果这个位没有设置，则不能取用该块内容。&lt;/p&gt;
&lt;p&gt;也就是说，在直接映像高速缓存中，一个地址通常被拆成三部分以及一个有效位：| tag | index | block offset |&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;block offset&lt;/code&gt;：在一个 cache block 内部找具体字节或字&lt;/li&gt;
&lt;li&gt;&lt;code&gt;index&lt;/code&gt;：选择 Cache 中的哪一行，由地址的低 log2 位实现&lt;/li&gt;
&lt;li&gt;&lt;code&gt;tag&lt;/code&gt;：判断这一行里放的是不是目标主存块，由地址的高位部分实现&lt;/li&gt;
&lt;li&gt;一个有效位 valid bit&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这种直接映像高速问团的方式简单而又快速，但同时容易发生&lt;strong&gt;高速缓存缺失&lt;/strong&gt;。高速缓存缺失，是指由于数据不在高速缓存中而无法满足的高速缓存的数据请求。例如主存块 0 和主存块 8 都映射到 Cache 第 0 行，如果程序反复访问二者，它们会互相替换，导致频繁 miss，浪费性能&lt;/p&gt;

&lt;h5 id=&quot;article-全相联高速缓存-1&quot;&gt;全相联高速缓存&lt;/h5&gt;&lt;p&gt;如果说直接映像高速缓存是把每一个主存快块都放在特定的 Cache Line 里，那么&lt;strong&gt;全相连高速缓存&lt;/strong&gt;就是同一个主存块请求可以被放在任意的Cache Line里。因此它没有直接映像中“某个主存块只能去固定一行”的限制，冲突缺失更少。访问时，硬件需要把目标地址的 tag 与 Cache 中所有行的 tag 进行比较，只要任意一行匹配且 valid bit 有效，就是命中&lt;/p&gt;
&lt;p&gt;这种方式的优点是放置灵活且冲突缺失少；缺点是需要增加复杂的硬件，并且需要并行更多的 tag，成本较高&lt;/p&gt;

&lt;h5 id=&quot;article-组相联高速缓存-1&quot;&gt;组相联高速缓存&lt;/h5&gt;&lt;p&gt;组相连高速缓存就是直接映像和全相联之间的折中，它先把 Cache 分成多个组，每组有若干行。一个主存块只能映射到某一个组，但可以放在这个组里的任意一行，在查找主存块位置时，类似于直接映像高速缓存，同样使用低位主存块号对块数取模，也在目标组内比较 tag&lt;/p&gt;
&lt;p&gt;所以可以说，直接映像高速缓存和全相联高速缓存，都是组相联高速缓存的一种特殊分类：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;直接映像高速缓存：就是每个组都只有一行值的组相联高速缓存&lt;/li&gt;
&lt;li&gt;全相联高速缓存：就是只有一个组的组相联高速缓存&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;与直接映像相比，组相联减少了冲突缺失；与全相联相比，它不需要搜索整个 Cache，只需要在目标组内比较 tag，硬件成本更低&lt;/p&gt;

&lt;h5 id=&quot;article-lru-1&quot;&gt;LRU&lt;/h5&gt;&lt;p&gt;对于以上包含组的高速缓存相连方式（比如全相连高速缓存和组相连高速缓存），它们都需要在一个组内，也就是在多个缓存池中进行缓存刷新的取舍。也就是说，当一个新的缓存进入时，必须以一定的策略舍弃一个缓存，并把这个新缓存重新写到该位置上&lt;/p&gt;
&lt;p&gt;我们一般使用LRU，Least Recently Used，意思是最近最少使用&lt;/p&gt;
&lt;p&gt;在组相联或全相联高速缓存中，如果发生 miss，且目标组内所有 cache line 都已经被占用，就必须选择一行替换出去。LRU 的规则是：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;text&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;淘汰最近最长时间没有被访问过的那一行&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;它背后的依据是时间局部性：如果一个块最近刚被访问过，那么它很可能马上还会被访问；反过来，最久没被访问的块，未来被访问的概率相对更低&lt;/p&gt;
&lt;p&gt;真实硬件中，严格 LRU 的维护成本可能较高，尤其关联度较大时，因此有些处理器会使用近似 LRU&lt;/p&gt;

&lt;h4 id=&quot;article-写操作处理-1&quot;&gt;写操作处理&lt;/h4&gt;&lt;p&gt;在项目中使用过缓存的我们都知道，要读缓存非常轻松，但是一旦要写缓存，各种问题就接踵而至，CPU Cache也是一样&lt;/p&gt;
&lt;p&gt;读miss通常只是把主存中的块复制到 Cache，一般不会造成主存和 Cache 不一致。但是写操作 store 是 CPU 写入新值，这时主存和 Cache 对同一地址保存了不同的值，导致不一致的出现。例如：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;text&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;原来：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;主存 x = 10&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Cache x = 10&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;CPU 执行 x = 20&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;如果只写 Cache：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;主存 x = 10&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Cache x = 20&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;为解决写入后的不一致问题，常见写策略有以下几种：&lt;/p&gt;

&lt;h5 id=&quot;article-write-through-1&quot;&gt;Write-through&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;写通过&lt;/strong&gt;（Write-through）是 写操作总是同时更新高速缓存和主存，以保持数据一致性的策略，也就是每次写 Cache 的同时也写主存&lt;/p&gt;
&lt;p&gt;优点是主存和 Cache 保持一致。缺点是每次写都要触达更低层存储器，开销较大，一般不使用&lt;/p&gt;

&lt;h5 id=&quot;article-write-buffer-1&quot;&gt;Write buffer&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;写缓冲&lt;/strong&gt;（Write buffer）是 在数据等待被写入主存时，存放数据的队列，用来暂存还没来得及写入下一层存储器的写请求&lt;/p&gt;
&lt;p&gt;在 write-through 策略中，如果 CPU 每次写 Cache 后都必须等待主存写完，写操作会非常慢。加入 write buffer 后，CPU 可以先把写请求放进缓冲区，然后继续执行后续指令，由写缓冲区在后台慢慢把数据写到主存&lt;/p&gt;
&lt;p&gt;write buffer 的作用是降低 CPU 因等待主存写入而停顿的概率，但它不能让主存写入本身消失。如果写入速度太快，write buffer 被填满，CPU 仍然需要等待&lt;/p&gt;

&lt;h5 id=&quot;article-write-back-1&quot;&gt;Write-back&lt;/h5&gt;&lt;p&gt;在现代CPU中，我们常采取&lt;strong&gt;写回&lt;/strong&gt;，也就是write-back的策略。也就是 写操作时只更新高速缓存中的块，当高速缓存块被替换时，才将修改过的块写入底层存储器，提高效率&lt;/p&gt;
&lt;p&gt;简单来说，CPU 先只写 Cache，并把该 cache line 标记为 &lt;code&gt;dirty bit&lt;/code&gt;。等这个块被替换出 Cache 时，再把标记为 &lt;code&gt;dirty bit&lt;/code&gt; 的Cache line写回主存。优点是多次写可以合并，性能较好。缺点是主存和 Cache 会在一段时间内不一致，需要 dirty bit 管理&lt;/p&gt;

&lt;h4 id=&quot;article-false-sharing-1&quot;&gt;False Sharing&lt;/h4&gt;&lt;p&gt;同时结合我们的日常业务来说，在单核单机情况下，缓存策略已经解决得差不多了，但在分布式情况下，缓存也会面临新的问题。同样地，在电脑中，一般是多核 CPU 一起工作的，这导致多核 CPU 在并发状态下也会产生很多缓存问题。&lt;strong&gt;false sharing&lt;/strong&gt; 就是多核缓存场景下的性能问题。如果两个核心上的线程分别修改不同变量，但这两个变量恰好落在同一个 cache line 中，那么硬件缓存一致性协议会把整条 cache line 当作共享单位来同步。结果是两个线程虽然没有逻辑上共享同一个变量，却会因为共享同一条 cache line 而互相使对方的缓存行失效&lt;/p&gt;
&lt;p&gt;解决思路是让高频写入、由不同核心修改的变量分布到不同 cache line，例如使用 padding 或调整结构布局。我们在后文 多处理器与并发 中会再次详解&lt;/p&gt;

&lt;h4 id=&quot;article-虚拟存储器-1&quot;&gt;虚拟存储器&lt;/h4&gt;&lt;p&gt;那我们再回头看 CPU cache 的设计哲学：将缓存放在与 CPU 极近的距离，来提高 CPU 的运行性能。同样的，我们把这个思想类比到储存与磁盘中：&lt;strong&gt;虚拟存储器&lt;/strong&gt;可以理解为把主存作为辅助存储器的高速缓存。这里的“辅助存储器”通常指磁盘或 SSD&lt;/p&gt;
&lt;p&gt;在层次结构的思想之外，虚拟存储器更是提供了计算机系统的一个重要根基：地址抽象。在程序运行中，虚拟存储器会为程序提供虚拟地址，并非真实物理地址。每个进程看到独立、连续的虚拟地址空间，最后再由硬件解成物理地址&lt;/p&gt;
&lt;p&gt;更完整地说，虚拟存储器不是某一块具体硬件，而是硬件和操作系统共同提供的一套内存抽象机制。它让程序使用虚拟地址，而不是直接使用真实 DRAM 的物理地址。因此，现代系统里，虚拟存储器更常见、更重要的作用是地址翻译、进程隔离、按需分配和内存映射，而不只是用磁盘扩充内存容量&lt;/p&gt;
&lt;p&gt;它主要提供三个能力：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;text&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;1. 地址抽象：每个进程看到独立、连续的虚拟地址空间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;2. 保护隔离：不同进程不能随便访问彼此的内存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;3. 按需调入：只把当前需要的页放入主存，不需要的页可以暂时留在磁盘&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;因此，“虚拟存储器允许程序可使用的虚拟地址空间大于物理内存”这个理解是对的，但不完整。现代系统里，虚拟存储器更常见、更重要的作用是地址翻译、进程隔离、按需分配和内存映射，而不只是用磁盘扩充内存容量&lt;/p&gt;
&lt;p&gt;虚拟存储器的基本单位是页 page。主存中保存的是一部分当前正在使用或最近使用的虚拟页；不在主存中的页可以暂时留在磁盘上。访问不在主存中的页时，会触发缺页异常，由操作系统把对应页从磁盘调入主存&lt;/p&gt;

&lt;h3 id=&quot;article-存储器与io-1&quot;&gt;存储器与IO&lt;/h3&gt;&lt;p&gt;这一章主要是讲存储器，网络和其他外围设备的，网络部分也只是短短几行字提了一嘴，我们就跳过在计网再深入探讨。并且本书只提及机械硬盘（HDD）的存储器原理，而非现在主流的固态硬盘（SSD），所以我们会在机械硬盘原理上进行部分拓展&lt;/p&gt;

&lt;h4 id=&quot;article-磁盘存储-1&quot;&gt;磁盘存储&lt;/h4&gt;
&lt;h5 id=&quot;article-hdd-1&quot;&gt;HDD&lt;/h5&gt;&lt;p&gt;首先，我们要知道，HDD（机械硬盘）通过磁性盘片保存数据。盘片表面被划分为多个同心圆，这些同心圆称为 &lt;strong&gt;磁道（Track）&lt;/strong&gt;；每条磁道又被划分为多个 &lt;strong&gt;扇区（Sector）&lt;/strong&gt;。磁头悬浮在盘片表面，通过盘片旋转和磁头移动完成数据的读取与写入。如果硬盘有多个盘面，那么不同盘面上半径相同的一组磁道可以构成一个 &lt;strong&gt;柱面（Cylinder）&lt;/strong&gt;。而一次机械磁盘 I/O 的总时间可以拆成：&lt;code&gt;T_total = T_seek + T_rot + T_trans&lt;/code&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;T_seek&lt;/code&gt;：寻道时间，磁头移动到目标柱面&lt;/li&gt;
&lt;li&gt;&lt;code&gt;T_rot&lt;/code&gt;：旋转延迟，盘片转到目标扇区&lt;/li&gt;
&lt;li&gt;&lt;code&gt;T_trans&lt;/code&gt;：传输时间，真正读写数据所花时间&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;因此，HDD的关键特征是：定位成本 seek + rot 远大于传输成本 trans&lt;/p&gt;
&lt;p&gt;因此，顺序的I/O普遍都比较顺畅，而随机的I/O，例如散落小文件剪贴，则很慢&lt;/p&gt;

&lt;h5 id=&quot;article-ssd-1&quot;&gt;SSD&lt;/h5&gt;&lt;p&gt;相反，现在计算机多使用SSD，即固态硬盘作为持久化存储设备&lt;/p&gt;
&lt;p&gt;与 HDD 不同，SSD 没有磁头、盘片和机械运动部件，而是使用 NAND Flash 闪存保存数据。因此，SSD 不需要执行寻道和等待盘片旋转，通过电子信号直接访问闪存单元。这使 SSD 的随机访问延迟远低于 HDD，尤其适合数据库、编译、大量小文件访问等随机 I/O 较多的工作负载。&lt;/p&gt;
&lt;p&gt;但是，SSD 并不是一块简单的“大容量内存”。NAND Flash 有一条重要限制：&lt;strong&gt;数据可以按 page 读取和写入，但必须按更大的 block 擦除&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;SSD 内部的存储层次可以简化为：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Cell  -&amp;gt; 保存一个或多个 bit&lt;/li&gt;
&lt;li&gt;Page  -&amp;gt; 读取和写入的基本单位&lt;/li&gt;
&lt;li&gt;Block -&amp;gt; 擦除的基本单位，包含许多 page&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;SSD 通常不能像 DRAM 那样直接在原位置覆盖已有数据。当主机修改某个逻辑地址的数据时，SSD 通常会找到一个新的空闲 page，将新数据写入这个 page，然后更新逻辑地址与物理 page 的映射，再将旧 page 标记为无效，再在之后的垃圾回收中擦除旧数据所在的 block。这称为 &lt;strong&gt;异地更新（Out-of-place Update）&lt;/strong&gt;，即旧逻辑地址 指向的是 旧物理 page，在发生修改后旧逻辑地址 才指向 新物理 page，而旧物理 page 被标记为无效。这也是为什么有时候我们可以通过硬盘修复某些被硬删除的数据&lt;/p&gt;

&lt;h5 id=&quot;article-ftl-1&quot;&gt;FTL&lt;/h5&gt;&lt;p&gt;操作系统看到的 SSD 是一系列连续的逻辑块地址，但 NAND Flash 内部的数据位置会不断变化，负责维护这种映射关系的是 FTL（Flash Translation Layer，闪存转换层）&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;text&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;操作系统访问逻辑块地址 LBA&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;             ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;       SSD 控制器中的 FTL&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;             ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      实际 NAND 物理 page&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;FTL 的主要职责包括：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;逻辑地址到物理地址的映射&lt;/li&gt;
&lt;li&gt;垃圾回收&lt;/li&gt;
&lt;li&gt;磨损均衡&lt;/li&gt;
&lt;li&gt;坏块管理&lt;/li&gt;
&lt;li&gt;空闲空间管理&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-垃圾回收与写放大-1&quot;&gt;垃圾回收与写放大&lt;/h5&gt;&lt;p&gt;由于 SSD 只能按 block 擦除，当一个 block 中同时存在有效 page 和无效 page 时，SSD 不能直接擦除整个 block，它必须先将仍然有效的数据搬到其他位置，即在读取有效 page后，需要先写入其他 block，才能擦除原 block。这个过程称为 &lt;strong&gt;垃圾回收（Garbage Collection，GC）&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;垃圾回收会导致 SSD 内部实际写入的数据量超过应用程序请求写入的数据量，这种现象称为 &lt;strong&gt;写放大&lt;/strong&gt;：&lt;/p&gt;
&lt;p&gt;例如，应用程序只写入 4KB 数据，但 SSD 为了搬迁有效 page，内部可能实际写入 16KB&lt;/p&gt;
&lt;p&gt;写放大会带来写入延迟上升，SSD 内部带宽被占用，闪存单元磨损加快，P99、P999 尾延迟出现抖动等问题。当 SSD 接近写满时，可供 FTL 选择的空闲 page 和 block 变少，垃圾回收成本通常会明显上升。因此，数据库和高写入服务通常不应该把 SSD 容量完全用满&lt;/p&gt;

&lt;h4 id=&quot;article-dma-1&quot;&gt;DMA&lt;/h4&gt;&lt;p&gt;DMA 是 Direct Memory Access，直接内存访问&lt;/p&gt;
&lt;p&gt;没有 DMA 时，CPU 需要亲自把数据从设备搬到内存，或者从内存搬到设备。有 DMA 时，CPU 会配置 DMA 描述符，然后让设备/DMA 控制器直接读写内存，传输完成后通过中断或轮询通知 CPU&lt;/p&gt;

&lt;h3 id=&quot;article-多处理器与并发-1&quot;&gt;多处理器与并发&lt;/h3&gt;&lt;p&gt;在计组的最后，我们从思考走向实际：在现代计算机体系中，往往不使用单处理器，而是走向多处理器、片内多核、多线程和集群，继续提高系统性能。与此同时，多核的并发写入也会带来新的问题&lt;/p&gt;

&lt;h4 id=&quot;article-缓存一致性与mesi协议-1&quot;&gt;缓存一致性与MESI协议&lt;/h4&gt;&lt;p&gt;多核系统中，每个核心通常有私有 L1/L2 Cache。如果多个核心缓存了同一个内存地址，就必须保证它们看到的数据符合一致性规则&lt;/p&gt;
&lt;p&gt;例如：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;text&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;Core A 的 Cache 中 x = 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Core B 的 Cache 中 x = 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Core A 写 x = 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Core B 如果继续读自己的旧副本，就会读到 x = 0&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;为了解决缓存一致性问题，我们通常使用&lt;strong&gt;MESI协议&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;MESI 是一种常见缓存一致性协议。它以 cache line 为单位维护状态。MESI有四种状态：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;M Modified&lt;/code&gt;：本核心修改过，内存中是旧值，只有本核心副本有效。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;E Exclusive&lt;/code&gt;：本核心独占，内容和内存一致，其他核心没有副本。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;S Shared&lt;/code&gt;：多个核心可以读，内容和内存一致。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;I Invalid&lt;/code&gt;：该副本无效，不能使用。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;在该协议下，并发缓存的典型流程是这样的：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;text&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;多个核心读同一 cache line -&amp;gt; 状态为 Shared&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;某个核心要写 -&amp;gt; 通知其他核心把该 line 置为 Invalid&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;写入核心获得 Modified 状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;其他核心再读 -&amp;gt; 必须重新获取最新数据&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;MESI 管理的是 cache line，不是单个变量&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-伪共享-1&quot;&gt;伪共享&lt;/h4&gt;&lt;p&gt;伪共享，也就是我们之前提到过的 False Sharing，是多核程序中的重要性能陷阱&lt;/p&gt;
&lt;p&gt;如果两个不同变量位于同一个 cache line 中，即使它们在逻辑上互不相关，只要不同核心频繁写它们，就会互相使对方的 cache line 失效&lt;/p&gt;
&lt;p&gt;例如在Go代码中：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Counters&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    A &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    B &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;如果 goroutine 1 高频写 &lt;code&gt;A&lt;/code&gt;，goroutine 2 高频写 &lt;code&gt;B&lt;/code&gt;，而 &lt;code&gt;A&lt;/code&gt; 和 &lt;code&gt;B&lt;/code&gt; 位于同一个 64B cache line 中，就可能产生伪共享。&lt;/p&gt;
&lt;p&gt;解决思路是padding，通过占位，让高频写变量落在不同 cache line 上：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Counters&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    A &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    _ [&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;56&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    B &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-amdahl-定律-1&quot;&gt;Amdahl 定律&lt;/h4&gt;&lt;p&gt;在一个系统中，他的加速上线由他并行的部分决定——&lt;strong&gt;Amdahl 定律&lt;/strong&gt;描述并行加速上限，其关键结论是：&lt;strong&gt;哪怕串行部分很小，也会限制无限加核后的最高加速比&lt;/strong&gt;。例如 10% 串行，则理论最大加速比不超过 10 倍。所以我们可以发现，Redis 的核心命令执行长期采用单线程模型，并不是因为不能使用多核，而是因为它选择避免锁、共享状态和缓存一致性开销&lt;/p&gt;

&lt;h3 id=&quot;article-gpu-1&quot;&gt;GPU&lt;/h3&gt;&lt;p&gt;我们发现，书上没有讲解GPU这一如今十分重要的计算机组成部件，此处拓展&lt;/p&gt;
&lt;p&gt;GPU（Graphics Processing Unit，图形处理器）同样是处理器，但它和 CPU 的设计目标不同&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;CPU 追求低延迟和通用性：核心较少但较强，拥有复杂的分支预测、乱序执行和较大的缓存，适合执行控制流程复杂、任务差异较大的程序&lt;/li&gt;
&lt;li&gt;GPU 追求高吞吐量：拥有大量相对简单的计算单元，让大量线程同时执行相似操作，适合图形渲染、矩阵计算、机器学习和科学计算&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;GPU 并没有脱离前面章节的知识体系，它仍然包含：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;指令与数据通路。&lt;/li&gt;
&lt;li&gt;流水线。&lt;/li&gt;
&lt;li&gt;寄存器和多级缓存。&lt;/li&gt;
&lt;li&gt;主存或显存。&lt;/li&gt;
&lt;li&gt;多处理器与多线程。&lt;/li&gt;
&lt;li&gt;存储层次和局部性。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;GPU 的关键执行思想通常称为 SIMT（Single Instruction, Multiple Threads，单指令多线程）。大量线程会被分组执行；在 NVIDIA 术语中，一组通常称为 warp（线程束）。同一线程束中的线程通常执行同一条指令，但处理不同的数据&lt;/p&gt;
&lt;p&gt;如果同一线程束中的线程遇到分支并走向不同路径，就会发生分支发散。硬件通常需要分批执行各条路径，使并行效率下降。因此，GPU 擅长规则、数据并行度高的工作，不擅长大量不规则分支和强串行依赖的工作&lt;/p&gt;
&lt;p&gt;GPU 通过大量并发线程隐藏访存延迟：当一组线程等待数据时，调度器切换到另一组可运行线程。它更依赖高并发和高显存带宽，而 CPU 更依赖大缓存、复杂控制逻辑和较低的单线程延迟&lt;/p&gt;
&lt;p&gt;显存通常指独立显卡上的高带宽内存，例如 GDDR 或 HBM。独立 GPU 与 CPU 往往拥有各自的内存空间，数据需要经过 PCIe 等互连传输；这段传输开销可能抵消 GPU 计算带来的加速。集成 GPU 则通常与 CPU 共享主存，但仍可能有不同的缓存和一致性设计&lt;/p&gt;
&lt;p&gt;如今，GPU更是用来训练和运行AI大模型，这都是因为神经网络的大部分计算可以转化为矩阵乘法、向量运算和乘加运算。一次运算中的大量元素通常可以彼此独立地计算，因此具有很高的数据并行性&lt;/p&gt;
&lt;p&gt;CPU 擅长复杂控制流程和低延迟任务；GPU 则拥有大量计算单元，可以同时处理矩阵中的大量元素。现代 GPU 还可能包含专门加速低精度矩阵乘法的 Tensor Core。CUDA、ROCm 等软件平台负责把 PyTorch 等框架中的张量运算调度到 GPU 上执行&lt;/p&gt;

&lt;h2 id=&quot;article-后记-1&quot;&gt;后记&lt;/h2&gt;&lt;p&gt;从咸鱼花了几块钱淘了一本第三版（2008年版）《计算机组成与设计：硬件/软件接口》，闻起来有股老图书馆里的图书的味道，或者说灰尘或者尘霉的味道？反正花了与大概8天时间啃完了这本书。这本书有相当多的部分是讲解硬件原理的，这些部分都跳过不看，剩下软件的部分我认为也讲的可圈可点，只是其需要默认你知道计组的一些底层设计，如CPU的组成和运作原理，汇编和指令集等，因此我才理解了小林Coding说为什么这本书适合先看完《计算机科学速成课》后再进行深入阅读，否则很容易看得云里雾里，不知所云的。有些东西啃书的时候有很多理解，也产生了很多思考，但是实际隔几天写出来的时候却全都忘了，或许是我写得太心急了。之后学的时候我打算每天都记录一点相关思考，随记在手机啥的上面，防止写出来的东西又浅浅的&lt;/p&gt;
&lt;p&gt;同时，计组部分的知识相对os等其他底层来讲也许并没有如此重要，因此这篇博客实际上记录得并不算细节，也只算是把所有知识都过了一遍&lt;/p&gt;
&lt;p&gt;接下来就打算开始学习OS相关内容了，目前准备先看一下汇编（看学长博客说的看王爽汇编），然后再啃CSAPP这本书，啃了关键那几章后就去做mit 6.S081的前四个 Lab，这一套组合拳下来估计又要花一个多月&lt;/p&gt;
&lt;p&gt;顺带一提，正在激情上连续20天的高数早八小学期，微死（甚至有两天没起来刚好点名导致缺勤两次），什么时候好好休息一上午啊！！！小学期完了又是驾照啥的，烦死了(＞д＜)&lt;/p&gt;

&lt;h2 id=&quot;article-参考文章-1&quot;&gt;参考文章&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;《计算机科学速成课》&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;《计算机组成与设计：硬件/软件接口》&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/CO/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>底层</category></item><item><title>RAG指南：从基础实现到进阶方案</title><link>https://www.claran-blog.work/posts/go-rag1/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-rag1/</guid><description>我的RAG学习笔记.</description><pubDate>Mon, 22 Jun 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-rag-1&quot;&gt;RAG&lt;/h2&gt;&lt;p&gt;我们知道，LLM有一个核心痛点，即不知道自己被训练后发生的事和名词，所以早期llm再遇到自己不知道的知识时极易出现编造幻觉谎言的现象，解决这种现象的方式有两个：为AI工具配备网页搜索能力，或者上RAG技术&lt;/p&gt;
&lt;p&gt;RAG，也就是检索增强生成，有关其基本概念可见：&lt;strong&gt;&lt;a href=&quot;https://www.claran-blog.work/go-Agent/#rag&quot;&gt;从 LLM 到 Agent | RAG&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;因此，RAG也算是Agent能力中重要的一部分，恰好我最近做的项目也涉及一些RAG技术，所以这里我们详细讲讲RAG的实现和业务方案&lt;/p&gt;

&lt;h3 id=&quot;article-rag伪实现-1&quot;&gt;RAG伪实现&lt;/h3&gt;&lt;p&gt;一般来讲，RAG的实现都是跟向量数据库和embedding模型绑定的，这里我们先把这些中间件降级，用质朴的代码来看看RAG是怎么基本实现的&lt;/p&gt;
&lt;p&gt;我们这里的伪RAG流程如下：&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;https://www.claran-blog.work/rss-assets/c6db829a7df3b4b3c6e0f8f6.png&quot; alt=&quot;文章图表：否、是、用户提问、Agent 判断需要查文档、调用 answer_from_document 工具、输入 file_path + question、load: 读取本地文档、chunk: 按约 800 字符切块、score: 每个文本块交给 LLM 打相关性分、filter: 按分数排序，取 Top 3、是否找到相关块？、返回：文档中未找到相关内容、synthesize: 拼接 Top-K 摘录、LLM 仅基于摘录生成答案、返回 answer + sources&quot; width=&quot;486&quot; height=&quot;1200&quot; style=&quot;max-width:100%;height:auto;vertical-align:middle&quot; /&gt;&lt;/figure&gt;&lt;p&gt;可以看到，RAG的核心分为：文档拆分 和 文本块召回&lt;/p&gt;
&lt;p&gt;详细实现如下，这里把伪RAG能力封装成了GraphTool：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; graphTool&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;encoding/json&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sort&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/components/model&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/components/tool&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/compose&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/schema&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino-examples/adk/common/tool/graphtool&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino-examples/compose/batch/batch&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Input 是工具调用的参数结构体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 其 JSON 标签被 utils.InferTool 用于自动生成工具的参数 Schema&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Input&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	FilePath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;file_path&quot; jsonschema:&quot;description=已上传文档文件的绝对路径&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Question &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;question&quot;  jsonschema:&quot;description=需要根据文档回答的问题&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Output 是工具返回的结构化结果。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Output&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Answer  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;   `json:&quot;answer&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Sources []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;sources&quot;`&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 用于生成答案的关键摘录来源&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// scoreTask 是喂给内部 BatchNode 工作流的单个分块输入&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreTask&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Text     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Question &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// scoredChunk 是内部 BatchNode 工作流生成的单个分块结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Text    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Score   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 0–10 分，表示与问题的相关性&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Excerpt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 该分块中最相关的句子或短语&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// scoreIn 是外部 &quot;score&quot; Lambda 节点的输入。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 它通过字段映射从两个来源汇集而成：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   - Chunks: &quot;chunk&quot; 节点的完整输出 ([]*schema.Document)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   - Question: START 节点的 Question 字段 (来自 Input)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreIn&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Chunks   []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Question &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// synthIn 是 &quot;synthesize&quot; Lambda 节点的输入&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 它通过字段映射从两个来源汇集而成：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   - TopK: &quot;filter&quot; 节点的完整输出 ([]scoredChunk)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   - Question: START 节点的 Question 字段 (来自 Input)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; synthIn&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	TopK     []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Question &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// BuildTool 构建由 RAG 工作流支持的 answer_from_document 工具&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 它使用了 graphtool.NewInvokableGraphTool，该工具在每次调用时编译工作流 并支持通过内置的检查点存储（checkpoint store）进行中断/恢复&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; BuildTool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cm&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseTool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; buildWorkflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cm)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; graphtool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewInvokableGraphTool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Input&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;](&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		wf,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;answer_from_document&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;在大型上传文档中搜索与问题相关的内容，并从最相关的段落中合成带有引用的答案。&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;当文档太大无法放入上下文窗口时，请使用此工具代替 read_file。&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// buildWorkflow 构建 RAG compose.Workflow（未编译状态）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// graphtool.NewInvokableGraphTool 会在每次调用时对其进行编译&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; buildWorkflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cm&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Workflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Input&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;] {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	scoreWF &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; newScoreWorkflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cm)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	scorer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; batch.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewBatchNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;batch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NodeConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Name:           &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;ChunkScorer&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		InnerTask:      scoreWF,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MaxConcurrency: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewWorkflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Input&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// load: 从磁盘读取文件，输出单个 Document&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLambdaNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;load&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableLambda&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;in&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Input&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) ([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			data, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(in.FilePath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;read &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%q&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, in.FilePath, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{{Content: &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(data)}}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(compose.START)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// chunk: 将每个 Document 拆分成约 800 字符的片段&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLambdaNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunk&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableLambda&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;docs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) ([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; out []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, d &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; docs {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				out &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(out, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;splitIntoChunks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(d.Content, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;800&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; out, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;load&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// score: 通过 BatchNode 并行针对问题对每个分块进行评分&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// Chunks 来自 &quot;chunk&quot; 节点；Question 直接来自 START 节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 两者都使用 WithNoDirectDependency，因为执行顺序已经由&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// START→load→chunk→score 的直接边缘建立&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLambdaNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;score&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableLambda&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;in&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;any&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) ([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 从 map 中手动提取字段，并进行类型断言&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 注意：这里的 key 必须和下面 AddInputWithOptions 里的字段名完全一致&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        chunks, ok1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; in[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Chunks&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;].([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        question, ok2 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; in[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Question&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;].(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok2 {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;score节点输入类型错误: Chunks 类型断言成功=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, Question 类型断言成功=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, ok1, ok2)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        tasks &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunks))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i, c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunks {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            tasks[i] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Text: c.Content, Question: question}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scorer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Invoke&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, tasks)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		AddInputWithOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunk&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			[]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FieldMapping&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Chunks&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithNoDirectDependency&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		AddInputWithOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(compose.START,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			[]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FieldMapping&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MapFields&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Question&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Question&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithNoDirectDependency&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// filter: 按分数降序排列，保留最多 3 个分数 ≥ 3 的分块&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLambdaNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;filter&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableLambda&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;scored&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) ([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			sort.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Slice&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(scored, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;i&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;j&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scored[i].Score &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scored[j].Score&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			const&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; maxK&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; top []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scored {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.Score &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				top &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(top, c)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(top) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; maxK {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; top, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;score&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// answer: 从前 K 个分块中合成回答，如果为空则返回未找到消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// TopK 来自 &quot;filter&quot; 节点；Question 直接来自 START 节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 两者都使用 WithNoDirectDependency：&quot;filter&quot; 节点通过其直接边缘控制执行顺序&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLambdaNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;answer&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableLambda&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;in&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;any&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        topK, ok1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; in[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;TopK&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;].([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        question, ok2 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; in[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Question&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;].(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok2 {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;answer node input error: topK or question missing&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(topK) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                Answer: fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;在文档中未找到与 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%q&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 相关的内容&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, question),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 构造临时结构体传给 synthesize 函数，或者直接修改 synthesize 接收 map&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; synthesize&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, cm, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;synthIn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{TopK: topK, Question: question})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		AddInputWithOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;filter&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			[]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FieldMapping&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;TopK&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithNoDirectDependency&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		AddInputWithOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(compose.START,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			[]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FieldMapping&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MapFields&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Question&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Question&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithNoDirectDependency&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// END 节点接收来自 answer 的输出&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;End&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		AddInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;answer&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wf&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// newScoreWorkflow 构建用于每个 BatchNode 任务的单节点内部工作流&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; newScoreWorkflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cm&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Workflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;] {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewWorkflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLambdaNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;score_chunk&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableLambda&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;t&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreOneChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, cm, t)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(compose.START)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;End&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;score_chunk&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wf&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// scoreOneChunk 要求模型对单个分块的相关性进行评分（0–10）并提取最相关的摘录&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 解析错误会被视为 0 分，因此错误的 JSON 响应永远不会导致整个流水线中止&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreOneChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cm&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;t&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	prompt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;`请评分以下文本分块与问题的相关性。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;问题: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;文本分块:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;仅回复 JSON — 不要解释，不要 Markdown 代码块：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;{&quot;score&quot;: &amp;lt;0-10&amp;gt;, &quot;excerpt&quot;: &quot;&amp;lt;最相关的句子或短语，如果分数位 0 则为空字符串&amp;gt;&quot;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;评分指南: 0=完全无关, 3=略微相关, 7=清晰相关, 10=直接回答了问题。`&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		t.Question, t.Text)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resp, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cm.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Generate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{schema.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserMessage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(prompt)})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 将模型错误视为不相关，而不是中止整个批处理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Text: t.Text, Score: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(resp.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 去除可选的 markdown 代码块包装&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimPrefix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;```json&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimPrefix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;```&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSuffix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;```&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Score   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `json:&quot;score&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Excerpt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;excerpt&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unmarshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content), &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;sr); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Text: t.Text, Score: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Text: t.Text, Score: sr.Score, Excerpt: sr.Excerpt}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// synthesize 根据前 K 个分块构建提示词并生成带有引用的回答。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; synthesize&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cm&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;in&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; synthIn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sb &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Builder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;仅使用提供的文档摘录回答以下问题。&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;问题: &quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(in.Question)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;文档摘录:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sources &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(in.TopK))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i, c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; in.TopK {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		excerpt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.Excerpt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; excerpt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			excerpt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.Text&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		sources[i] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; excerpt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;sb, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;] &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, excerpt)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;提供简洁清晰的回答。在引用来源时，请注明摘录编号，如 [1]。&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resp, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cm.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Generate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{schema.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserMessage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(sb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;synthesize: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Answer: resp.Content, Sources: sources}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// splitIntoChunks 将文本切分为最大 chunkSize 字符的分块，&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 尽可能在段落边界 (\n\n) 处断开，其次是换行符。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; splitIntoChunks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;text&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;chunkSize&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunks []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Builder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	flush &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			chunks &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunks, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Content: s})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Reset&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, para &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Split&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(text, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		para &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(para)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; para &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(para)&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;			flush&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 如果段落本身超过了 chunkSize：按行拆分&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(para) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkSize {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Split&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(para, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(line)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(line)&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;					flush&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteByte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(line)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		} &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(para)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	flush&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunks&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 该包提供了一个由 compose.Workflow 支持的 answer_from_document（根据文档回答问题）工具。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 该工作流使用字段映射（field mapping）在非相邻节点（score, answer）之间共享用户的提问，&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 而无需将提问参数穿透传递给每一个中间节点的输出类型：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	开始节点 START{文件路径 FilePath, 提问 Question}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	   │ (通过 WithNoDirectDependency 传递数据)─────────────────────────────────────┐&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	  ▼                                                                            │ 提问 Question&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	[load 节点]  os.ReadFile → []*schema.Document (读取文档)                       │&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	  ▼                                                                            │&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	[chunk 节点] 段落拆分器 → []*schema.Document (分块)                            │&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	  ▼  分块 Chunks ──────────────────────────────────────────────────────────► [score 节点]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                                │ []scoredChunk (已评分分块)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                               ▼&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                            [filter 节点] 获取 Top-K&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                                │ TopK (可能为空)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                               ▼&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                            [answer 节点] ◄─ 提问 (来自 START)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                     (在线合成答案或返回未找到)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                                │&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                              结束 END&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// [score] 节点包装了一个 BatchNode，其内部工作流通过并行调用 ChatModel 对每个分块进行评分（最大并发数为 5）。&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-rag真实现-1&quot;&gt;RAG真实现&lt;/h3&gt;&lt;p&gt;以上我们阐释了RAG伪实现的实现方法：把文档拆分为Chunk，再让llm对Chunk与问题的匹配度进行打分，最后选取TopK返回给Agent节点流&lt;/p&gt;
&lt;p&gt;而真正的RAG一般分为两个部分：文档建库 和 问答检索&lt;/p&gt;
&lt;p&gt;其中，文档建库负责读取 PDF、Markdown、网页等原始资料并把内容转成纯文本或结构化文本，再把长文档切成Chunk小片段，比如每块 300-1000 tokens，再用 embedding 模型把每个 chunk 转成向量并与文档元信息一起存入向量数据库中&lt;/p&gt;
&lt;p&gt;而问答检索这负责吧用户的问题用 embedding 转换为向量，并在向量库里找和问题向量最接近的 Top-K chunk，最后把 Top-K 片段按一定格式放进 prompt，LLM 根据检索到的资料回答，并附上引用来源&lt;/p&gt;
&lt;p&gt;具体流程如下：&lt;/p&gt;
&lt;figure&gt;&lt;img src=&quot;https://www.claran-blog.work/rss-assets/15572c63d2eb7965e82947c4.png&quot; alt=&quot;文章图表：离线阶段：构建知识库、原始文档、清洗 / 解析、文本切块、Embedding 模型向量化、写入向量数据库、保存原文 chunk / metadata&quot; width=&quot;480&quot; height=&quot;490&quot; style=&quot;max-width:100%;height:auto;vertical-align:middle&quot; /&gt;&lt;/figure&gt;&lt;figure&gt;&lt;img src=&quot;https://www.claran-blog.work/rss-assets/32c75688c633334720ef2bf7.png&quot; alt=&quot;文章图表：在线阶段：用户问答、用户提问、问题向量化、向量数据库相似度检索、取回 Top-K 文档片段、其他RAG附加方案、拼接检索上下文、LLM 生成答案、返回答案 + 引用来源&quot; width=&quot;232&quot; height=&quot;769&quot; style=&quot;max-width:100%;height:auto;vertical-align:middle&quot; /&gt;&lt;/figure&gt;&lt;p&gt;在进行Chunk切分时，我们通常会遵循一些常规切法，例如按段落、标题层级、固定 token 数、Markdown / HTML / PDF 结构、或者句子切分，以保证chunk质量&lt;/p&gt;

&lt;h3 id=&quot;article-基础设施-1&quot;&gt;基础设施&lt;/h3&gt;&lt;p&gt;上文中我们提到了两个之前没有接触到的基础设施：向量数据库与embedding模型&lt;/p&gt;

&lt;h4 id=&quot;article-向量数据库-1&quot;&gt;向量数据库&lt;/h4&gt;&lt;p&gt;字面意思，就是专门用来存储向量的数据库，向量数据库不仅能能存储向量和schema，还能快速做ann检索&lt;/p&gt;
&lt;p&gt;在这里我们使用最常用的向量数据库milvus做RAG基础设施&lt;/p&gt;
&lt;p&gt;类比于MySQL，在milvus中，collection = 表，entity = 行&lt;/p&gt;
&lt;p&gt;有关更多Milvus介绍：&lt;strong&gt;&lt;a href=&quot;https://milvus.io/docs/zh/quickstart.md&quot;&gt;快速入门 Milvus Lite&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-embedding模型-1&quot;&gt;embedding模型&lt;/h4&gt;&lt;p&gt;我们知道，RAG检索的基础依赖于向量，同时我们也需要把数据先转换成向量再入库，而embedding模型就负责把数据转换成向量&lt;/p&gt;
&lt;p&gt;这一块其实没啥好说的，在你使用的api平台找个embedding模型用就可以了&lt;/p&gt;

&lt;h3 id=&quot;article-rag方案-1&quot;&gt;RAG方案&lt;/h3&gt;&lt;p&gt;其实基础的RAG很简单，就是字面意思：检索+生成，本质文档拆分+向量检索。这种基础的RAG体系已经能支持一套完整的知识库系统运作&lt;/p&gt;
&lt;p&gt;但是，如果我们需要构建的知识库文档的量级达到10w，甚至1000w的量级呢？给你1000w份文档，怎么做合理RAG？怎么保证向量召回质量？怎么RAG链路可用？&lt;/p&gt;
&lt;p&gt;在Milvus单库的情况下，加上一些合适的RAG策略，我们足以应对百万级文档的RAG需求，至于千万量级，可以考虑上多库主从等数据库策略了。在这里我们要做出百万级RAG方案，就需要企业级的RAG策略，针对文档切分、向量召回和Agent决策进行全面优化&lt;/p&gt;

&lt;h4 id=&quot;article-hybrid-rag-1&quot;&gt;Hybrid RAG&lt;/h4&gt;&lt;p&gt;首先，我们要优化&lt;strong&gt;检索召回环节&lt;/strong&gt;，使用Hybrid RAG来代替纯向量检索&lt;/p&gt;
&lt;p&gt;常规的RAG向量检索，是根据&lt;strong&gt;语义向量&lt;/strong&gt;空间中的数学距离判断召回文本的，这就可能会导致不能正常判断并检索召回某些专有名词或者指定代码等&lt;strong&gt;非常规语义向量&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;因此，我们就需要在常规RAG的语义向量检索的基础上加上关键词检索相关功能&lt;/strong&gt;，这就是Hybrid RAG做的事&lt;/p&gt;
&lt;p&gt;也就是说，Hybrid Search 把两种检索合起来：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Dense Search：语义向量检索&lt;/li&gt;
&lt;li&gt;Sparse / BM25 Search：关键词/全文检索&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;然后把两边结果融合&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;                     ┌─&amp;gt; Dense Vector Search ─────┐&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;用户问题 ────────────┤                            ├─&amp;gt; ... ─&amp;gt; topK chunks ─&amp;gt; LLM&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                     └─&amp;gt; BM25 / Sparse Search ────┘&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;Milvus 官方现在支持 hybrid search、多向量字段、BM25 sparse full-text search，以及 RRF/WeightedRanker 这类 reranking 策略&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;这里涉及到&lt;strong&gt;BM25&lt;/strong&gt;这一个陌生的概念：BM25 就是传统全文检索里的经典排序算法，细节实现请看：&lt;strong&gt;&lt;a href=&quot;https://blog.csdn.net/weixin_69500620/article/details/161751314&quot;&gt;BM25 算法详解：从原理到代码实现，掌握搜索与 RAG 的核心检索技术&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;，就算不了解具体实现，我们也可以直接把BM25当成一个关键词匹配算法的黑箱&lt;/p&gt;
&lt;p&gt;即时实现了这两种不同的检索方式，我们还要考虑怎么合并这两条检索链路&lt;/p&gt;
&lt;p&gt;这里我们常用RRF（Reciprocal Rank Fusion）， 不关心原始相关分数，而是看召回内容排名&lt;/p&gt;
&lt;p&gt;我们根据假设 dense 搜索结果：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;A 排第 1&lt;/li&gt;
&lt;li&gt;B 排第 2&lt;/li&gt;
&lt;li&gt;C 排第 3&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;BM25 搜索结果：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;B 排第 1&lt;/li&gt;
&lt;li&gt;D 排第 2&lt;/li&gt;
&lt;li&gt;A 排第 3&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;RRF 会认为：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;A 两边都出现，应该靠前&lt;/li&gt;
&lt;li&gt;B 两边都出现，而且排名高，也应该靠前&lt;/li&gt;
&lt;li&gt;C 只在 dense 出现&lt;/li&gt;
&lt;li&gt;D 只在 BM25 出现&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;也就是说，如果某个 chunk 同时在 dense 和 BM25 中出现，它的优先顺位就很高，但如果它只在 dense 出现或者只在 BM25 出现，就只能进候选&lt;/p&gt;
&lt;p&gt;这种合并方法更为稳定且简单，适合作为默认方案，重要的是Milvus reranking 文档里也支持 RRFRanker&lt;/p&gt;

&lt;h4 id=&quot;article-分层索引-parent-child-chunk-1&quot;&gt;分层索引：Parent-Child Chunk&lt;/h4&gt;&lt;p&gt;其次，我们继续优化&lt;strong&gt;文本切分环节&lt;/strong&gt;，使用l父子分块检索 Parent-Child Chunk 做更精细的文本切分，也就是我们常说的分层索引或者大小Chunk&lt;/p&gt;
&lt;p&gt;在常规的文本切块的环节中，&lt;strong&gt;如果我们切出来的Chunks过于精细短小，虽然会让检索更准，过程噪声更少，但是也会让上下文不完整，LLM 也可能看不懂前因后果&lt;/strong&gt;；&lt;strong&gt;如果切出来的Chunks过过于完整冗长，尽管能保证上下文完整，但是会让 embedding 被稀释，检索不准，容易召回一大段泛相关内容&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;于是，我们可以&lt;strong&gt;对同一份带切分内容切两次，一次切大Chunk（Parent Chunk），一次切小Chunk（Child Chunk）&lt;/strong&gt;，这就是 Parent-Child Chunk 的基本思想，在维护父子Chunk的情况下，我们用更精细的 child chunk 做检索，用完整的 parent chunk 和 child 周边上下文做回答&lt;/p&gt;
&lt;p&gt;于是，完整的切分流程变成了：文档 -&amp;gt; 检索 child chunks -&amp;gt; 找到最相关 child -&amp;gt; 根据 parent_id 找 parent chunk -&amp;gt; 把 parent 或相邻 child 作为上下文给 LLM&lt;/p&gt;
&lt;p&gt;与此同时，我们有需要考虑 Parent chunk 太大时可能撑爆 prompt，这里有两种解法：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;对 Parent Chunk 做 Summary 摘要，并返回 parent summary + hit child&lt;/li&gt;
&lt;li&gt;取命中的 child 前后各 1 个 相邻 Child CHunk&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;一般在实际业务中，我们可以直接做一个Parent路由，根据 parent chunk 大小做截断：当Parent过大时采取方法一，在Parent不大时全量返回Parent并结合方法二做prompt&lt;/p&gt;
&lt;p&gt;同时，我们在切文本语义chunk时注意维护每个chunk间的overlap，一般来说，普通文本 overlap 可以是 chunk 长度的 10% 到 20%&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;Overlap 就是相邻 chunk 之间重叠一部分内容&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;与此同时，我们应做好良好的切分策略：针对 Markdown 文档按不同级别标题切分；针对PDF / Word，先解析成结构化文本，再按标题/段落切；针对代码部分，按特殊代码结构切等&lt;/p&gt;

&lt;h4 id=&quot;article-rerank-1&quot;&gt;rerank&lt;/h4&gt;&lt;p&gt;还记得我们说过的hybrid rag吗？是不是觉得hybrid rag本质上并没有提升rag召回的结果？这就对了，因为我们还需要做召回结果的rerank&lt;/p&gt;
&lt;p&gt;我们之前提过的hybrid rag，主要追求的指标是&lt;strong&gt;召回率&lt;/strong&gt;，而非召回质量，因此我们用rerank做&lt;strong&gt;召回质量&lt;/strong&gt;的过滤&lt;/p&gt;
&lt;p&gt;具体来说，在RRF fusion后，我们针对结果的TopN，让reranker模型同时读 query 和 chunk，并判断这个 chunk 对 query 到底有多相关，再根据判别结果筛选出TopK，也就是&lt;strong&gt;重新排序已经召回出来的一小批候选文档&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;简单来说，Rerank 的做法是在检索和生成之间加一个精排步骤：用 Reranker 模型给每对 (query, doc) 重新打分&lt;/p&gt;
&lt;p&gt;在这样的模式下，Reranker 输入：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;query&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;项目里的 Agent 如何触发？&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;documents&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;文档标题...&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;chunk 内容...&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;文档标题...&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;chunk 内容...&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;文档标题...&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;chunk 内容...&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  ],&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;top_n&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;输出&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  { &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;&quot;index&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;&quot;relevance_score&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.93&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  { &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;&quot;index&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;&quot;relevance_score&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.87&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  { &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;&quot;index&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;&quot;relevance_score&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.71&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;需要注意的是，reranker模型不是小llm，而是专门的reranker模型&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;于是现在的检索召回流程就十分完整：Hybrid Search + RRF -&amp;gt; 得到 top 30 -&amp;gt; Model Reranker -&amp;gt; 得到 top 5&lt;/p&gt;

&lt;h4 id=&quot;article-crag-1&quot;&gt;CRAG&lt;/h4&gt;&lt;p&gt;但如果rerank精排后的召回内容仍然不满足query所需，怎么办呢？我们做CRAG（Corrective RAG），把检索结果当成不可信输入，先判断检索结果质量，再决定怎么回答或怎么补救&lt;/p&gt;
&lt;p&gt;具体来说，CRAG 就是把rerank搜到的资料过滤一遍，在检索和生成之间插一个质检员（evaluator），逐个审查检索到的文档是否和问题相关，然后根据审查结果走不同的分支：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;打分高的，说明资料靠谱，直接喂给大模型生成答案&lt;/li&gt;
&lt;li&gt;打分低的，说明内部知识库里压根没找着相关内容，可以再做一次RAG链路，或者询问用户补充信息/干脆回退到 Web 搜索兜底&lt;/li&gt;
&lt;li&gt;打分模糊的，就两边的结果合一起送进去，并提醒用户结果不确定性&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;于是，现在的RAG链路变成了：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;用户问题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; Router 判断是否需要 RAG&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; Hybrid Search&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; RRF 融合&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; Rerank 精排&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; CRAG Evaluator&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ├─ correct   -&amp;gt; 用内部资料回答&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ├─ incorrect -&amp;gt; 重新检索 / Web 搜索 / 询问用户 / 返回资料不足&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      └─ ambiguous -&amp;gt; 扩展检索 / 内部 + 外部合并 / 提醒不确定性&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; LLM 生成&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;hr /&gt;
&lt;p&gt;一个好的 CRAG evaluator 不只问“相关吗”，而是问四个东西：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;Relevance&lt;/code&gt;：相关性&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt; 资料是否真的围绕用户问题？是否只是命中了关键词？&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;Coverage&lt;/code&gt;：覆盖度&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt; 资料是否覆盖回答所需关键点？&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;Specificity&lt;/code&gt;：具体性&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt; 资料是否足够具体？是否有接口、字段、流程、条件、代码位置？&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;Conflict&lt;/code&gt;：冲突性&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt; 资料之间是否互相矛盾？是否新旧版本说法不一致？&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;所以，我们也可以认为CRAG做的是 检索系统 + 质量评估器 + 纠错分支&lt;/p&gt;
&lt;p&gt;最后，CRAG返回：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; &quot;label&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;correct/incorrect/ambiguous&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//充分、不充分和勉强充分&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; &quot;score&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.86&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; &quot;relevance&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.92&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; &quot;coverage&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.81&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; &quot;specificity&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.84&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; &quot;conflict&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.05&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; &quot;reason&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;资料直接说明接口、状态和重试流程......&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;evaluator一般由项目小模型实现&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-self-rag-1&quot;&gt;Self-RAG&lt;/h4&gt;&lt;p&gt;CRAG 在检索阶段做了质检，但是其他阶段呢？我们就可以做Self-RAG做全流程自检&lt;/p&gt;
&lt;p&gt;如果说 CRAG 是“检索结果质检”，那 Self-RAG 是把整个 RAG 流程拆成几个可审计的自检节点，在整个流程中设置四个检查点，每一步都让模型自我审视：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;这个问题需要检索吗（Retrieve）？&lt;/li&gt;
&lt;li&gt;检索到的文档相关吗（IsRel）？&lt;/li&gt;
&lt;li&gt;我的回答有文档支撑吗（IsSup）？&lt;/li&gt;
&lt;li&gt;这个答案对用户有用吗（IsUse）？&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;在链路中就是：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;query&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 判断是否需要检索&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 检索&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 判断检索资料是否相关&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 生成答案&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 判断答案是否被资料支撑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 判断答案是否有用&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 必要时重新检索、改写答案或承认资料不足&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;即一个带“自检节点”的 RAG 工作流&lt;/p&gt;

&lt;h5 id=&quot;article-四大检查点-1&quot;&gt;四大检查点&lt;/h5&gt;&lt;ol&gt;
&lt;li&gt;&lt;code&gt;Retrieve&lt;/code&gt;：同Router，自检这个 query 需要检索吗？需要查哪个源？用原 query 还是改写后的 query？&lt;/li&gt;
&lt;li&gt;&lt;code&gt;IsRel&lt;/code&gt;：同CRAG，自检检索到的资料和 query 相关吗？&lt;/li&gt;
&lt;li&gt;&lt;code&gt;IsSup&lt;/code&gt;：答案中的关键断言是否被资料支撑？&lt;/li&gt;
&lt;li&gt;&lt;code&gt;IsUse&lt;/code&gt;：这个答案对用户有用吗？是否回答了用户真正要的东西？&lt;/li&gt;
&lt;/ol&gt;
&lt;blockquote&gt;
&lt;p&gt;需要注意的是，Self-RAG 不是让 LLM 自己随便跑工具，而是让LLM给出结构化判断，应用代码执行检索和权限控制&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;在具体实现中，可以把 Self-RAG 看成一个有限状态机：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;Step 1 Retrieve Judge&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  输入：user query + minimal context&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  输出：need_retrieve, source, rewritten_query, route&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Step 2 Query Rewrite&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  输入：query + route&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  输出：retrieval query&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Step 3 Retrieval&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  应用代码执行：Hybrid / BM25 / Milvus / Memory / Web&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Step 4 IsRel&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  输入：query + chunks&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  输出：相关 / 不相关 / 部分相关&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Step 5 Generate Draft&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  输入：query + vetted chunks&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  输出：draft answer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Step 6 IsSup&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  输入：query + chunks + draft&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  输出：是否被来源支撑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Step 7 IsUse&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  输入：query + chunks + draft&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  输出：是否有用&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Step 8 Repair&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  如果失败：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    rewrite query&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    expand retrieval&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ask clarification&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    regenerate&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    answer with insufficiency&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;我们可以发现，Self-RAG与CRAG在某些判断上极为相似，因此我们在工程上可以复用：&lt;/p&gt;
&lt;p&gt;&lt;code&gt;CRAG.relevance&lt;/code&gt; -&amp;gt; &lt;code&gt;SelfRAG.IsRel&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;&lt;code&gt;CRAG.label&lt;/code&gt;     -&amp;gt; &lt;code&gt;SelfRAG.IsSup&lt;/code&gt; (弱信号)&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-adaptive-rag-1&quot;&gt;Adaptive RAG&lt;/h4&gt;&lt;p&gt;我们发现，整合CRAG和Self-RAG后，CRAG 和 Self-RAG 都在给 RAG 加流程来解决问题，但这样多了好几次 LLM 调用，增加了成本，于是我们可以用Adaptive RAG做RAG最上游的路由&lt;/p&gt;
&lt;p&gt;Adaptive RAG 就是在RAG链路最前面加了一个路由器（分类器），先判断问题的复杂度，然后决定走哪条路线：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;用户问题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  -&amp;gt; Router / Classifier 判断问题类型和复杂度&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  -&amp;gt; 选择不同路线&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      简单问题：直接回答&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      普通知识库问题：轻量检索&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      复杂项目问题：Hybrid Search + Rerank&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      高风险问题：Self-RAG / CRAG / 多轮校验&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      实时问题：Web Search&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      私有记忆问题：Memory Search&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      工具动作：Tool Call&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  -&amp;gt; 回答&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;核心就是：&lt;strong&gt;先路由，再检索&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;而我们说的 Router 就是最前面的分类器。它的输入通常是：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;用户问题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;会话上下文&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;可用知识源&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;用户身份和权限&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;当前产品模式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;成本/延迟预算&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;输出是结构化决策，例如：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &quot;route&quot;: &quot;project_rag&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &quot;complexity&quot;: &quot;medium&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &quot;need_retrieve&quot;: true,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &quot;sources&quot;: [&quot;project_docs&quot;, &quot;code_chunks&quot;],&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &quot;strategy&quot;: &quot;hybrid_rerank&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &quot;mode&quot;: &quot;hybrid&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &quot;retrieval_source&quot;: &quot;project_docs&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &quot;query&quot;: &quot;agent_dispatch_records event_id agent_user_id&quot;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  &quot;reason&quot;: &quot;问题依赖当前项目内部实现&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;然后根据这种结构化决策判断：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;要不要检索&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;用什么检索策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;是否需要 rerank&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;是否需要 CRAG / Self-RAG&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;是否需要 Web&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;是否是工具动作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;是否需要拒绝或询问澄清&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;具体实现：规则 + LLM 混合 即可&lt;/p&gt;
&lt;p&gt;规则能确定的直接走规则，规则不确定的交给 LLM Router&lt;/p&gt;

&lt;h4 id=&quot;article-text-to-sql-rag-1&quot;&gt;Text-to-SQL RAG&lt;/h4&gt;&lt;p&gt;有没有想过，如果我们的数据本身就是结构化的表格，比如销售数据、用户行为日志、财务报表这些，就不合适传统的 RAG ，因为对表格数据做 embedding 是非常低效的。&lt;strong&gt;因此，当知识不是“文档段落”，而是 结构化数据库 时，RAG 的 retrieval 不再是“检索 chunk”，而是“生成并执行 SQL”&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;也就是说，Text-to-SQL RAG本质上不再是传统RAG：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;传统 RAG:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  query -&amp;gt; retrieve text chunks -&amp;gt; generate answer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Text-to-SQL RAG:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  query -&amp;gt; generate SQL -&amp;gt; execute query -&amp;gt; generate answer from rows\&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;关于 Text-to-SQL 的详细内容，我并没有深入了解，详细解析请看：&lt;strong&gt;&lt;a href=&quot;https://blog.csdn.net/qq_65052774/article/details/156145640&quot;&gt;基于 Text-to-SQL 的科研级 RAG 系统构建指南&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-agentic-rag-1&quot;&gt;Agentic RAG&lt;/h4&gt;&lt;p&gt;Agentic RAG这一块，我个人认为比起RAG，更像是&lt;strong&gt;在RAG上再搭建了一层Agent，为该Agent注册各种RAG工具，再由这个Agent根据中间结果动态决定RAG链路&lt;/strong&gt;，因此业务极其复杂，需要把现有的RAG链路方法包装为Agent工具，涉及架构变化&lt;/p&gt;
&lt;p&gt;因此，我们需要在一个真实系统里的 Agentic RAG 给 Agent 配这些工具：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;hybrid_search(query, scope)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;graph_search(entity_or_question)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;text_to_sql(question, database_scope)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;memory_search(query, user_scope)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;web_search(query)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;file_search(query)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;code_search(query)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;rerank(candidates)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;summarize_sources(sources)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;然后，在RAG流程中使用该Agent做ReAct循环：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;用户问题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; Agent 判断问题类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 计划：需要查项目文档 + 代码 + 图谱&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 调 hybrid_search(&quot;RAG 上传 retry 接口&quot;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 观察：找到了 API 文档，但缺实现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 调 code_search(&quot;RetryUploadJob rag upload&quot;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 观察：找到 handler/service&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 调 graph_search(&quot;rag-service upload retry&quot;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 观察：找到相关服务节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 判断资料足够&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 生成答案，并引用来源&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;并且还要考虑该Agent的沙箱边界等&lt;/p&gt;
&lt;p&gt;总的来说，&lt;strong&gt;Agentic RAG应该是前期结构规范设计的一部分，而非RAG优化流程&lt;/strong&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-graph-rag-1&quot;&gt;Graph RAG&lt;/h4&gt;&lt;p&gt;我认为，Graph RAG 是脱离常规RAG和向量数据以外一种特殊的RAG实现方法，它先把文档及其相关关系和实体变成知识图谱，再基于图谱来检索和推理，是依赖 实体、关系、多跳路径、局部网络结构 的一整套系统&lt;/p&gt;
&lt;p&gt;具体来说，GraphRAG 的思路就是：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;由 LLM 逐篇读文档，抽取里面的实体（人、部门、产品等）和关系，构建成一张图谱&lt;/li&gt;
&lt;li&gt;再用图来定位实体、扩展关系、用 Leiden 算法对图谱做社区划分，把关联紧密的实体聚成一团，然后让 LLM 为每个社区生成一段摘要&lt;/li&gt;
&lt;li&gt;最后让 LLM 基于结构化上下文回答&lt;/li&gt;
&lt;li&gt;提问时先定位到相关实体，沿着关系拿到子图&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;也就是&lt;strong&gt;把文档中的知识抽成图，再基于图做检索增强生成&lt;/strong&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-实体与关系-1&quot;&gt;实体与关系&lt;/h5&gt;&lt;p&gt;我们需要明确，在Graph RAG中，图里有两种核心东西：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;实体 Entity&lt;/li&gt;
&lt;/ul&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;msg-core-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;description&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;消息核心服务，负责会话、消息写入、已读游标和 Outbox&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;aliases&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;消息核心服务&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;MessageService&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;ul&gt;
&lt;li&gt;关系 Relationship&lt;/li&gt;
&lt;/ul&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;source&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;msg-core-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;target&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;event_outbox&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;WRITES&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;description&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;消息事务中写入 event_outbox&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;evidence&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送消息时同事务写入 messages、message_user_states 和 event_outbox&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;confidence&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.86&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;并且，在一个完善的Graph RAG中，不是只保存 A RELATED_TO B，而是保存有业务语义的关系：如依赖、引出、调用、包含、产出......&lt;/p&gt;

&lt;h5 id=&quot;article-离线构建-1&quot;&gt;离线构建&lt;/h5&gt;&lt;p&gt;GraphRAG 一般分两条链路：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;离线构建 indexing&lt;/li&gt;
&lt;li&gt;在线查询 query&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;类似RAG的文档切分和入库，Graph RAG的离线构建就是LLM构建实体和关系的过程&lt;/p&gt;
&lt;p&gt;这也是LLM从文档中抽取实体/关系的核心：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;文档解析&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; chunk&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; LLM / 规则抽实体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; LLM / 规则抽关系&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; entity resolution 实体归一化&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 写入图数据库&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 社区发现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 社区摘要&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Prompt 大概是：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;请从下面文本中抽取实体。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;实体类型包括：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- Service&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- DatabaseTable&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- EventTopic&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;返回 JSON：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;entities&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;msg-core-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;description&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;消息核心服务，负责会话、消息写入、已读游标和 Outbox&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;aliases&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;消息核心服务&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;event_outbox&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;DatabaseTable&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;description&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;事务 Outbox 表，用于保存待发布事件&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;aliases&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: []&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  ]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;然后继续让 LLM 抽关系：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;基于文本和已抽取实体，抽取实体之间的关系。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;关系类型包括：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- CALLS&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- PUBLISHES&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- CONSUMES&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- STORES&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- OWNS&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- DEPENDS_ON&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- CONFIGURES&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- TRIGGERS&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- READS&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- WRITES&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;返回 JSON：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;relationships&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;source&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;msg-core-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;target&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;event_outbox&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;WRITES&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;description&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;msg-core-service 在消息事务中写入 event_outbox&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;evidence&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送消息时同事务写入 messages、message_user_states 和 event_outbox&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;source&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;websocket-gateway&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;target&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;claran.message.events&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;CONSUMES&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;description&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;websocket-gateway 消费消息事件并推送在线用户&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;evidence&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;websocket-gateway 消费 claran.message.events&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  ]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-实体归一化-1&quot;&gt;实体归一化&lt;/h5&gt;&lt;p&gt;不同 chunk 可能抽出：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;msg-core-service&lt;/li&gt;
&lt;li&gt;消息核心服务&lt;/li&gt;
&lt;li&gt;msg core service&lt;/li&gt;
&lt;li&gt;MessageService&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;它们可能指同一个实体，所以要做实体归一化 entity resolution，判断这些实体是不是同一个&lt;br /&gt;如果不合并，图会碎成多个节点，多跳查询会断。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;规则：小写、去符号、统一中英文别名&lt;/li&gt;
&lt;li&gt;别名表：人工维护重要实体&lt;/li&gt;
&lt;li&gt;LLM：判断两个实体是否同指&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;最终保留：&lt;br /&gt;&lt;code&gt;canonical name: msg-core-service&lt;/code&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-图存储-1&quot;&gt;图存储&lt;/h5&gt;&lt;p&gt;如果想追求高效便捷地存储图类数据，我们一般会用Neo4j，&lt;strong&gt;Neo4j 是一个 图数据库，专门用来存和查询“节点之间的关系”&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;Neo4j快速开始：&lt;strong&gt;&lt;a href=&quot;https://neo4j.ac.cn/docs/getting-started/languages-guides/neo4j-go/&quot;&gt;从 Go 使用 Neo4j&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-leiden-社区划分-1&quot;&gt;Leiden 社区划分&lt;/h5&gt;&lt;p&gt;图大了以后，不能每次查询都拿全图。社区划分可以把关系紧密的实体聚成 community，类似于“图谱自动分板块”&lt;/p&gt;
&lt;p&gt;比如项目图谱可能分出：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;IM 消息链路：&lt;br /&gt;&lt;code&gt;msg-core-service&lt;/code&gt;, &lt;code&gt;messages, event_outbox&lt;/code&gt;...&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Agent 事件链路：&lt;br /&gt;&lt;code&gt;agent-manager-service&lt;/code&gt;, &lt;code&gt;agent-runtime-service&lt;/code&gt;...&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Memory/RAG：&lt;br /&gt;&lt;code&gt;memory-service&lt;/code&gt;, &lt;code&gt;memory_facts&lt;/code&gt;, &lt;code&gt;Milvus&lt;/code&gt;...&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;文件服务：&lt;br /&gt;&lt;code&gt;file-service&lt;/code&gt;, &lt;code&gt;MinIO&lt;/code&gt;, &lt;code&gt;OCR&lt;/code&gt;...&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;而一般社区划分这个过程我们会用到Leiden算法：Leiden 是常用社区发现算法，能得到连通性很好的社区&lt;/p&gt;
&lt;p&gt;有关Leiden科普：&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/712714461&quot;&gt;万字长文详解社区发现算法Leiden&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;工程实现详细见：&lt;strong&gt;&lt;a href=&quot;https://neo4j.ac.cn/docs/graph-data-science/current/algorithms/leiden/&quot;&gt;New4j | Leiden&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-社区摘要-1&quot;&gt;社区摘要&lt;/h5&gt;&lt;p&gt;就像parent chunk不能塞进prompt一样，社区里可能几十个节点、上百条边，也不能每次全塞 prompt，所以我们可以提前对社区生成 summary：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;title: Agent 事件调度链路&lt;/li&gt;
&lt;li&gt;summary: 本社区描述 Agent 如何订阅 IM 事件...&lt;/li&gt;
&lt;li&gt;key_entities:  &lt;code&gt;agent-manager-service&lt;/code&gt;, &lt;code&gt;agent-runtime-service&lt;/code&gt;...&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-在线查询-query-1&quot;&gt;在线查询 Query&lt;/h5&gt;&lt;p&gt;查询时：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;用户问题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; entity linking：识别问题中的实体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 找图谱节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 扩展 1-2 跳子图&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 找所属社区摘要&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 回源 evidence chunks&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; 合并普通 RAG 结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt; -&amp;gt; LLM 回答&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt; 最终上下文不应该一堆散文，而是：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;[社区摘要]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Agent 事件调度链路...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;[子图关系]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;agent-manager-service WRITES agent_dispatch_records&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;agent-manager-service CONSUMES claran.im.events&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;agent-runtime-service GENERATES Agent 回复&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;[原文证据]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;对应 chunk / 文件 / 文档段落&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-rag应用-1&quot;&gt;RAG应用&lt;/h3&gt;&lt;p&gt;这里浅谈一下RAG的一些应用&lt;/p&gt;

&lt;h4 id=&quot;article-memory管理-1&quot;&gt;Memory管理&lt;/h4&gt;&lt;p&gt;我们可以用简单的RAG做Agent的记忆管理，例如自动记忆提取、自动生成记忆、召回记忆等：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Agent 对话结束后，异步判断是否应该生成新记忆&lt;/li&gt;
&lt;li&gt;记忆冲突处理：更新旧记忆、降低旧记忆权重。&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-智能会话管理-1&quot;&gt;智能会话管理&lt;/h4&gt;&lt;p&gt;再比如，在一个IM系统中，我们可以在会话中集成Agent+RAG的链路&lt;/p&gt;
&lt;p&gt;我们可以在聊天记录模块做 RAG，因为在 IM 系统里，聊天记录 RAG 很有价值，我们可以找历史讨论、总结某段时间发生了什么、找某个文件/任务/结论出处、Agent 根据长期群聊上下文回答&lt;/p&gt;
&lt;p&gt;与此同时，实现聊天记录RAG也有几个难点：噪声大、数量多、权限复杂、实时增长快、短消息语义弱、重复寒暄多等。因此我们考虑集成Adaptive RAG，避免把“好”，“nb”等口头语做RAG占用资源&lt;/p&gt;
&lt;p&gt;更进一步，聊天记录 RAG 不应该直接“每条消息都入 Milvus”，更合理的是分层：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;短期上下文：直接从 msg-core 拉最近 N 条&lt;/li&gt;
&lt;li&gt;长期聊天 RAG：对会话片段/摘要做向量化、按时间窗口/话题聚合、生成 conversation_summary / decision / task / topic chunk&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;也就是说，聊天记录 RAG 的对象最好是会话片段摘要、讨论结论、任务决策等，而不是每一条碎消息&lt;/p&gt;
&lt;p&gt;与此同时，聊天记录的rag可以做定时任务，固定时间拉取一段时间内所有信息或者每100条信息做一次收集+总结摘要，做conversation_summary / decision / task / topic chunk或者金句/用户要求记忆或者价值信息，再入strict rag&lt;/p&gt;
&lt;p&gt;也就是：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;  Scheduler 每分钟扫描活跃会话&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  -&amp;gt; 找到满足条件的 conversation&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  -&amp;gt; 创建 digest job&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-后记-1&quot;&gt;后记&lt;/h2&gt;&lt;p&gt;最近真是忙死了，每天都要去医院照顾老人，去学校打体育卡，还要去京东MALL选重装旧房需要的新家具，一天到晚没啥空，累死了，忙死了，相似了，好想似，好想似，好想似，好想似，好想似，好想似，晚上又有Major，现在好想睡觉&lt;/p&gt;
&lt;p&gt;不过也有喜报，趁着买新家具顺了个电竞椅，虽然要9月份才能搬进去&lt;/p&gt;
&lt;p&gt;总算抽时间把这个RAG博客搞完了，虽然有些地方并没有这么细致，也没有展示工程代码......&lt;/p&gt;
&lt;p&gt;期末周......&lt;/p&gt;
&lt;p&gt;这篇文章后应该又会沉寂许久，接下来就是期末周+底层/拷打/八股的学习，下一篇又会是很久以后的随笔来总结近况了吧&lt;/p&gt;

&lt;h2 id=&quot;article-参考文章-1&quot;&gt;参考文章&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.cnblogs.com/yupi/p/19914426&quot;&gt;RAG 是什么？16 种 RAG 方案一次讲清&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://milvus.io/docs/zh/quickstart.md&quot;&gt;快速入门 | Milvus 文档&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://milvus.io/docs/zh/manage_databases.md&quot;&gt;数据库 | Milvus 文档&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://blog.csdn.net/Algorhythm/article/details/153186809&quot;&gt;Go构建向量数据库：如何在1小时内完成百万级向量检索环境部署&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://blog.csdn.net/weixin_69500620/article/details/161751314&quot;&gt;BM25 算法详解：从原理到代码实现，掌握搜索与 RAG 的核心检索技术&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://blog.csdn.net/qq_65052774/article/details/156145640&quot;&gt;基于 Text-to-SQL 的科研级 RAG 系统构建指南&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://neo4j.ac.cn/docs/getting-started/languages-guides/neo4j-go/&quot;&gt;从 Go 使用 Neo4j&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/712714461&quot;&gt;万字长文详解社区发现算法Leiden&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://neo4j.ac.cn/docs/graph-data-science/current/algorithms/leiden/&quot;&gt;New4j | Leiden&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-rag1/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Agent</category><category>Golang</category><category>后端</category></item><item><title>随笔.9：简单回顾，重整旗鼓</title><link>https://www.claran-blog.work/posts/diary9/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/diary9/</guid><description>对最近两个月的回顾.</description><pubDate>Sun, 14 Jun 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-随笔-9-1&quot;&gt;随笔.9&lt;/h2&gt;
&lt;h3 id=&quot;article-前言-1&quot;&gt;前言&lt;/h3&gt;&lt;p&gt;在博客上沉寂了两个月，这段时间一直在搞其他东西以及一个小项目，基本没有产出&lt;/p&gt;
&lt;p&gt;我该怎么写呢，感觉事情挺多的，但又不是很重要&lt;/p&gt;
&lt;p&gt;还是记流水账好了&lt;/p&gt;

&lt;h3 id=&quot;article-项目-1&quot;&gt;项目&lt;/h3&gt;&lt;p&gt;ls发了最终考核AIM，于是就写项目去了&lt;/p&gt;
&lt;p&gt;怎么说呢，大概是四月底init了仓库后，然后从五月十号开始正式写项目&lt;/p&gt;
&lt;p&gt;虽然是在vibe项目，不过我就简称写项目了&lt;/p&gt;
&lt;p&gt;刚开始写项目时，因为没找到好用的中转站，所以用的是Trae，用 glm5/glm5.1 每次对话都要排几千人的队，而且每次对话还限制思考上限，需要手动继续，然后再排几千人的队，十分折磨&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/TRAE.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;然后过了几天，在群u kg 的推荐下，搞到了一个1元10刀的gpt中转站，虽然有注水，而且不是很稳定，但是架不住便宜，于是就转codex+gpt5.5了，不得不说，不TRAE好用太多了。不过因为习惯原因，我并没有用VSC的拓展，而是坚持Codex Desktop + VSC俩窗口来回切&lt;/p&gt;
&lt;p&gt;如此便宜的中转站成了压死我古法编程的最后一根稻草，codex+gpt5.5的轮椅体验简直是如雷轰顶，能忍住不用的也是神人了&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Codex.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;于是，以我天天在家住为背景，从17号开始，到28号结束，我的每一天差不多是这样的：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;10点多起床 -&amp;gt; 有不能逃的课去上课（CAD、SW啥的） -&amp;gt; 雷霆2KM -&amp;gt; 回家开始指挥codex工作 -&amp;gt; codex工作期间刷手机w -&amp;gt; codex工作完，测试一下 -&amp;gt; 循环&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;嗯，还是挺摆的，这就是在家的坏处，氛围太轻松了，之后再细讲&lt;/p&gt;
&lt;p&gt;于是我就这么迷迷糊糊地到了五月底，亲戚孩子满月去了趟成都，又开始有压力了，于是在去成都前让codex给我的项目写了20份的学习文档，在成都期间看完了&lt;/p&gt;
&lt;p&gt;然后回到重庆，已是六月一，这时我又开始刷力扣，于是codex工作时我就刷力扣，刷完力扣就回来看一眼codex，循环往复&lt;/p&gt;
&lt;p&gt;六月初到前几天，天天高强度刷题和用codex，这时在家的好处又体现出来了，我可以自由地在夜晚coding和说题，于是这几天平均每天三点半下机，最晚的一次干到 4 点半，要不是中转掉了，可能还通宵了。最后一天搞完感觉心脏猛猛跳差点猝死，以后还是少熬夜的好&lt;/p&gt;
&lt;p&gt;就这样，vibe项目花了10亿token，最后也是端出来了一个中规中矩（也许吧）的aim，自我感觉很不良好（&lt;/p&gt;

&lt;h3 id=&quot;article-对vibe-coding的反思-1&quot;&gt;对Vibe Coding的反思&lt;/h3&gt;&lt;p&gt;要我回顾这一个月干的事，我第一感觉就是“生疏”&lt;/p&gt;
&lt;p&gt;在计算机领域，技术是用进废退的。在vibe的这一个月里，我感到很困惑：在做某部分之前demo过的模块时，我并没有古法，反而是Agent帮我完成了，这让我感觉这代码不是我自己产出的，进而让我感觉这代码显得如此“生疏”&lt;/p&gt;
&lt;p&gt;于是我就在想：要是我一直这么vibe下去，最后恐怕是什么也不懂。哪怕这些技术栈我之前学过、总结过、甚至写过demo，但是在哦我审阅Agent给出的代码时，还是能发现很多层出不穷的新写法和思路&lt;/p&gt;
&lt;p&gt;不过这个项目的vibe我并没有收手，死马当活马医了&lt;/p&gt;
&lt;p&gt;但是对于现在的我来说，vibe coding也许不是那么完美。我的技术栈基础不牢，也没怎么接触过一些业务方案的实现，要是让我从此全面vibe coding的话，恐怕只会从后端仔转成产品仔&lt;/p&gt;
&lt;p&gt;之后的代码暂时还是伪古法的好，就是照着别人的代码或者chatbox给的代码依葫芦画瓢，感觉我之前就是这么学的&lt;/p&gt;

&lt;h3 id=&quot;article-算法-1&quot;&gt;算法&lt;/h3&gt;&lt;p&gt;怎么说呢，最近总算是重拾算法这一块了&lt;/p&gt;
&lt;p&gt;虽然群u都调侃我为oi页，但是我觉得我的算法也着实一般，不过是比其他人早几年接触算法和数据结构罢了&lt;/p&gt;
&lt;p&gt;于是最近总算是打开久违的力扣，开始刷题了，从hot100的各个模块开始，先刷完hot100再说。现状的话大概是每天刷几道hot100+每日一题吧，有时候每日一题特别难的话（有几天数位dp和线段树）可能就不刷hot100了&lt;/p&gt;
&lt;p&gt;不过猫猫学姐和其他群u早在去年就刷完h100了，依旧蠕动的蛆这一块&lt;/p&gt;

&lt;h3 id=&quot;article-计算机基础和八股-1&quot;&gt;计算机基础和八股&lt;/h3&gt;&lt;p&gt;早在105天之前，猫猫学姐就说过，计算机基础 ＞上层业务需求，有没有懂得&lt;/p&gt;
&lt;p&gt;猫神汪神T神王神还有Java组的大手子们也都是底层大手子和八股大手子，只有我还没学底层和八股&lt;/p&gt;
&lt;p&gt;于是大概未来一段时间的目标是逐步学习底层吧，计组 -&amp;gt; os -&amp;gt; 计网 -&amp;gt; Go设计与实现&lt;/p&gt;
&lt;p&gt;顺便刷力扣，并且可以开始看看八股了？前端和java部门考核都有八股，已经下苦了，感觉我一个也答不上来&lt;/p&gt;

&lt;h3 id=&quot;article-未来展望-1&quot;&gt;未来展望&lt;/h3&gt;&lt;p&gt;除了我之前说的底层、算法和八股，我还想仔细研究一下Agent开发方面的业务方案和八股，然后搓一个真正全面的agent出来。在现在这个像黑盒一样的aim上继续搓肯定是很不明智，不过还好之前搓了个基础的agent，可以在那上面继续搞&lt;/p&gt;
&lt;p&gt;另外，cyjj之前也表示，简历项目最好是一个硬后端+Agent相关，所以之后也考虑写一个硬后端并且再优化一下这个aim，不过硬后端到底要有多硬？能抗10w并发的分布式秒杀行吗？不知道，以后再说&lt;/p&gt;
&lt;p&gt;与此同时，如果想在大二暑假就找实习，我们就需要知道：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;大二暑假实习的面试，通常集中在大二下学&lt;br /&gt;期的3月到5月（也就是春招）。&lt;br /&gt;也就是说，你真正用来“冲刺”的时间，其实&lt;br /&gt;只有今年9月到明年2月这半年左右。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;而如果更提前一点，像月神那样大二下就实习的话，时间只会更紧。也就是说，大概到明年二月份左右，我们就要补齐我们简历+面试空缺的部分&lt;/p&gt;
&lt;p&gt;也就是两个完整的项目、计算机底层、Golang&amp;amp;数据库&amp;amp;中间件八股、算法与数据结构、还要针对项目做方案分析啥的&lt;/p&gt;
&lt;p&gt;但是又有学长说，八股什么的面试前再看就好......不应该越早看越好吗？&lt;/p&gt;
&lt;p&gt;呃呃，反正感觉就很焦虑捏。毕竟我也不是什么省油的灯&lt;/p&gt;
&lt;p&gt;唉唉，最后总结一下短期计划吧......&lt;/p&gt;
&lt;p&gt;大概六月份开始学底层，然后每天刷点力扣，看点八股，大概就是这样的吧？简历项目的话大概可以往后延一延吧？&lt;/p&gt;
&lt;p&gt;然后暑假结束前（9月半），希望能把底层学得差不多吧&lt;/p&gt;

&lt;h3 id=&quot;article-ls答辩-1&quot;&gt;ls答辩&lt;/h3&gt;&lt;p&gt;微距了，确实畏惧了，大神太多我太区&lt;/p&gt;
&lt;p&gt;嗯，说点题外话，话说最近md魔童降世，ls药丸说是？hy又没有考核消息。再看吧，毕竟我不太需要工位&lt;/p&gt;

&lt;h3 id=&quot;article-闲言碎语-1&quot;&gt;闲言碎语&lt;/h3&gt;
&lt;h4 id=&quot;article-在校-在家-1&quot;&gt;在校 -&amp;gt; 在家&lt;/h4&gt;&lt;p&gt;由于我家天然的地理优势，从我家到学校坐公交车只要二十多分钟，跟我从南部走到三教差不多了，甚至打车只要十多分钟&lt;/p&gt;
&lt;p&gt;于是，自从四月开始，我就开始在家住了，寝室是一次没回过，话说上个学期我居然在寝室住了一学期？&lt;/p&gt;
&lt;p&gt;众所周知，我是狠狠逃课的，特别是五月末后，所有的实验课也都没了，我更是不用去学校了&lt;/p&gt;
&lt;p&gt;甚至我觉得我不像在读大学，也不是在读大学，学校里的课程与我无关，社交也是脱离校园这个笼统的平台的，而且谁家好人读大学天天宅在家里的？&lt;/p&gt;
&lt;p&gt;不过在家有好处也有坏处：好处是我的时间更多了，不需要再在校园里通勤，还能自由支配时间，深夜学习也不会影响到别人，也不用搬个电脑到处跑；坏处是在家没有那种在图书馆或自习室的氛围，容易不小心拿着手机就刷半天b站（并非不小心），很容易松懈躺平&lt;/p&gt;
&lt;p&gt;所以我的作息变成了3点睡12点起，你就说是不是9小时睡眠吧&lt;/p&gt;
&lt;p&gt;同时也要感谢我勤勉的室友为我扫码，感谢T神和Met的Rollcall和runningbeybey，不然还逃不了这么轻松&lt;/p&gt;
&lt;p&gt;话说虽然英语要排座位，但是我一次没去过，老师好像也没发现&lt;/p&gt;

&lt;h4 id=&quot;article-期末-1&quot;&gt;期末&lt;/h4&gt;&lt;p&gt;请输入文本，不知道这次能挂多少科，高数给了，线代和物理尽力吧&lt;/p&gt;

&lt;h4 id=&quot;article-生活随笔-1&quot;&gt;生活随笔&lt;/h4&gt;
&lt;h5 id=&quot;article-上海行-1&quot;&gt;上海行&lt;/h5&gt;&lt;p&gt;我去了兄弟，饺子醋来了&lt;/p&gt;
&lt;p&gt;五一因为音律联觉去了上海，我只能说这趟夯爆了&lt;/p&gt;
&lt;p&gt;除开去年高考完和同学11个人一起去了武汉，上海这趟算是我唯一一次以自己的想法随心在一个城市旅游&lt;/p&gt;
&lt;p&gt;从最开始抢票坠机，到找票务搞包厢票，到租大疆Action 6，再到机酒规划，再到那几天的详细开销，到最后返程和剪vlog，全都是凭我的自由意志决定的&lt;/p&gt;
&lt;p&gt;在凉爽的春夜，骑着自行车游荡在上海的街头，视野里全是高楼大厦，迎面凉爽的晚风，身上没有一点负担，也没有刻意的时间安排，纯粹的自由，这种感觉真的很幸福&lt;/p&gt;
&lt;p&gt;我该怎么形容，这些我感到人生中最惬意的瞬间呢？&lt;/p&gt;
&lt;p&gt;不在我熟悉的地方，而是在异乡的酒店里，房间里是舒适的温度，刚洗完澡，穿着蓬松的睡衣躺在松软的床上，恰到好处的灯光映融着整个房间，没有烦恼，没有ddl，就这样轻松的躺在床上，旁边的音箱轻声放着柔和的最喜欢的歌（死别真的太有氛围了），在这个深夜，仍然还有大把的时间供我享受。时间是我自己的，生活也是我自己的，短暂的惬意的未来也是我自己的&lt;/p&gt;
&lt;p&gt;我不知道怎么形容，这我感到人生中最惬意的瞬间&lt;/p&gt;
&lt;p&gt;在这个只有我一个人的房间，循环的播放着最喜欢听的歌，我可以做我喜欢的任何事&lt;/p&gt;
&lt;p&gt;这一刻带给我的感觉大概是：就这样直接睡过去会感到遗憾，也感觉就这样睡过去也算享受&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;话说对于一个重庆人来说，到任何一个平坦的城市，都会惊呼“这路咋这么平？”&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;上海行虽夯，但是也让我摆了五一+前后两周。光是做攻略做准备就花了我一周，四月底也是十分期待导致心绪浮躁，回来的第一周也是戒断久久不能忘怀&lt;/p&gt;
&lt;p&gt;唉，我无法用言语形容我多享受这趟旅行，于是我租了周大疆Action 6套装，在上海脖子上就天天挂这个相机记录生活，最后也是剪出了一个很满意的视频，虽然没播放量，不过也无所谓，毕竟能记录这趟旅行我就十分满足&lt;/p&gt;
&lt;p&gt;话说我也太喜欢记录生活了，打游戏保存精彩时刻录屏、在博客上无话不说、旅游全程相机录制、还特别喜欢翻看之前记录的视频......&lt;/p&gt;
&lt;p&gt;快去看我的Vlog口牙：&lt;strong&gt;&lt;a href=&quot;https://www.bilibili.com/video/BV1C9RDBDEYy/?spm_id_from=333.1387.homepage.video_card.click&amp;amp;vd_source=9092b836d715e0b8217104d324e4ce30&quot;&gt;“我可能，这辈子都忘不了音律联觉了...”&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-音律联觉-1&quot;&gt;音律联觉&lt;/h5&gt;&lt;p&gt;夯&lt;/p&gt;
&lt;p&gt;虽然花了我2k，但是我觉得值回票价&lt;/p&gt;
&lt;p&gt;也不是不能理解追星族的感受了......音律联觉就是舟舟人的朝圣有没有懂得&lt;/p&gt;
&lt;p&gt;音律联觉就像以你为中心吹起来的一个幻梦一般的肥皂泡，你用时间和旅行还有期待和共鸣把它吹得又大又圆，反射着另一个世界的辉光，你在里面被蓬勃的鼓动的情绪包围。当谢幕的歌声终止，场上的灯光再亮，这个世界的喧嚣穿过泰拉重回你身边，肥皂泡便在华光中啵地一声碎裂开来，化作千千万万记忆的碎片慢慢消散。你会在酒店里整理无料的时候捡到早上出门前的碎片，你会在回家的交通上捡到上午去场馆路上的碎片，你会在自己手机里拍到的影像里捡到刚跟唱完的碎片……甚至会在别的博士的VLOG里捡到自己的碎片。接下来的几个月，总会有小小的碎片突然在某个地方轻轻闪亮，提醒你那氤氲的两个小时不是梦&lt;/p&gt;
&lt;p&gt;明年继续&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/ArkMusic.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/diary9/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>随笔</category><category>杂项</category></item><item><title>AIM项目总结梳理</title><link>https://www.claran-blog.work/posts/go-AIM/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-AIM/</guid><description>对最近完成的AIM项目的技术回顾、分析与总结</description><pubDate>Wed, 10 Jun 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-前言-1&quot;&gt;前言&lt;/h2&gt;&lt;p&gt;要写ls最终考核了，我选了AIM这个选题，也就是IM+AI，虽然不知道侧重点在IM还是AI，但是好歹先从CRUD开始写吧&lt;/p&gt;
&lt;p&gt;于是，我的AIM项目就这样被划分成了三个阶段：IM - Agent - RAG&lt;/p&gt;
&lt;p&gt;在这里，我来一步步地梳理一下在这些阶段中之前没有接触过或者深入过的一些路程......&lt;/p&gt;
&lt;p&gt;有关项目的详细解析的话，看项目的Deepwiki吧：&lt;strong&gt;&lt;a href=&quot;https://deepwiki.com/Claran309/ClaranAIM.&quot;&gt;DeepWiki-ClaranAIM&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;不过，这个项目基本都是vibe coding的产物，自己古法的部分微乎其微，比起后端我就像个产品经理，这样大概很有问题吧......&lt;/p&gt;

&lt;h2 id=&quot;article-三个阶段-1&quot;&gt;三个阶段&lt;/h2&gt;
&lt;h3 id=&quot;article-im阶段-分布式-crud-最终一致性-1&quot;&gt;IM阶段：分布式+CRUD+最终一致性&lt;/h3&gt;&lt;p&gt;准确来说，我的项目并不是从IM开始的，因为我最开始只Init了一个Agent执行面，所以反而可以说是从Agent开始的。不过后来我开始先写了一个基础的IM分布式服务&lt;/p&gt;
&lt;p&gt;这个阶段，我的项目结构大概是这样的：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;ClaranAIM/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── cmd/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── internal/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── api-gateway/                      &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── websocket-gateway/              &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── user-service/                      &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── group-service/                    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── msg-core-service/                 &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── msg-history-service/              &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── file-service/                     &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── pkg/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── cache/redis/                     &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── config/                                &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── eventbus/                       &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── events/                        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── governance/                     &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── health/                           &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── jwt/                             &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── logger/                            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── password/                          &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── response/                          &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── idl/                                   &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── kitex_gen/                              &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── config/                                &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── dist/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── index.html&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── css/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    └── js/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── docs/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── plan.md&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;嗯，其实也就是个简单的分布式CRUD，甚至没上一致性和其他东西，所以其实没什么可讲的&lt;/p&gt;
&lt;p&gt;唯一可以将的也许就是一些旧架构的新写法&lt;/p&gt;
&lt;p&gt;例如数据库事物和缓存，不像我之前全写在dao层导致dao层比较臃肿，这里的写法是把事物由dao层抽象向上级包装，由service层实现细节编排，而dao层只负责可用接口。同样地，缓存在service处编排，且在redis设施层新增抽象方法返回hit信息。而对于复杂业务，将业务细节和业务编排分开&lt;/p&gt;
&lt;p&gt;然后呢，就到了hy五一考核了，虽然我没参加，但是有观战环节。其中，从大神们的聊天和对话中学到了很多，特别是关于一些一致性和可靠性的东西，比如outbox和eventbus（redis 扣减完了，但是 kafka 还没有推送的间隙，服务器挂了或者重启了咋办？或者说 kafka 丢消息了，wal 写到哪里？）&lt;/p&gt;

&lt;h4 id=&quot;article-outbox-eventbus-1&quot;&gt;Outbox &amp;amp; Eventbus&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;Outbox是一种业务层WAL，可以在不主动关心业务事件成功与否的情况下进行消息分发&lt;/li&gt;
&lt;li&gt;Eventbus是对消息队列这一基础设施的一种封装模式&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-outbox-1&quot;&gt;Outbox&lt;/h5&gt;&lt;p&gt;接着上面的问题讨论：redis 扣减完了，但是 kafka 还没有推送的间隙，服务器挂了或者重启了咋办？或者说 kafka 丢消息了，wal 写到哪里？&lt;/p&gt;
&lt;p&gt;这些问题源于一个事实：“数据库/Redis/Kafka之间没有天然原子性”。也就是说，&lt;strong&gt;业务事实 和 事件发布 不能原子提交&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;于是，我们可以转移思路，尝试让业务事实和事件发布这个流程具有最终一致性——这就是 Outbox 要解决的问题&lt;/p&gt;
&lt;p&gt;Outbox的核心思想是：不要在业务事务里直接发 Kafka，而是在业务事务单开一个event_outbox表用来写一条“待发送事件”的WAL。再由解耦的OutboxWorker轮询扫描event_outbox表，根据扫描结果来投递消息或重试消息&lt;/p&gt;
&lt;p&gt;也就是：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;开启 MySQL 事务&lt;/li&gt;
&lt;li&gt;写业务表&lt;/li&gt;
&lt;li&gt;写 event_outbox 表&lt;/li&gt;
&lt;li&gt;提交事务&lt;/li&gt;
&lt;li&gt;后台 worker 扫 event_outbox&lt;/li&gt;
&lt;li&gt;投递 Kafka&lt;/li&gt;
&lt;li&gt;成功后标记 published&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;这样，业务事实和事件记录就有了原子性：业务成功，outbox 一定成功；业务失败，outbox 一定失败&lt;/p&gt;
&lt;p&gt;有了这种设计思路，我们上面的问题：&lt;/p&gt;
&lt;p&gt;redis 扣减完了，但是 kafka 还没有推送的间隙，服务器挂了或者重启了咋办？ —— 用Outbox即可&lt;/p&gt;
&lt;p&gt;或者说 kafka 丢消息了，wal 写到哪里？ —— event_outbox表里&lt;/p&gt;
&lt;p&gt;同时，我们可以在event_outbox存储当前消息执行状态字段，如pending，retry，dead等，并在worker中配置如遇到retry则尝试再次投递消息，失败超过一定次数后标记为dead等&lt;/p&gt;

&lt;h5 id=&quot;article-eventbus-1&quot;&gt;EventBus&lt;/h5&gt;&lt;p&gt;EventBus其实就是一种kafka等消息队列的抽象封装方式。Eventbus在把kafka等消息队列抽象成基础设施层的基础上，让消息队列围绕业务事件解耦协作&lt;/p&gt;
&lt;p&gt;首先，我们需要把kafka等消息队列的消息都封装为事件Event envelope，把所有kafka的信息如topic、payload都封装到event和envelope中，再把event封装为各种实际方法&lt;/p&gt;
&lt;p&gt;同时，我们也要注意业务代码中的幂等操作，防止同一事件被重复执行多次&lt;/p&gt;
&lt;p&gt;直观地说：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;对比点&lt;/th&gt;
&lt;th&gt;普通 Kafka&lt;/th&gt;
&lt;th&gt;封装 EventBus 模式&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;抽象层级&lt;/td&gt;
&lt;td&gt;消息队列层&lt;/td&gt;
&lt;td&gt;业务事件层&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;关注点&lt;/td&gt;
&lt;td&gt;怎么发消息、怎么消费消息&lt;/td&gt;
&lt;td&gt;什么事件发生了、谁要处理&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;业务代码感知&lt;/td&gt;
&lt;td&gt;topic、key、payload&lt;/td&gt;
&lt;td&gt;event type、event payload&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;扩展方式&lt;/td&gt;
&lt;td&gt;新增 topic 或新增 consumer&lt;/td&gt;
&lt;td&gt;新增事件订阅者&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;耦合程度&lt;/td&gt;
&lt;td&gt;业务代码容易感知 MQ 细节&lt;/td&gt;
&lt;td&gt;业务代码只感知业务事件&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;事件格式&lt;/td&gt;
&lt;td&gt;容易散落在各服务&lt;/td&gt;
&lt;td&gt;通常统一 Envelope&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;适合场景&lt;/td&gt;
&lt;td&gt;简单异步任务&lt;/td&gt;
&lt;td&gt;事件驱动架构、多服务协作&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h6 id=&quot;article-event-envelope-1&quot;&gt;Event Envelope&lt;/h6&gt;&lt;p&gt;为了让 EventBus 能够统一处理不同业务事件，我们常不会直接把业务 payload 裸发出去，而是会包一层统一的事件信封，也就是 Event Envelope&lt;/p&gt;
&lt;p&gt;一个事件通常会包含：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;event_id：用于幂等，消费者可以用它判断事件是否处理过&lt;/li&gt;
&lt;li&gt;event_type：表示事件类型，比如 message.created&lt;/li&gt;
&lt;li&gt;aggregate_type：事件属于哪类业务对象，比如 message、group、agent&lt;/li&gt;
&lt;li&gt;aggregate_id：具体业务对象 ID&lt;/li&gt;
&lt;li&gt;occurred_at：事件发生时间&lt;/li&gt;
&lt;li&gt;producer：哪个服务产生的事件&lt;/li&gt;
&lt;li&gt;schema_version：事件结构版本，方便以后升级&lt;/li&gt;
&lt;li&gt;payload：真正的业务数据&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;例如：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;event_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;evt_123&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;event_type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;message.created&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;aggregate_type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;aggregate_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;msg_456&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;occurred_at&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;2026-06-09T12:00:00Z&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;producer&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;msg-core-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;schema_version&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;payload&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;msg_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;msg_456&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;conversation_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;conv_789&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;sender_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;content&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;hello&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这样做，所有消费者都可以用统一方式解析事件、打日志、做链路追踪、做幂等判断&lt;/p&gt;

&lt;h4 id=&quot;article-client-msg-id-1&quot;&gt;client_msg_id&lt;/h4&gt;&lt;p&gt;在传统的im场景中，用户很有可能因为网络不佳导致点击多次发送消息，此时就很有可能造成消息重复的问题&lt;/p&gt;
&lt;p&gt;在这种情况下，outbox没啥用处。于是，我们可以维护一个client_msg_id，保证当用户重复点击时防止消息重复落库。具体来说，client_msg_id是客户端生产的消息幂等ID。当请求达到后端时，后端判断：该请求是否携带同一个conversation ID，同一个sender ID和同一个client message ID，通过三重判断才会决策是否能落库为新消息&lt;/p&gt;

&lt;h4 id=&quot;article-其他服务治理-1&quot;&gt;其他服务治理&lt;/h4&gt;&lt;p&gt;说实话，我这个项目的服务治理这一块做的并不完善，哪怕项目完结了也只有api-gateway一层按ip的令牌桶，甚至在分布式的情况下只能做到保护api-gateway这一个微服务......改天再完善一下吧，把限流这块做进阶一点，上个redis cluster......&lt;/p&gt;

&lt;h4 id=&quot;article-websocket-1&quot;&gt;Websocket&lt;/h4&gt;&lt;p&gt;Websocket我也是第一次接触使用，总体来说就是维护一个ws hub，并创建注册表哈希：map[user_id] -&amp;gt; 不同连接，在hub里维护client注册表和broadcast广播channel，然后再实现register和unregister方法来实现客户端上下线ws&lt;/p&gt;
&lt;p&gt;对于服务端-&amp;gt;客户端，可以让client从send管道读取广播内容并回显到浏览器，即创建一个ticker定时向conn发送心跳，开启协程死循环监听send管道和ticker&lt;/p&gt;
&lt;p&gt;对于客户端-&amp;gt;服务端，我们让client从websocket读取数据并传输给boradcast管道，单开一个协程死循环的从conn读取数据即可&lt;/p&gt;
&lt;p&gt;同时，ws也负责作为consumer监听消息，实时推送数据到客户端和其他服务&lt;/p&gt;

&lt;h4 id=&quot;article-用户消息视图-1&quot;&gt;用户消息视图&lt;/h4&gt;&lt;p&gt;做这一块之前，我就在想：就QQ这种传统的IM系统来说，聊天记录一般都是保存在本地缓存的，而不是每次都要在服务端拉下来&lt;/p&gt;
&lt;p&gt;但是我做是web聊天室，又不是客户端软件，怎么做到类似“本地缓存”的效果呢？难不成把所有信息都丢进redis？先不说数据可能不一致，感觉性能也没有怎么被优化。难不成在客户端创建本地文件？那感觉有点麻烦且难以维护相应文件了...&lt;/p&gt;
&lt;p&gt;不过最终我并没有找到什么好的解决办法，也许是我没深入去了解其他开源项目的实现&lt;/p&gt;
&lt;p&gt;最终我创了一个新表，用来保存“服务端消息”在“客户端”应该呈现的“用户消息视图”&lt;/p&gt;
&lt;p&gt;创建了新表后，客户端“删除消息”之类的只对本地客户端产生影响的操作都操作在用户消息视图表里，但撤回这种影响服务端和其他客户端的操作还是发生在原消息表里&lt;/p&gt;
&lt;p&gt;除了“删除消息”这种操作，用户消息视图还负责&lt;strong&gt;已读回执&lt;/strong&gt;。客户端POST请求 /api/v1/message/read，服务端就写数据库和outbox，再通过消息让ws推送到其他在线参与者&lt;/p&gt;
&lt;p&gt;不过这个已读回执功能可能对数据库的压力有点大，因为每次检查已读状态之类的操作都会直接打到数据库里......不知道有啥优化的方法&lt;/p&gt;

&lt;h4 id=&quot;article-已读游标-离线同步-1&quot;&gt;已读游标、离线同步&lt;/h4&gt;&lt;p&gt;已读游标也是im里的一个经典设计，通过维护一个会话参与者表里的last_read_message_id，可以认为该id之下的所有消息都是“用户未读消息”，在用户在线但未读消息时直接用 SQL count 即可达到显示未读消息和数量的效果&lt;/p&gt;
&lt;p&gt;但这只能做到“用户在线时不漏消息”，还做不到“补全用户离线时收到的消息”，于是我们要做离线同步：&lt;/p&gt;

&lt;h4 id=&quot;article-最终链路-1&quot;&gt;最终链路&lt;/h4&gt;&lt;p&gt;发消息&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;用户发消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;api-gateway 调 msg-core-service.SendMessage&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;校验会话是否存在&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;校验发送者是否在会话里&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;群聊检查群状态/禁言&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;MySQL 事务：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    写 messages&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    更新 conversations.updated_at&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    为每个参与者写 message_user_states&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    写 event_outbox(message.created)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;事务提交&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;Outbox Worker 投递 Kafka/EventBus&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;websocket-gateway 消费事件并推给在线用户&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;其他消费者&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-agent阶段-管理面-执行面-agent原生-1&quot;&gt;Agent阶段：管理面+执行面+Agent原生&lt;/h3&gt;
&lt;h4 id=&quot;article-管理-执行分面-1&quot;&gt;管理/执行分面&lt;/h4&gt;&lt;p&gt;做完im的基础部分后，我就开始尝试在im里加ai能力了。不过在最开始，我只是往im里加入了一个可供对话的bot，这个bot基本没有任何特殊能力，虽然有自定义配置/prompt、计费管理等功能，也不能算是AIM里的A面&lt;/p&gt;
&lt;p&gt;不过在这一阶段，我就已经把未具雏形的agent划分成了两块微服务：Agent管理面（agent-manager-service）和Agent执行面（agent-runtime-service）&lt;/p&gt;
&lt;p&gt;其中，Agent管理面负责管理所有创建的Agent实例，以及不同Agent的配置、计费、权限、触发路由（IM原生后）以及调用runtime-rpc让agent运行；而Agent执行面这负责让某个Agent跑起来，包括基础的Agent运行、Tool使用/Skill读取/长会话等功能&lt;/p&gt;
&lt;p&gt;这一部分其实挺简单的，无非就是把Agent拆成了两个部分而已。但是这样也只是把Agent硬生生地搬进了im系统，并没有实现im个agent的融合&lt;/p&gt;

&lt;h4 id=&quot;article-agent-native-im-1&quot;&gt;Agent-Native IM&lt;/h4&gt;&lt;p&gt;于是我就在想，aim这一说法，到底要有多a呢？只是在项目里提供一个可对话工作的agent就好了吗？哪怕这个agent与im没有半点关系？&lt;/p&gt;
&lt;p&gt;最终，我想到的aim理想形态是：Agent原生的IM系统，而不是IM原生的Agent平台&lt;/p&gt;
&lt;p&gt;具体来说，就是让agent能够原生存在于im的会话中，例如agent能够自动感知群聊聊天消息，能够在自己判断合适的时候主动发送消息，能够主动检索群聊消息或计划安排并生成相应文件，甚至能够在群聊中与其他agent协作工作流，就类似QQBot或飞书Bot但是更全面&lt;/p&gt;
&lt;p&gt;更激进一点，Agent能够跳出会话框架，让Agent接入IM系统，主动操作im系统私发消息、添加好友等。甚至Agent能在会话中自然产生并执行工作流，会主动@其他Agent协作工作，被@的Agent在主Agent的管制下工作，会话记忆和摘要/用户画像全入RAG链路......&lt;/p&gt;
&lt;p&gt;这就是我对AIM的构想，尽管现在只实现了我构想的冰山一角不到......&lt;/p&gt;
&lt;p&gt;我现在实现的Agent原生存在于两个方面：Agent作为用户实例复用用户链路 + Agent能感知会话内事件&lt;/p&gt;
&lt;p&gt;这个阶段，我尝试让Agent原生于im系统。首先，我取消了原有的bot，让Agent能够作为“user”存在于项目中，于是agent创建流程可复用user创建的链路并被标记为“system user”，并且agent创建后也能复用user服务，做到像被添加为好友、拉如群聊、设定个人信息和头像等用户级操作，尽管这些是被动的&lt;/p&gt;

&lt;h5 id=&quot;article-agenteventdispatcher-1&quot;&gt;AgentEventDispatcher&lt;/h5&gt;&lt;p&gt;然后，我对im系统做了修改，让im-agent系统更侧向事件驱动：要想让agent原生存在与会话中，agent不能“主动”拉取最近消息，而是让所有消息都“通知”agent，消息事件就很适合这个模式：&lt;/p&gt;
&lt;p&gt;传统的msg事件&lt;code&gt;claran.message.events&lt;/code&gt;主要是为了触发ws推送，而我则新建事件类型为im事件&lt;code&gt;claran.im.events&lt;/code&gt;，与传统消息事件同步或取代发布。也就是一但im会话中存在改动，如新人入群、发送文件或消息、禁言成员等事件，这些事件就会被封装为&lt;code&gt;claran.im.events&lt;/code&gt;。而在链路下游的&lt;code&gt;agent-manager-service/eventconsumer&lt;/code&gt;中的&lt;code&gt;AgentEventDispatcher&lt;/code&gt;会监听并消费该事件，并判断该事件是否触发agent执行机制&lt;/p&gt;
&lt;p&gt;对于我设想的aim理想形态而言，每个事件都应该触发agent思考，并自我判断是否主动发送消息，不过我却没这么做，反而像传统bot一样，做成了触发机制：在Agent管理面会管理Agent触发路由和触发判断规则，manager对&lt;code&gt;claran.im.events&lt;/code&gt;事件会做出两种决策：&lt;code&gt;record&lt;/code&gt;和&lt;code&gt;trigger&lt;/code&gt;。触发&lt;code&gt;record&lt;/code&gt;决策后，manager只写审计，不调用 runtime，不回复；触发&lt;code&gt;trigger&lt;/code&gt;决策后，manager会在写审计和调用记录的基础上拉取Agent可见历史，调用&lt;code&gt;agent-runtime-service&lt;/code&gt;，并以AgentUserID写回消息核心服务&lt;code&gt;msg-core-service&lt;/code&gt;，将事件标记为completed&lt;/p&gt;
&lt;p&gt;&lt;code&gt;AgentEventDispatcher&lt;/code&gt;中的详细触发规则如下：如果事件来自私聊，这所有事件都默认触发&lt;code&gt;trigger&lt;/code&gt;；如果来自群聊，则默认只触发当Agent被@的消息。同时，用户配置Agent时可以配置Agent触发路由规则：默认触发/关键词触发/命令触发/保持静默。另外，当同一个 Agent 可能被多个规则命中且非保持静默/触发时，合并优先级&lt;code&gt;trigger &amp;gt; record &amp;gt; 其他&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;这样，我就做到了最基础的Agent原生形态，让Agent天然存在于会话中，尽管感觉跟astrabot没啥区别&lt;/p&gt;
&lt;p&gt;在这样的模式下，我们还要考虑agent事件防重复触发和幂等操作。当请求打进来时，服务端会在&lt;code&gt;consumer&lt;/code&gt;里调用&lt;code&gt;dao&lt;/code&gt;层&lt;code&gt;start&lt;/code&gt;方法（开始前检查），用事件的&lt;code&gt;eventid + userid&lt;/code&gt;查是否落过库来返回事件是否可被执行&lt;/p&gt;

&lt;h3 id=&quot;article-rag阶段-rag-知识图谱-进阶agent能力-1&quot;&gt;RAG阶段：RAG+知识图谱+进阶Agent能力&lt;/h3&gt;&lt;p&gt;这时，AIM已经初具雏形：标准im能力+Agent作为User且能存在于会话中的AIM系统。但这个系统仍缺少一些Agent进阶功能：RAG、MCP、Agent协作&lt;/p&gt;

&lt;h4 id=&quot;article-rag-1&quot;&gt;RAG&lt;/h4&gt;&lt;p&gt;于是我开始补全这些功能，首当其冲的就是最重要也是体量最大的RAG系统。因为我并没有接触过实际实现RAG系统的业务知识，我就先去学习了部分RAG策略&lt;/p&gt;
&lt;p&gt;不过这部分我感觉体量太大，于是打算单开一个文章详细总结：&lt;strong&gt;&lt;a href=&quot;https://www.claran-blog.work/go-rag/&quot;&gt;RAG指南：从MVP介绍各种RAG策略&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;，所以此处按下不表&lt;/p&gt;

&lt;h4 id=&quot;article-web-search-memory-conversation-intelligence-1&quot;&gt;Web-search&amp;amp;Memory&amp;amp;Conversation-Intelligence&lt;/h4&gt;&lt;p&gt;在做完完整RAG后，我打算把向量业务拓展成其他功能，于是就有了Web-search 、Memory和Conversation-Intelligence，不过后两个模块都不完善，只有基础架构和部分MVP&lt;/p&gt;

&lt;h5 id=&quot;article-web-search-1&quot;&gt;Web-search&lt;/h5&gt;&lt;p&gt;这部分其实并没有用到向量数据，我只完成了基础的web-search并封装为MCP：&lt;/p&gt;
&lt;p&gt;搜索&lt;br /&gt;  -&amp;gt; 选官方/高可信页面&lt;br /&gt;  -&amp;gt; 抓网页正文&lt;br /&gt;  -&amp;gt; 清洗正文&lt;br /&gt;  -&amp;gt; 截取相关段落&lt;br /&gt;  -&amp;gt; 给 LLM 回答&lt;/p&gt;

&lt;h5 id=&quot;article-memory-1&quot;&gt;memory&lt;/h5&gt;&lt;p&gt;除了之前在agent-manager里的会话级记忆，我还拓展了agent的用户画像，agent能根据对话候选相应的对话段进入 memory-service 的候选区，在用户确认或系统高置信后进入 memory_facts。或者实现自动记忆提取：Agent 对话结束后，异步判断是否应该生成新记忆，判断这轮对话是否产生长期有用事实&lt;/p&gt;
&lt;p&gt;同时也应该有更新旧记忆、降低旧记忆权重、保留时间线等功能，但是我还没有实现。目前只把候选记忆/正式记忆的管理和召回封成了MCP&lt;/p&gt;

&lt;h5 id=&quot;article-conversation-intelligence-1&quot;&gt;Conversation-Intelligence&lt;/h5&gt;&lt;p&gt;这其实是我设想的AIM理想形态的部分之一：Agent能够总结会话消息和事件，并追加相应总结和思考，再把这些数据向量化入RAG链路。例如找历史讨论、总结某段时间发生了什么、问特殊决策、找某个文件/任务/结论出处、Agent 根据长期群聊上下文回答等&lt;/p&gt;
&lt;p&gt;但聊天记录有几个难点：噪声大、数量多、权限复杂、实时增长快、短消息语义弱、上下文依赖强......例如单条消息：&quot;好&quot;&quot;可以&quot;啥的，拿去 embedding 基本没意义。&lt;/p&gt;
&lt;p&gt;所以合理的Conversation-Intelligence构想应该是短期上下文直接从 msg-core 拉最近 N 条，长期聊天RAG对会话片段/摘要做向量化&lt;/p&gt;
&lt;p&gt;也就是说，聊天记录的rag可以做定时任务，拉取1h内所有信息或者每100条信息做一次，做conversation_summary / decision / task / topic chunk或者金句/用户要求记忆或者价值信息，再入strict rag。并且只对有价值消息入库，比如长文本消息、包含文件/代码/链接的消息、被引用/点赞/标记的消息、Agent 生成的总结、用户手动收藏的消息等&lt;/p&gt;
&lt;p&gt;这部分的实现结构也比较清晰：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Scheduler 每分钟扫描活跃会话 -&amp;gt; 找到满足条件的 conversation -&amp;gt; 创建待处理任务&lt;/li&gt;
&lt;li&gt;Worker 处理待处理任务 -&amp;gt; 拉取消息窗口 -&amp;gt; 清洗消息 -&amp;gt; LLM 提炼 summary/decision/task/topic/memory_candidate -&amp;gt; 写 MySQL -&amp;gt; embedding -&amp;gt; 写 Milvus -&amp;gt; 标记任务completed&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;不过当前并没有实现这么完善&lt;/p&gt;

&lt;h4 id=&quot;article-知识图谱-1&quot;&gt;知识图谱&lt;/h4&gt;&lt;p&gt;这部分我原本是打算当做GraphRAG的副产物的，结果越做越大，索性做成一个独立的服务了&lt;/p&gt;
&lt;p&gt;一般来说，现在流行的知识图谱都是用户手动注入文章关系形成的，但是我想另辟蹊径：上传文档时由LLM抽取文档中的实体与实体关系，然后再保留合理关系放入知识图谱&lt;/p&gt;
&lt;p&gt;这样做的优势很多：用户不用再自己手动管理知识图谱、让知识图谱的关系网更多样化......编不出来了。劣势也十分明显：LLM抽取的实体和关系质量都太不稳定，导致知识图谱里基本没有有用的信息或者实体和关系网都很杂乱.....&lt;/p&gt;
&lt;p&gt;于是我在业务层给LLM多加了部分限制，严格控制抽取的实体与关系数量和质量，结果又基本不产出实体和关系了。没办法，我又做成了一篇文章分成多层，每层由专门的llm抽取实体/关系/校验等，并让llm自定义关系字段，尽量不限制实体数量......最后总算是做到能看的地步&lt;/p&gt;
&lt;p&gt;然后我意识到，我仍然在用MySQL来存图谱数据，真是蠢到家了，于是赶紧转Neo4j&lt;/p&gt;

&lt;h3 id=&quot;article-其他功能补全-1&quot;&gt;其他功能补全&lt;/h3&gt;&lt;p&gt;至此，项目基本都三段开发经历也算结束了，后续又陆续补全了一些功能，例如接了个ocr来辅助rag，同时用户也能直接调用ocr模型识图；做了小模型翻译消息的功能；补全了可观测性链路和看板；做了setting-service和面板来单独配置llm预设和skill等；做了admin-service和面板来方便前端直接管理项目状态和用户数据；做了些上传气泡和提示框啥的有的没的。总之就那样吧&lt;/p&gt;

&lt;h2 id=&quot;article-缺陷-1&quot;&gt;缺陷&lt;/h2&gt;&lt;p&gt;老实说，到截止时间为止，我觉得我的的项目仍然全是缺陷，满目疮痍&lt;/p&gt;
&lt;p&gt;用的仍然是old的MySQL，没有进阶的限流策略，没有严格的一致性策略，没有全面的分库分表读写分离，没有Protobuf，没上nacos，没有上过压测和优化，没有合理的降级治理，没有实现我设想的Agent原生和多Agent协作，没有Agent CLI操作，没有完整的memory和conversation-intelligence，没有部署上服务器，甚至没有全面了解过我自己Vibe的这个项目，甚至就连一些项目要求都没完成（离线同步、消息审核）&lt;/p&gt;
&lt;p&gt;我说白了，作为一个基本全Vibe Coding的项目，我需要一边当产品经理指挥Codex干活，一边上前端测试所有可能出现的bug，一边明确bug和需求鞭策Codex修bug，一边紧锣密鼓地给项目做规划，一边学习项目可能用到的新技术，一边审阅代码发现看不太懂，一边又让Codex为我生成项目的学习大纲和学习文档，最后因为中转站突然垮掉或者余额不足或者再不睡就猝死而遗憾下机&lt;/p&gt;
&lt;p&gt;就这样的一个小项目，烧了10亿token，最后我自己都讲不清楚知道哪些地方是怎么写的，架构是怎么样的，这真的能算我写的一个项目吗？&lt;/p&gt;
&lt;p&gt;我到现在也没背过八股，没学过计算机底层，没参加过开源项目，没了解过业务设计和系统优化，没实践过ddd等学过的架构，没深入了解过各种中间件底层，我真的有与其他人相衬的能力进大神遍地的技术组织吗？&lt;/p&gt;
&lt;p&gt;说多了，这些我本来想放在随笔或者后记里的，不过我做得一般也是事实&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/sadmouseonthebed.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;半成品/预留：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;msg-history-service 的 offline_messages 离线索引&lt;/li&gt;
&lt;li&gt;msg-history-service 的独立历史归档读模型&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;还建议完善：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;正式 offline-push-service&lt;/li&gt;
&lt;li&gt;在线状态服务或 Redis 在线状态&lt;/li&gt;
&lt;li&gt;设备级 sync cursor 持久化&lt;/li&gt;
&lt;li&gt;每设备 ACK 表&lt;/li&gt;
&lt;li&gt;离线推送厂商通道&lt;/li&gt;
&lt;li&gt;DLQ 管理后台和重放按钮&lt;/li&gt;
&lt;li&gt;processed_events/outbox 的重放审计工具&lt;/li&gt;
&lt;li&gt;热会话 Redis 缓存&lt;/li&gt;
&lt;li&gt;会话级限流和防刷&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;article-后记-1&quot;&gt;后记&lt;/h2&gt;&lt;p&gt;如我上面所说，没背过八股，没学过底层，没全面了解过自己的项目，就要被老登拷打，不敢想&lt;/p&gt;
&lt;p&gt;也不知道说什么了，拷打后再更新吧&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/mousebewound.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-参考文章-1&quot;&gt;参考文章&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://deepwiki.com/Claran309/ClaranAIM.&quot;&gt;DeepWiki-ClaranAIM&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/7532397956784766995&quot;&gt;Go 语言 WebSocket 编程详解&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/12482284609&quot;&gt;使用Golang实现WebSocket：从入门到实践&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://topgoer.com/%E7%BD%91%E7%BB%9C%E7%BC%96%E7%A8%8B/WebSocket%E7%BC%96%E7%A8%8B.html&quot;&gt;WebSocket编程&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/7463052032313294902?share_token=8b819bc4-8297-4a7e-9f25-b6ae9a797449&quot;&gt;Go 开发者必备：Protocol Buffers 入门指南&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/7156436348478423047?share_token=2a1b6577-d5b9-4bc4-b599-719a54621b1a&quot;&gt;GO websocket实现简易聊天室&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://blog.csdn.net/lyabc123456/article/details/90746210&quot;&gt;EventBus使用详解&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/624349284&quot;&gt;一个轻量级的事件发布/订阅工具库，可以简化 Go 协程之间的通信&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/7561660157026435135&quot;&gt;典型的 Outbox Pattern 实现，并附上 最小可运行的 Golang demo，方便理解&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/7619281869084622902?share_token=f4e236f7-d5ef-4cee-91c1-8da39b6b63ef&quot;&gt;Golang后端面试复盘：从Swoole到IM架构，如何支撑360w用户的实时消息推送&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://mife-user.github.io/posts/rag%E6%A3%80%E7%B4%A2%E5%A2%9E%E5%BC%BA%E7%94%9F%E6%88%90%E8%AF%A6%E8%A7%A3/#13-rag-%E5%B7%A5%E4%BD%9C%E6%B5%81%E7%A8%8B%E5%85%A8%E6%99%AF&quot;&gt;RAG 检索增强生成详解&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.cnblogs.com/yupi/p/19914426&quot;&gt;RAG 是什么？16 种 RAG 方案一次讲清&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://milvus.io/docs/zh/quickstart.md&quot;&gt;快速入门 Milvus Lite&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://blog.csdn.net/Algorhythm/article/details/153186809&quot;&gt;Go构建向量数据库：如何在1小时内完成百万级向量检索环境部署&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-AIM/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>Agent</category><category>项目</category><category>后端</category></item><item><title>从 LLM 到 Agent：Vibe Coding、Eino 实战与Agent构建</title><link>https://www.claran-blog.work/posts/go-Agent/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-Agent/</guid><description>从AI扫盲到系统梳理Agent核心架构，讲解Eino框架与Go语言开发实战.</description><pubDate>Wed, 15 Apr 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-前言-1&quot;&gt;前言&lt;/h2&gt;&lt;p&gt;我去，怎么15号了？我这产出也太少了，悲。&lt;/p&gt;
&lt;p&gt;多少梳理下最近学的东西吧，虽然感觉有点少&lt;/p&gt;

&lt;h2 id=&quot;article-ai-扫盲-1&quot;&gt;AI 扫盲&lt;/h2&gt;&lt;p&gt;在接触Agent之前，这么着也得把核心技术AI搞明白吧？&lt;/p&gt;

&lt;h3 id=&quot;article-各种基础概念-1&quot;&gt;各种基础概念&lt;/h3&gt;&lt;p&gt;一来AI部分的各种基础概念和专有名词实在繁多，而挨个解释起来非常麻烦，推荐先看个扫盲视频，下面的解释就一句话带过&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.bilibili.com/video/BV1E7wtzaEdq/?vd_source=9092b836d715e0b8217104d324e4ce30&quot;&gt;从 LLM 到 Agent Skill，一期视频带你打通底层逻辑！&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.bilibili.com/video/BV1zSDMBUE5o/?vd_source=9092b836d715e0b8217104d324e4ce30&quot;&gt;近年AI应用技术串讲与优质文档分享｜Agent、Skill、OpenClaw、Harness……&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-llm-1&quot;&gt;LLM&lt;/h3&gt;&lt;p&gt;Large Language Model，也就是我们Agent的核心，不再赘述&lt;/p&gt;

&lt;h4 id=&quot;article-底层原理-1&quot;&gt;底层原理&lt;/h4&gt;&lt;p&gt;我们还是需要了解一下AI本身的原理到底是什么&lt;/p&gt;
&lt;p&gt;无聊时可以简单看些基础科普视频：&lt;strong&gt;&lt;a href=&quot;https://www.bilibili.com/video/BV1BnwEzBEaM/?vd_source=9092b836d715e0b8217104d324e4ce30&quot;&gt;机器之心：人类放弃了掌控，AI凭什么自己觉醒？&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;、&lt;strong&gt;&lt;a href=&quot;https://www.bilibili.com/video/BV1CnXYBaEiW/?vd_source=9092b836d715e0b8217104d324e4ce30&quot;&gt;AI焚诀：你赖以生存的AI，到底吃什么长大的？&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;简单来说，AI（特别是LLM）的底层原理&lt;strong&gt;就是基于海量数据的统计学概率预测&lt;/strong&gt;。AI将prompt拆分成若干字符（token），再根据前面的所有字符，通过向量与高维空间等数学方式，预测下一个最可能出现的字符（Token）是什么&lt;/p&gt;
&lt;p&gt;另一个重要的原理是&lt;strong&gt;Transformer架构&lt;/strong&gt;，&lt;code&gt;Transformer&lt;/code&gt; 是一种由 Google 团队在 2017 年论文《Attention Is All You Need》中首次提出的深度学习架构，我们之前说过，AI本质上实在根据数学概率做选择，而Transformer就是目前最高效的“概率计算架构”，通过&lt;code&gt;Self-Attention &lt;/code&gt;确定了计算概率时的参考范围、通过 &lt;code&gt;Multi-Head &lt;/code&gt;确定了计算概率时的观察维度、通过&lt;code&gt;Parallelism&lt;/code&gt;确定了计算概率的工业效率等&lt;/p&gt;
&lt;p&gt;另外的一些的重要参数，比如&lt;strong&gt;Temperature&lt;/strong&gt;，可以决定AI更倾向于选高概率词汇或者倾向于在全部词汇中选择，低温时 AI 变得保守，只选概率最高的，回答稳定但机械，而高温时AI 会尝试选一些概率稍微低一点的词，这赋予了它所谓的“灵感”和“创造力”，但也增加了胡说八道（幻觉）的风险&lt;/p&gt;
&lt;p&gt;而如果某次预测Token错误，损失函数（Loss Function） 就会计算这个错误有多大，&lt;strong&gt;梯度下降（Gradient Descent） 算法&lt;/strong&gt;就会微调模型内部数的参数（Weights），让下一次预测其他Token的概率变大，预测这个错误Token的概率变小&lt;/p&gt;

&lt;h4 id=&quot;article-模型介绍-1&quot;&gt;模型介绍&lt;/h4&gt;&lt;p&gt;我们介绍一下目前主流的模型：&lt;/p&gt;

&lt;h5 id=&quot;article-claude-opus-4-7-max-1&quot;&gt;Claude-opus-4.7 max&lt;/h5&gt;&lt;p&gt;取代下面介绍的这一条&lt;/p&gt;

&lt;h5 id=&quot;article-claude-opus-4-6-1&quot;&gt;Claude-opus-4-6&lt;/h5&gt;&lt;p&gt;Claude-opus-4-6是&lt;strong&gt;当下公认的性能（编程）最高的供公开使用的LLM&lt;/strong&gt;（现Claude-opus-4.7 max），由A(Anthropic)公司研发，有着100万的上下文窗口，不过由于政策原因，该公司旗下的所有模型均不正式对国内开放，不过我们可以通过接号平台和Visa支付等方式创建非国内账号并购买Coding Plan（可以理解为模型使用的月卡）和Token&lt;/p&gt;
&lt;p&gt;优点是性能顶尖，缺点是模型昂贵，API 价格为每百万输入 Token $5.00，输出 $25.00，且使用较麻烦&lt;/p&gt;

&lt;h5 id=&quot;article-glm-5-1-1&quot;&gt;GLM-5.1&lt;/h5&gt;&lt;p&gt;GLM-5.1是&lt;strong&gt;目前国内基本最好的LLM&lt;/strong&gt;，由智谱 AI研发，有20万上下文窗口，特点是极高的性价比和开源属性，API 价格仅约为每百万输入 $1.00，输出 $3.20，且有40元左右的Coding Plan和特价资源包，但是目前国内的Coding Plan每日限量，比较难买&lt;/p&gt;
&lt;p&gt;优点是以 1/10 的价格提供 60&lt;del&gt;70% 的 Opus 性能，但缺点也是只有60&lt;/del&gt;70% 的 Opus 性能，用过opus再用GLM会有明显落差&lt;/p&gt;

&lt;h5 id=&quot;article-其他模型-1&quot;&gt;其他模型&lt;/h5&gt;&lt;p&gt;其他主流模型包括国外OpenAI的ChatGPT（chat）、codex（Coding）和谷歌的Gemini；以及国内的Kimi、Minimax、Deepseek等&lt;/p&gt;
&lt;p&gt;不可否认的是国外的模型确实几乎碾压国内模型，因此也成为了模型标杆，GPT、gemini和Cluade系列有着三大模型巨头之称&lt;/p&gt;

&lt;h5 id=&quot;article-怎么使用llm-1&quot;&gt;怎么使用LLM？&lt;/h5&gt;&lt;p&gt;要使用LLM，我们需要在想要使用的LLM官网获取该模型系列的&lt;strong&gt;API-Key&lt;/strong&gt;和&lt;strong&gt;BaseURL&lt;/strong&gt;，可以很轻松地获取到&lt;/p&gt;
&lt;p&gt;另外，我们需要有对应模型使用额度（Token或调用次数），所以需要购买相对应的Token额度或者Coding Plan&lt;/p&gt;
&lt;p&gt;获取这些内容后，我们就能在ChatBox或者集成AI的IDE工具中绑定模型并使用LLM了&lt;/p&gt;

&lt;h5 id=&quot;article-中转站-1&quot;&gt;中转站&lt;/h5&gt;&lt;p&gt;我们之前提到过，由于政策原因，Claude系列模型不对国内开放，因此想使用顶尖的Opus-4-6就很困难，而使用其他的国外模型也比较繁琐，并且国外模型还普遍非常昂贵，这时候，我们就可以使用&lt;strong&gt;模型中转站&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;“中转站”（API 中转站）是一个非常通俗的说法，它的官方称呼通常是 “AI API 聚合服务商” 或 “第三方 API 转发平台”，简单来说，&lt;strong&gt;中转站就是一个“API贩子”。它把分散在世界各地的 AI 官方接口（如 Anthropic、OpenAI、Google、智谱 AI 等）整合在一起，再转卖给普通用户或开发者&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;使用中转站时，模型调用流程变成了你的请求 -&amp;gt; 发送给中转站，中转站 -&amp;gt; 转发给官方（Anthropic/OpenAI），官方 -&amp;gt; 返回结果给中转站，中转站 -&amp;gt; 返回结果给你&lt;/p&gt;
&lt;p&gt;中转站的优点十分明显：原官方模型1/7甚至1/14的价格，可以方便地使用全平台的模型等&lt;/p&gt;
&lt;p&gt;但与此同时，更需要警惕中转站的缺点：最主要的就是&lt;strong&gt;模型的掺水现象和中转站的不稳定性&lt;/strong&gt;， 有些无良中转站会玩“挂羊头卖狗肉”。比如你调用的是昂贵的 Claude Opus 4.6，他后台偷偷给你换成便宜的 Claude Haiku 或 GPT-3.5，这种行为被称为 “掺水”，且中转站可能随时“跑路”或者因为被封号而导致服务中断&lt;/p&gt;
&lt;p&gt;总的来说，中转站可以让我们低成本、低门槛地快速用上 Claude Opus 4.6 或 其他国内外模型，是目前最高效、最省事的方案。但尽量“小额多次充值”，且要注意甄别模型是否掺水&lt;/p&gt;

&lt;h2 id=&quot;article-vibe-coding-1&quot;&gt;Vibe Coding&lt;/h2&gt;&lt;p&gt;所谓Vibe Coding是指开发者不再逐行手写代码，而是通过自然语言向 AI 描述功能需求，由 AI 自动生成完整代码、设计界面并处理逻辑的工作方式。说人话就是用AI写代码&lt;/p&gt;
&lt;p&gt;要Vibe Coding，我们不能只用ChatBox让AI生成代码，而是使用专门的工具&lt;/p&gt;

&lt;h3 id=&quot;article-trae-1&quot;&gt;Trae&lt;/h3&gt;&lt;p&gt;Cursor的国内版，Trae是字节跳动研发的AI 原生集成开发环境（AI IDE），基于 VS Code 构建，可以无缝迁移所有的 VS Code 插件、快捷键和主题配置。且作为国内的AI IDE，可以免费试用GLM等国内最新模型，只不过大多时候需要排队 &lt;/p&gt;
&lt;p&gt;缺点也是只能免费使用国内模型，总体来说性价比高&lt;/p&gt;

&lt;h3 id=&quot;article-claude-code-1&quot;&gt;Claude Code&lt;/h3&gt;&lt;p&gt;Claude Code 是 Anthropic 官方推出的一款AI 原生命令行界面（CLI）工具，它让你可以直接在终端中与 Claude AI 进行交互，完成编码、调试、重构等开发任务，也是目前最主流的Vibe Coding工具，我们可以在Claude Code使用A\本家模型或者使用CC-Switch接入其他模型&lt;/p&gt;

&lt;h3 id=&quot;article-cc-switch-1&quot;&gt;CC-Switch&lt;/h3&gt;&lt;p&gt;CC-Switch 是一款专门为 Claude Code 以及其他 AI 命令行（CLI）编程工具设计的开源跨平台桌面配置管理工具&lt;/p&gt;
&lt;p&gt;我们使用CC-Switch的原因主要是可以灵活管理各种模型和渠道的API-Key和BaseURL，并为ClaudeCode接入第三方模型（如中转站）和国产模型&lt;/p&gt;

&lt;h3 id=&quot;article-chery-studio-1&quot;&gt;Chery Studio&lt;/h3&gt;&lt;p&gt;这个准确来说不算直接相关Vibe Coding，但是还是提一嘴&lt;/p&gt;
&lt;p&gt;Chery Studio是一个公认好用的ChatBox，可以手动集成各家模型，比较方便&lt;/p&gt;

&lt;h2 id=&quot;article-ai-agent-1&quot;&gt;AI Agent&lt;/h2&gt;&lt;p&gt;而所谓Agent，就是把LLM进行包装，为这个智慧核心添加工具、交互、逻辑等包装，就如同为大脑增加四肢、皮囊。普通的 AI 是“问答式”的，而 AI Agent 是“任务式”的&lt;/p&gt;
&lt;p&gt;简单地说，如果你只是调用一个 API（应用程序接口，简单说就是让两个软件互相&quot;对话&quot;的通道）让模型吐字，那只是&quot;用了个 LLM 服务&quot;；当你给它加上文件系统、浏览器、代码执行、记忆、任务编排、监控重试……这整套东西组合在一起，才叫一个真正能&quot;干活&quot;的 Agent&lt;/p&gt;
&lt;p&gt;在学术界和工业界，目前公认的 AI Agent 公式是：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;Agent = 大模型 (LLM) + 规划 (Planning) + 记忆 (Memory) + 工具使用 (Tool Use)&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;需要注意的是，AI 是一种技术，而 AI Agent 是一种产品形态&lt;/p&gt;
&lt;p&gt;AI Agent的一些思想：&lt;/p&gt;

&lt;h3 id=&quot;article-react模式-1&quot;&gt;ReAct模式&lt;/h3&gt;&lt;p&gt;ReAct 是 Reason（推理） + Act（行动） 的缩写。它是目前 AI Agent（智能体）最主流的一种工作模式&lt;/p&gt;
&lt;p&gt;简单来说，ReAct 模式让大模型像人类一样思考：先思考（Thought），再行动（Action），然后根据观察到的结果（Observation）进行下一步思考&lt;/p&gt;
&lt;p&gt;一个典型的 ReAct 过程示例：&lt;/p&gt;
&lt;p&gt;假设你问 AI：“今天罗德岛所在地区的温度适合阿米娅穿外套吗？”&lt;/p&gt;
&lt;p&gt;AI：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Thought (思考)：我需要知道罗德岛当前的位置，然后查询该地区的天气&lt;/li&gt;
&lt;li&gt;Action (行动)：调用 get_current_location() 工具&lt;/li&gt;
&lt;li&gt;Observation (观察)：返回“切尔诺伯格”。&lt;/li&gt;
&lt;li&gt;Thought (思考)：现在我知道地点是切尔诺伯格了，我需要查询那里的实时气温&lt;/li&gt;
&lt;li&gt;Action (行动)：调用 get_weather(city=&quot;Chernobog&quot;)&lt;/li&gt;
&lt;li&gt;Observation (观察)：返回“气温 -10°C，大雪”&lt;/li&gt;
&lt;li&gt;Thought (思考)：气温是 -10°C，非常寒冷。阿米娅必须穿上厚外套&lt;/li&gt;
&lt;li&gt;Final Answer (最终回答)：博士，切尔诺伯格现在只有 -10°C，请务必提醒阿米娅穿上厚外套&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;而在 Go 代码的框架里，ReAct 循环通常表现为一个 for 循环：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 将对话历史发给 AI&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    resp &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chatModel.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Generate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(messages)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // AI 返回的内容包含 &quot;Thought&quot; 和 &quot;Action&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 如果 AI 说任务完成了，就 break 循环&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; isTaskFinished&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(resp) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(resp.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 解析 AI 想要调用的工具 (Action)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    toolResult &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; callTool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(resp.ToolCall)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 将工具返回的结果 (Observation) 喂回给 AI&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    messages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(messages, schema.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ObservationMessage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(toolResult))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 进入下一次循环，让 AI 根据 Observation 进行下一次 Thought&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-任务拆解-1&quot;&gt;任务拆解&lt;/h3&gt;&lt;p&gt;任务拆解（Task Decomposition） 是指将一个复杂的、模糊的“宏观目标”分解为一系列更小的、可执行的“原子子任务”的过程&lt;/p&gt;
&lt;p&gt;如果说 ReAct 是 Agent 的“思考方式”，那么任务拆解就是 Agent 的“规划能力”&lt;/p&gt;

&lt;h3 id=&quot;article-多agent协作-1&quot;&gt;多Agent协作&lt;/h3&gt;&lt;p&gt;字面意思，一个复杂的任务可由多个Agent协作完成，各个Agent之间可能会呈现某种特殊关系，通常以主管模式（Supervisor Mode）为主&lt;/p&gt;
&lt;p&gt;相比于使用单Agent，多Agent协作不仅可以避免Prompt或上下文过于臃肿，也因为模块解耦提升了可拓展性&lt;/p&gt;

&lt;h4 id=&quot;article-主管模式-1&quot;&gt;主管模式&lt;/h4&gt;&lt;p&gt;这是最主流的模式（LangGraph 、Eino）。它引入了一个“管理者”的角色。&lt;/p&gt;
&lt;p&gt;角色分配：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;主管 Agent (The Boss)：不直接干活。它的工作是：拆解任务、分配任务、检查结果、决定是否结束&lt;/li&gt;
&lt;li&gt;员工 Agents (The Workers)：各个领域的专家（如搜索专家、代码专家、绘图专家）&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;协作方式：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;用户发指令给 主管。&lt;/li&gt;
&lt;li&gt;主管思考：“这个任务需要先搜资料，再写代码”&lt;/li&gt;
&lt;li&gt;主管下令：“搜索Agent，去查资料。”&lt;/li&gt;
&lt;li&gt;搜索Agent返回结果给 主管。&lt;/li&gt;
&lt;li&gt;主管检查后说：“很好，代码Agent，根据这些资料写代码。”&lt;/li&gt;
&lt;li&gt;代码Agent完成后交给 主管。&lt;/li&gt;
&lt;li&gt;主管认为达标了，才最终回复用户。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;特点：高度灵活。主管可以根据中间结果随时调整策略。如果员工干得不好，主管可以要求重写。&lt;/p&gt;

&lt;h3 id=&quot;article-rag-1&quot;&gt;RAG&lt;/h3&gt;&lt;p&gt;RAG (Retrieval-Augmented Generation)，即检索增强生成&lt;/p&gt;
&lt;p&gt;RAG 的核心思想是：&lt;strong&gt;让 LLM 在回答问题时，先从外部知识库中检索相关内容，再基于检索结果生成回答，而不是仅依赖模型训练时记住的知识&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;其工作流程分为三步：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;索引（Indexing）&lt;/strong&gt;：将外部知识库（如PDF、数据库、网页）切分成小块，转换为向量并存入向量数据库&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;检索（Retrieval）&lt;/strong&gt;：当用户提问时，将问题也转换为向量，在向量库中搜索最相关的知识片段&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;生成（Generation）&lt;/strong&gt;：将检索到的知识片段与原始问题一起送入LLM，生成基于事实的答案&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/rag.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://blog.csdn.net/m0_48891301/article/details/156265899&quot;&gt;RAG工作原理详解：11张图带你吃透RAG完整工作流程&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;这解决了 LLM 的两个核心痛点：知识截止日期（模型不知道训练后发生的事）和幻觉问题（模型在不确定时会编造答案）&lt;/p&gt;

&lt;h3 id=&quot;article-mcp-1&quot;&gt;MCP&lt;/h3&gt;&lt;p&gt;MCP （Model Context Protocol，模型上下文协议）定义了应用程序和 AI 模型之间交换上下文信息的方式。这使得开发者能够&lt;strong&gt;以一致的方式将各种数据源、工具和功能连接到 AI 模型&lt;/strong&gt;（一个中间协议层），就像 USB-C 让不同设备能够通过相同的接口连接一样。MCP 的目标是创建一个通用标准，使 AI 应用程序的开发和集成变得更加简单和统一&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/mcp.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/mcp2.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;更详细的讲解可以学习这篇文章：&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/29001189476&quot;&gt;MCP (Model Context Protocol)，一篇就够了&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;以及MCP官方介绍：&lt;strong&gt;&lt;a href=&quot;https://modelcontextprotocol.io/&quot;&gt;Model Context Protocol&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-harness-1&quot;&gt;Harness&lt;/h3&gt;&lt;p&gt;我们之前说过这样一个定义：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;在学术界和工业界，目前公认的 AI Agent 公式是：&lt;br /&gt;Agent = 大模型 (LLM) + 规划 (Planning) + 记忆 (Memory) + 工具使用 (Tool Use)&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;而&quot;Agent Harness&quot; 指的是：包在大模型外面、让它真正能&quot;干活&quot;的那一整套系统。不是模型本身，而是模型以外的一切&lt;/p&gt;
&lt;p&gt;所以我们也可以说，&lt;strong&gt;Agent = 模型（Model）+ Harness&lt;/strong&gt;，Harness就是围绕模型这个大脑搭的一切——工具、连接、环境、流程、管控&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/harness.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/2024269041427072886&quot;&gt;Harness到底是什么？&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/2026412619725116184&quot;&gt;什么是Harness？什么是Harness Engineering？&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-skill-1&quot;&gt;Skill&lt;/h3&gt;&lt;p&gt;简单来说，Skill就是“完成特定任务的标准化、可复用流程”，核心关键词是“明确输入、固定步骤、可预期输出”。它不是单一的“能力”，而是一套“能直接用、能重复用、还能不断优化的具体方法”&lt;/p&gt;
&lt;p&gt;你只需要写一份SKILL.md文档并对相应内容做出约束，AI就会根据文档内的要求和约束产生预期的输出，从本质上来说，Skill的核心就是**“拆解+标准化”**&lt;/p&gt;
&lt;p&gt;例如，我们写一个「每日站会助手」的Skill：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;name: daily-standup&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;description: 每日站会助手。自动总结昨日完成、今日计划、阻塞问题。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;---&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# 每日站会助手&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;## 触发条件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;当用户提到&quot;站会&quot;、&quot;standup&quot;、&quot;日报&quot;、&quot;周报&quot;时触发。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;## 工作流程&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;### 1. 收集信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;扫描以下内容：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- Git提交记录（昨日至今）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- 项目看板状态变更&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- 用户手动补充的阻塞问题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;### 2. 生成报告&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;按以下格式输出：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;**昨日完成：**&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- [完成的任务1]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- [完成的任务2]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;**今日计划：**&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- [计划任务1]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- [计划任务2]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;**阻塞/风险：**&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- [阻塞问题]（如无则显示&quot;无&quot;）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;### 3. 风格适配&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- 默认：简洁专业&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- 如果用户多次使用，学习其表达风格&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;## 约束&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- 每个条目不超过20字&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- 不编造未确认的信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;- 阻塞问题必须标注来源（Git/看板/手动）&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;随后，我们将skill安装到我们对agent里（Claude Code）：&lt;code&gt;cp -r daily-standup-skill .claude/skills/&lt;/code&gt;，AI会自动识别到这个Skill，按我们定义的流程执行&lt;/p&gt;
&lt;p&gt;这就是Skill的核心设计理念：&lt;strong&gt;把经验用文本写下来，让AI按规则执行&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;由此：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/skill.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://cloud.tencent.com/developer/article/2654880&quot;&gt;Skill到底是什么？从「同事.skill」爆火说起&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/2021148229522206903&quot;&gt;一文读懂Skill：从基础到实操&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-eino-1&quot;&gt;Eino&lt;/h2&gt;&lt;p&gt;Eino 是字节跳动研发的一个优秀 LLM 应用开发框架，提供了一个强调简洁性、可扩展性、可靠性与有效性，且更符合 Go 语言编程惯例的 LLM 应用开发框架&lt;/p&gt;
&lt;p&gt;我们需要先学习Eino的组件思想和架构使用实例，建议阅读官方文档&lt;a href=&quot;https://www.cloudwego.io/zh/docs/eino/overview/&quot;&gt;&lt;strong&gt;CloudWeGo | Eino - 概述&lt;/strong&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;以及官方文档“快速开始”部分：&lt;strong&gt;&lt;a href=&quot;https://www.cloudwego.io/zh/docs/eino/quick_start/&quot;&gt;CloudWeGo | Eino - 快速开始&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;搭配官方仓库示例代码：&lt;strong&gt;&lt;a href=&quot;https://github.com/cloudwego/eino-examples/tree/main/quickstart/chatwitheino/cmd&quot;&gt;Eino示例代码&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;需要特别注意的是，我们不仅要看怎么“快速开始”，也要知道Eino大概是怎么封装各种Agent的，理解ReAct循环、任务拆解等关键思想&lt;/p&gt;
&lt;p&gt;关于各种Agent设计思想，可以参考这个视频：&lt;strong&gt;&lt;a href=&quot;https://www.bilibili.com/video/BV1TSg7zuEqR/?vd_source=9092b836d715e0b8217104d324e4ce30&quot;&gt;Agent 的概念、原理与构建模式 —— 从零打造一个简化版的 Claude Code&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;此处我们便不过多讲解Eino本身的API和ADK了&lt;/p&gt;

&lt;h3 id=&quot;article-用eino搭建agent-1&quot;&gt;用Eino搭建Agent&lt;/h3&gt;
&lt;h4 id=&quot;article-创建智能体-1&quot;&gt;创建智能体&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;model, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; openai.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;openai&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ChatModelConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Model: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;GLM-5.1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    BaseURL: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;https://open.bigmodel.cn/api/paas/v4&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    APIKey: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;your-apikey&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建 Agent&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;agent, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; adk.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewChatModelAgent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ChatModelAgentConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Name:        AgentName,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Instruction: AmiyaInstruction, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Eino会将Instruction注入为SystemPrompt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Model:       model,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;值得一提的是，Agent内部不仅封装了ChatModel，也封装了ReAct循环，因此在工具使用部分我们不会再代码中显式看到类似 &lt;code&gt;for { ... call tool ... }&lt;/code&gt; 的 ReAct 循环代码&lt;/p&gt;

&lt;h4 id=&quot;article-会话和持久化记忆-1&quot;&gt;会话和持久化记忆&lt;/h4&gt;&lt;p&gt;我们将每次聊天的循环称为一次会话（Session），那么持久化记忆本质上就是将每次会话内容序列化并存储到本地磁盘或者数据库上，我们可以写一个&lt;code&gt;memory.go&lt;/code&gt;进行实现，将会话内容存储为&lt;code&gt;SessionMeta&lt;/code&gt;和&lt;code&gt;Session&lt;/code&gt;，再用&lt;code&gt;Store&lt;/code&gt;存储不同的&lt;code&gt;Session&lt;/code&gt;信息，并在单个&lt;code&gt;Session&lt;/code&gt;信息头部加上特定标识，即可轻松实现这个功能&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; memory&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;bufio&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;encoding/json&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;path/filepath&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/schema&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 会话元数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; SessionMeta&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ID        &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `json:&quot;id&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Title     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `json:&quot;title&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	CreatedAt &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;created_at&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Session&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ID 	  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	CreatedAt &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	filePath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;					 // 会话记忆路径&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	mu       &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Mutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	messages []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;       // 消息列表&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Append 添加消息到内存并持久化到磁盘&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Session&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;msg&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 合并消息到内存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	s.messages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.messages, msg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 将消息持久化到磁盘&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	data, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Marshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	file, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;OpenFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.filePath, os.O_APPEND&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;|&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;os.O_CREATE&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;|&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;os.O_WRONLY, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;0o&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;644&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; file.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	_, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; file.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Write&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(data, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// GetMessages 返回磁盘中存储的消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Session&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetMessages&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	msg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.messages))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	copy&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg, s.messages)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// GetTitle 从用户消息派生标题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Session&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetTitle&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, msg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.messages {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Role &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; schema.User &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			title &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Content&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;rune&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(title)) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 60&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				title &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;rune&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(title)[:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;60&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;...&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; title&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;新会话&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 会话管理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Store&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sessions &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Session&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 会话缓存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	mu       &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Mutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	dir 	 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// NewStore 创建新的会话存储&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewStore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;dir&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Store&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MkdirAll&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(dir, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;0o&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;755&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Store&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		sessions: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Session&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		dir:      dir,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// sessionHeader 每个会话的第一行 JSONL 数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; SessionHeader&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Type      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `json:&quot;type&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ID        &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `json:&quot;id&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	CreatedAt &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;created_at&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// GetSession 获取或创建会话&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Store&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetSession&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Session&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 命中缓存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session, exists &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.sessions[id]; exists {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	filepath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.dir, id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;.jsonl&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Session&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, exists &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Stat&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filepath);os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsNotExist&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(exists){ &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 如果文件不存在，创建新会话&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;会话文件不存在，创建新会话: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, filepath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		header &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; SessionHeader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Type:      &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;session&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			ID:        id,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			CreatedAt: time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		data, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Marshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(header)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 写入文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filepath, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(data, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;0o&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;644&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		session &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Session&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			ID:        id,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			CreatedAt: header.CreatedAt,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			filePath:  filepath,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			messages:  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 从磁盘加载会话&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;会话文件存在，加载会话: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, filepath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		file, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Open&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filepath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; file.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		scanner &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bufio.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewScanner&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 读取sessionHeader&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scan&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;会话内容为空: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, filepath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; header &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SessionHeader&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unmarshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Bytes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;header); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;解析会话头部失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 保存SessionHeader&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		session &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Session&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			ID:        header.ID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			CreatedAt: header.CreatedAt,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			filePath:  filepath,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			messages:  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 读取消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scan&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Text&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;跳过空行&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unmarshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(line), &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;msg); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;解析消息失败，跳过该消息: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, error: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, line, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			session.messages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(session.messages, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;msg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// debug日志，显示加载的消息内容（如果消息过长，则截断显示）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			contentRune &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;rune&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			displayContent &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(contentRune)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(contentRune) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 50&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				displayContent &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(contentRune[:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;50&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;...&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			displayContent &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReplaceAll&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(displayContent, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot; &quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;加载历史消息成功: role=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, content=[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, msg.Role, displayContent)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 将会话加入缓存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	s.sessions[id] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ListSessions 列出所有会话元数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Store&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ListSessions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() ([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SessionMeta&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	files, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadDir&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.dir)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sessionMetas []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SessionMeta&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, file &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; files {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; file.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsDir&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HasSuffix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(file.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;.jsonl&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 只处理 .jsonl 文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		id &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSuffix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(file.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;.jsonl&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 命中缓存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session, exists &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.sessions[id]; exists {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			sessionMetas &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(sessionMetas, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SessionMeta&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				ID:        session.ID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				Title:     session.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetTitle&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				CreatedAt: session.CreatedAt,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 从磁盘加载会话（如果加载失败，则跳过该会话)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		filepath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.dir, file.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		localFile, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Open&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filepath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; localFile.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		scanner &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bufio.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewScanner&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(localFile)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 读取sessionHeader&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scan&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; header &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SessionHeader&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unmarshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Bytes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;header); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 保存SessionHeader&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		session &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Session&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			ID:        header.ID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			CreatedAt: header.CreatedAt,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			filePath:  filepath,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			messages:  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 读取消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scan&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Text&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unmarshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(line), &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;msg); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			session.messages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(session.messages, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;msg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 添加加载的元数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		sessionMetas &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(sessionMetas, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SessionMeta&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			ID:        session.ID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Title:     session.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetTitle&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			CreatedAt: session.CreatedAt,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sessionMetas, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// DeleteSession 删除会话&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Store&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DeleteSession&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 从缓存中删除&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	delete&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.sessions, id)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 从磁盘删除&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	filepath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.dir, id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;.jsonl&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Remove&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filepath); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsNotExist&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-工具-1&quot;&gt;工具&lt;/h4&gt;&lt;p&gt;通过有关Eino的学习，我们知道Tool有&lt;code&gt;InferTool&lt;/code&gt;、&lt;code&gt;NewTool&lt;/code&gt;和&lt;code&gt;InvokableTool&lt;/code&gt;三种创建方式，分别对应不同繁易程度和颗粒度粗细的Tool创建，我们这里使用&lt;code&gt;DeepAgent&lt;/code&gt;自动注册文件管理工具，并用&lt;code&gt;InferTool&lt;/code&gt;注册一些简单的方舟工具&lt;/p&gt;
&lt;p&gt;另外，如果Model在&lt;code&gt;AgentEvents&lt;/code&gt;中调用了工具，那么本次Event中的&lt;code&gt;MessageOutput&lt;/code&gt;中&lt;code&gt;Role&lt;/code&gt;变量就会被标记为&lt;code&gt;Schema.Tool&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;首先我们写Tool逻辑&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyAgent/internal/logic/tools.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; logic&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; OperatorQueryToolParams&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Name &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;name&quot; jsonschema:&quot;description=干员名称，如&apos;能天使&apos;、&apos;银灰&apos;等&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 查询干员信息伪逻辑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; QueryOperator&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;input&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;OperatorQueryToolParams&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	operators &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;能天使&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;【能天使】★★★★★★ | 职业：狙击 | 特长：对空攻击，高射速 | 天赋：攻击速度提升&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;银灰&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:   &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;【银灰】★★★★★★ | 职业：近卫 | 特长：远程斩击 | 天赋：再部署时间缩短&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;陈&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;【陈】★★★★★★ | 职业：近卫 | 特长：多段爆发攻击 | 天赋：技力恢复速度提升&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;艾雅法拉&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;【艾雅法拉】★★★★★★ | 职业：术师 | 特长：群体法术伤害 | 天赋：法术伤害提升&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;阿米娅&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;【阿米娅】★★★★★★ | 职业：术师/近卫 | 特长：真实伤害 | 天赋：每次攻击回复技力&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;德克萨斯&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;【德克萨斯】★★★★★ | 职业：先锋 | 特长：产生费用，群体眩晕 | 天赋：初始Cost+1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;蓝毒&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:   &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;【蓝毒】★★★★★ | 职业：狙击 | 特长：多目标攻击，法术dot伤害 | 天赋：攻击附带法术伤害&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	info, ofk &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; operators[input.Name]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ofk {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;未找到名为&apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;的干员记录&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, input.Name), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; info, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ResourceQueryToolParams&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ResourceType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;resource_type&quot; jsonschema:&quot;description=资源类型，可选值：龙门币、合成玉、理智、源石、全部&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 查询资源状况伪逻辑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; QueryResources&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;input&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ResourceQueryToolParams&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resources &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;龙门币&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;龙门币: 1,234,567&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;合成玉&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;合成玉: 8,900&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;理智&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;理智: 130/135（将在 2 小时后回满）&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;源石&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;源石: 42 个&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; input.ResourceType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;全部&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; input.ResourceType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Builder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		result.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;=== 罗德岛资源报告 ===&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, v &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; resources {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			result.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;  &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; v &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		result.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;报告时间：刚刚更新&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	info, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; resources[input.ResourceType]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;未知的资源类型: &apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;。支持查询：龙门币、合成玉、理智、源石、全部&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, input.ResourceType), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; info, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; BattlePlanToolParams&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	StageName  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;stage_name&quot; jsonschema:&quot;description=关卡名称，如&apos;1-7&apos;、&apos;CE-5&apos;、&apos;SK-5&apos;等&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Difficulty &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;difficulty&quot; jsonschema:&quot;description=难度偏好，可选值：标准、挑战&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 制定作战计划伪逻辑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; MakeBattlePlan&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;input&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BattlePlanToolParams&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	plan &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;`=== 作战计划：&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;（&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;模式）===&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;推荐编队：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  先锋位：德克萨斯 — 快速获取部署费用&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  狙击位：能天使 — 对空防御 + 高DPS&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  近卫位：银灰 — 核心输出，关键时刻真银斩&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  术师位：艾雅法拉 — 群体法术清场&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  医疗位：闪灵 — 全队治疗保障&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  重装位：星熊 — 前排抗压&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;作战要点：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  1. 开局立即部署德克萨斯获取初始费用&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  2. 优先在高台部署能天使控制空中威胁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  3. 银灰部署在关键路口，技能 3 留到敌方精英出现时使用&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  4. 艾雅法拉在敌方密集时释放火山，最大化群伤&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;预估理智消耗：&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;预估通关概率：&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;`&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, input.StageName, input.Difficulty, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;30&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;95%&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; plan, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;然后我们根据逻辑创建&lt;code&gt;[]tool.BaseTool&lt;/code&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/Internal/agent/tools.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; agent&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AmiyaAgent/internal/logic&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/components/tool&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/components/tool/utils&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; InitTools&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseTool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tools []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseTool&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	OperatorQueryTool, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; utils.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InferTool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;operator_query&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;根据干员名称查询其职业、特长和天赋等基本信息&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logic.QueryOperator,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;初始化工具失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;工具 operator_query 初始化成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tools &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tools, OperatorQueryTool)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ResourceQueryTool, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; utils.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InferTool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;resource_query&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;查询当前的资源状况，包括龙门币、合成玉、理智、源石等&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logic.QueryResources,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;初始化工具失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;工具 resource_query 初始化成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tools &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tools, ResourceQueryTool)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	BattlePlanTool, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; utils.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InferTool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;battle_plan&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;根据关卡名称和难度偏好制定作战计划，推荐编队和作战要点&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logic.MakeBattlePlan,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;初始化工具失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;工具 battle_plan 初始化成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tools &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tools, BattlePlanTool)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tools&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;在注册工具前记得对工具内必要参数进行说明&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/internal/agent/prompt.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; FileSystemInstruction&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;agentRoot&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	extInstruction &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;`## 文件管理操作说明&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	- 重要提示：在使用文件系统工具（如 ls、read_file、glob、grep 等）时，你必须使用绝对路径。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	- 项目根目录为：&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	- 当博士要求列出“当前目录”中的文件时，请使用路径：&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	- 当博士要求使用相对路径读取文件时，请通过在前置加上 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 将其转换为绝对路径。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	- 示例：如果博士说“读取 main.go”，你应该调用 read_file 工具，并将 file_path 参数设为：&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/main.go&quot;)`&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, agentRoot, agentRoot, agentRoot, agentRoot)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; extInstruction&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;之后在创建Agent时注册工具，这里使用的是DeepAgent&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/internal/agent/agent.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; agent&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino-ext/adk/backend/local&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino-ext/components/model/openai&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/adk&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/adk/prebuilt/deep&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/compose&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewDeepAgent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;openai&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;agentRoot&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Agent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建LocalBackend Tools 后端工具实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	backend, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; local.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewBackend&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;local&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建自定义工具集&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tools &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; InitTools&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	toolsConfig &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToolsConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ToolsNodeConfig: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToolsNodeConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Tools: tools,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 获取文件系统操作说明&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	extInstruction &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; FileSystemInstruction&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(agentRoot)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建ChatModelAgent类型的Agent实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// agentConfig := &amp;amp;adk.ChatModelAgentConfig{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 	Name: agent.AmiyaName,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 	Description: agent.AmiyaDescription,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 	Instruction: agent.AmiyaInstruction,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 	Model: chatModel,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// agent,err := adk.NewChatModelAgent(ctx,agentConfig)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// if err != nil {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 	log.Fatal(&quot;创建 ChatModelAgent 实例失败:&quot;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// log.Println(&quot;ChatModelAgent 实例创建成功&quot;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建DeepAgent类型的Agent实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	agentConfig &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;deep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Name:           AmiyaName,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Description:    AmiyaDescription,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Instruction:    AmiyaInstruction &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; extInstruction, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 将文件操作说明添加到系统提示词中&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ChatModel:      model,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ToolsConfig:    toolsConfig,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Backend:        backend, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 注入LocalBackend工具集&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		StreamingShell: backend, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 支持流式 Shell 输出&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MaxIteration:   &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;50&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 最大思考/工具调用循环次数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	agent, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; deep.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, agentConfig)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; agent, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;最后在主程序中定制流式输出工具日志&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/cmd/main.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AmiyaAgent/internal/agent&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AmiyaAgent/internal/component&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;bufio&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;bytes&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;encoding/json&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;io&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;path/filepath&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/adk&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/schema&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/google/uuid&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/joho/godotenv&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 初始化上下文&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ctx &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 获取apiKey等环境变量并封装为config&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; godotenv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Load&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;未找到 .env 文件，使用系统环境变量&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	apiKey, baseURL, modelName, sessionDir,agentRoot &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Getenv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;OPENAI_API_KEY&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Getenv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;OPENAI_BASE_URL&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Getenv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;OPENAI_MODEL_NAME&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Getenv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;SESSION_DIR&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Getenv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;AGENT_ROOT&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; apiKey &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; baseURL &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; modelName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sessionDir &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; agentRoot &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;请设置环境变量&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建 ChatModel 实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	chatModel, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; component.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, apiKey, baseURL, modelName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建 ChatModel 实例失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;ChatModel 实例创建成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 获取Agent绝对路径&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; abs, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Abs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(agentRoot); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		agentRoot &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; abs&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建 DeepAgent 实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	agent, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; agent.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewDeepAgent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, chatModel, agentRoot)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建 DeepAgent 实例失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;DeepAgent 实例创建成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建agentRunner实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	runner &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; adk.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewRunner&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RunnerConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Agent:           agent,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		EnableStreaming: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;AgentRunner 实例创建成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建会话存储&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	store, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; component.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewStore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(sessionDir)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建会话存储失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;会话存储创建成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sessionID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;请输入会话ID（留空则创建新会话）: &quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scanln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;sessionID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 处理会话 ID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sessionID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 如果为空，生成新 UUID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		sessionID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; uuid.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建新会话: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, sessionID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	} &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;恢复会话: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, sessionID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 获取或创建会话&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	session, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; store.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetSession&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(sessionID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取或创建会话失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;会话获取或创建成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 启动对话&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;===============================================开始对话（当前会话标题：&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetTitle&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;）=======================================================&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;阿米娅: 博士，您好！我是阿米娅，有什么需要我帮忙的吗？&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//log.Println(&quot;&quot;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	scanner &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bufio.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewScanner&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdin)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;博士：&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scan&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		input &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Text&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; input &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 封装用户消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		userMsg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; schema.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserMessage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(input)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userMsg); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 将消息保存到会话&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;保存用户消息失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 获取当前会话的消息历史&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		messages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetMessages&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 调用 AgentRunner 生成回复&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;阿米娅：&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		events &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; runner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Run&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, messages)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		content, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getAssistantMsg&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(events)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;生成回复失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 回滚消息历史&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			messages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; messages[:&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(messages)&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 将模型回复加入对话历史&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(schema.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AssistantMessage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;保存助手消息失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Err&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		_, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stderr, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;会话已保存，会话ID：&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, sessionID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getAssistantMsg&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;events&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AsyncIterator&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AgentEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建一个字符串构建器，用于累积所有回复内容&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; builder &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Builder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 循环遍历事件迭代器中的所有事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 从迭代器中获取下一个事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		event, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; events.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 检查事件中是否包含错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, event.Err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 检查事件的输出是否为空或消息输出为空&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Output &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Output.MessageOutput &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 获取消息输出对象，简化后续代码&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		msg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Output.MessageOutput&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 若本次消息为工具调用结果，则提取工具输出内容并打印（不累积到最终回复中）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Role &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; schema.Tool {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getToolMsg&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;[调用工具结果] &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;truncate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;200&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 只处理Assistant消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Role &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; schema.Assistant {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 检查消息是否为流式传输&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.IsStreaming {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 设置消息流为自动关闭模式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			msg.MessageStream.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetAutomaticClose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 初始化工具收集器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; toolCalls []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToolCall&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 循环接收流中的每一帧数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 从流中接收一帧数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				frame, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.MessageStream.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Recv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 表示流已完全接收，正常退出循环&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Is&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err, io.EOF) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 返回错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 检查帧数据是否有效&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; frame &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;					// AI正在生成的文字内容&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; frame.Content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;						// 将帧内容添加到字符串构建器中&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;						builder.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(frame.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;						// 同时将内容实时打印到标准输出（不换行）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;						_, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdout, frame.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;					// 收集AI想要调用的工具&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(frame.ToolCalls) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;						toolCalls &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(toolCalls, frame.ToolCalls&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 打印工具调用信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, toolCall &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; toolCalls {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; toolCall.Function.Name &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; toolCall.Function.Arguments &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[调用工具] &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, toolCall.Function.Name, toolCall.Function.Arguments)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 流处理完毕后，打印一个换行符&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			_, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdout)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 处理非流式消息（一次性返回的完整消息）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Message &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 将消息内容添加到字符串构建器中&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			builder.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg.Message.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 将消息内容打印到标准输出（带换行符）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			_, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdout, msg.Message.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		} &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 如果消息为空，仅打印一个空行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			_, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdout)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 返回累积的所有助手回复内容&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; builder.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// getToolMsg 从流式消息变量中提取完整的工具结果字符串&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getToolMsg&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;msg&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MessageVariant&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.IsStreaming &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.MessageStream &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; builder &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Builder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			chunk, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.MessageStream.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Recv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Is&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err, io.EOF) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunk &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunk.Content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				builder.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunk.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; builder.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Message &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Message.Content&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// truncate 辅助函数：截断超长字符串，用于控制台预览&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; truncate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;maxLen&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; maxLen {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 尝试压缩 JSON 格式后再截断&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;bytes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Buffer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Compact&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;result, []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s)); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; maxLen {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s[:maxLen] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;...&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-middleware-1&quot;&gt;Middleware&lt;/h4&gt;&lt;p&gt;MiddleWare可以在Agent运行前后入自定义逻辑，由此我们可以实现拦截错误为错误字符串，遇错重试等策略&lt;/p&gt;
&lt;p&gt;我们先新建Middleware.go:&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/internal/component/middleware.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; component&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;io&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/adk&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/components/tool&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/compose&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/schema&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// safeToolMiddleware 是一个自定义中间件，用于安全地处理工具调用错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 它将工具执行错误转换为可读的错误消息，而不是中断整个流程&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; SafeToolMiddleware&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseChatModelAgentMiddleware&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// WrapInvokableToolCall 包装同步工具调用，捕获错误并返回格式化的错误消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SafeToolMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WrapInvokableToolCall&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;	_&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;	endpoint&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableToolCallEndpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;	_&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToolContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableToolCallEndpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 中间件函数逻辑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;args&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;opts&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 调用原始工具执行函数，并捕获任何错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		result, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, args, opts&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 如果是中断重新运行错误，直接返回以允许 Agent 重试&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsInterruptRerunError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err);ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 否则，返回一个格式化的错误消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;[tool error] &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// WrapStreamableToolCall 包装流式工具调用，安全地处理流中的错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SafeToolMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WrapStreamableToolCall&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;	_&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;	endpoint&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StreamableToolCallEndpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;	_&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToolContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StreamableToolCallEndpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 中间件函数逻辑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;args&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;opts&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StreamReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;], &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 调用原始流式工具执行函数，并捕获任何错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		stream, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, args, opts&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 如果是中断重新运行错误，直接返回以允许 Agent 重试&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsInterruptRerunError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err); ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 返回包含错误消息的单块读取器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; singleChunkReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;[tool error] &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 包装原始读取器以处理流中的错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; safeWrapReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(stream), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// singleChunkReader 创建一个只包含单个消息的流读取器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; singleChunkReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;msg&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StreamReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;] {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	r, w &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; schema.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Pipe&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;](&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	_ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; w.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Send&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	w.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// safeWrapReader 包装流读取器，捕获流中的错误并转换为错误消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; safeWrapReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;sr&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StreamReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StreamReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;] {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	r, w &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; schema.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Pipe&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;](&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; w.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			chunk, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sr.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Recv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 正常结束流&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Is&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err, io.EOF) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 流中发生错误，发送错误消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				_ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; w.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Send&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[tool error] &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 转发正常的数据块&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			_ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; w.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Send&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunk, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;然后在agent.go中装载Middleware、&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;注意：Handlers 字段（在配置中）和 “Middleware”（在文档中讨论的概念）是同一回事——Handlers 是配置字段名，而 ChatModelAgentMiddleware 是接口名&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建DeepAgent类型的Agent实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	agentConfig &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;deep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Name:           AmiyaName,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Description:    AmiyaDescription,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Instruction:    AmiyaInstruction &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; extInstruction, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 将文件操作说明添加到系统提示词中&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ChatModel:      model,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ToolsConfig:    toolsConfig,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Backend:        backend, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 注入LocalBackend工具集&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		StreamingShell: backend, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 支持流式 Shell 输出&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MaxIteration:   &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;50&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 最大思考/工具调用循环次数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 注册安全工具中间件，用于捕获和处理工具调用错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Handlers: []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ChatModelAgentMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;component&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SafeToolMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 配置模型重试策略，处理速率限制错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ModelRetryConfig: &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ModelRetryConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			MaxRetries: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			IsRetryAble: &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (_ context.Context,err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Contains&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;429&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Contains&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Too Many Requests&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Contains&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;qpm limit&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-可观测性-1&quot;&gt;可观测性&lt;/h4&gt;&lt;p&gt;Eino中的Callback可以在组件开始处理前、组件成功返回后、组件返回错误时、组件接收流式输入时和组件返回流式输出时打印日志&lt;/p&gt;
&lt;p&gt;Callback需要实现以下接口：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Handler&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 非流式输入（组件开始处理前）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    OnStart&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;info&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RunInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;input&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; CallbackInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 非流式输出（组件成功返回后）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    OnEnd&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;info&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RunInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;output&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; CallbackOutput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 错误（组件返回错误时）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    OnError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;info&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RunInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;err&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 流式输入（组件接收流式输入时）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    OnStartWithStreamInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;info&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RunInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;        input&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StreamReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CallbackInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 流式输出（组件返回流式输出时）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    OnEndWithStreamOutput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;info&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RunInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;        output&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StreamReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CallbackOutput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;我们使用 &lt;code&gt;callbacks.NewHandlerBuilder()&lt;/code&gt;创建&lt;code&gt;callback handler&lt;/code&gt;：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/internal/agent/agent.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;handler &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; callbacks.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewHandlerBuilder&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	OnStartFn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;info&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;callbacks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RunInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;input&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; callbacks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CallbackInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;[trace] &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; start&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, info.Component, info.Name) &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		 return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		OnEndFn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;info&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;callbacks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RunInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;output&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; callbacks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CallbackOutput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;[trace] &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; end&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, info.Component, info.Name) &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		OnErrorFn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;info&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;callbacks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RunInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;err&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;[trace] &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; error: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, info.Component, info.Name, err) &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Build&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	callbacks.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AppendGlobalHandlers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(handler)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-cozeloop-扣子罗盘-1&quot;&gt;CozeLoop（扣子罗盘）&lt;/h5&gt;&lt;p&gt;CozeLoop 是字节跳动开源的 AI 应用可观测性平台，类似Jaeger，CozeLoop是专门为 AI Agent 和 LLM 应用设计的可视化链路追踪（Tracing）与调试平台&lt;/p&gt;
&lt;p&gt;我们在cozeloop官网重获取了APIToken和WorkspaceID后便在agent里集成cozeloop：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/internal/agent/agent.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 配制 CozeLoop 追踪&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cozeloopApiToken &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cozeloopWorkspaceID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		client, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cozeloop.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			cozeloop.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithAPIToken&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cozeloopApiToken),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			cozeloop.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithWorkspaceID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cozeloopWorkspaceID),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;初始化CozeLoop客户端失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		defer&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		callbacks.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AppendGlobalHandlers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(clc.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewLoopHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(client))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;CozeLoop追踪已启用&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	} &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;CozeLoop追踪未启用，缺少API Token或Workspace ID&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-中断和恢复-interrupt-resume-1&quot;&gt;中断和恢复（Interrupt &amp;amp; resume）&lt;/h4&gt;&lt;p&gt;可以达成在调用指定工具前向用户审批的效果&lt;/p&gt;
&lt;p&gt;这样便可以实现一个可中断和恢复的 Agent 执行流程：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Agent 执行过程中遇到需要人工审批的操作时，会触发 Interrupt（中断）&lt;/li&gt;
&lt;li&gt;用户在命令行确认或拒绝后，通过 Resume（恢复）继续执行&lt;/li&gt;
&lt;li&gt;所有状态通过 CheckPoint 保存，支持会话恢复&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;首先我们需要实现中断/恢复中间件：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/internal/component/middleware.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// approvalMiddleware 处理工具调用中的用户审批流程&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ApprovalMiddleware&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseChatModelAgentMiddleware&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// WrapInvokableToolCall 包装同步工具调用，实现中断-恢复流程&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WrapInvokableToolCall&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;	_&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;	endpoint&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableToolCallEndpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;	tCtx&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToolContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableToolCallEndpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 只对 &quot;execute&quot; 工具进行审批拦截，其他工具直接通过&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// if tCtx.Name != &quot;execute&quot; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 	return endpoint, nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;args&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;opts&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// ====================================================================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 第一次执行：检查是否已被中断过&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// ====================================================================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// GetInterruptState 检查当前执行是否是从中断状态恢复的&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 返回值：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//   - wasInterrupted: 是否曾被中断过&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//   - _: 中断时的上下文信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//   - storedArgs: 中断时保存的工具参数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		wasInterrupted, _, storedArgs &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInterruptState&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;](ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;wasInterrupted {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 首次执行，还未被中断过&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 触发 StatefulInterrupt：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			//   1. 保存当前工具参数 (args) 用于后续恢复&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			//   2. 返回 ApprovalInfo 给用户展示审批信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			//   3. 暂停执行，等待用户输入&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, tool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StatefulInterrupt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;commontool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				ToolName:        tCtx.Name,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				ArgumentsInJSON: args,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}, args)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// ====================================================================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 恢复执行：用户已做出审批决定&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// ====================================================================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// GetResumeContext 获取恢复时用户提供的审批结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 返回值：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//   - isTarget: 这个中断点是否是恢复的目标&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//   - hasData: 是否有恢复数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//   - data: 用户的审批结果 (ApprovalResult)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		isTarget, hasData, data &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetResumeContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;commontool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalResult&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;](ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; isTarget &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; hasData {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; data.Approved {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 用户批准，继续执行工具&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, storedArgs, opts&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 用户拒绝，返回拒绝消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; data.DisapproveReason &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;工具 &apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos; 审批被拒绝: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, tCtx.Name, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;data.DisapproveReason), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;工具 &apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos; 审批被拒绝&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, tCtx.Name), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// ====================================================================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 多个中断点的情况：检查是否还有其他未处理的中断&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// ====================================================================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 如果 isTarget 为 false，说明还有其他中断点需要处理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 继续中断，等待用户处理其他中断点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		isTarget, _, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetResumeContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;any&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;](ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; isTarget {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 还有其他中断点未处理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, tool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StatefulInterrupt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;commontool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				ToolName:        tCtx.Name,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				ArgumentsInJSON: args,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}, args)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 所有中断点都已处理，执行工具&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, storedArgs, opts&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// WrapStreamableToolCall 包装流式工具调用，实现中断-恢复流程&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WrapStreamableToolCall&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;	_&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;	endpoint&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StreamableToolCallEndpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;	tCtx&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToolContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StreamableToolCallEndpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 只对 &quot;execute&quot; 工具进行审批拦截，其他工具直接通过&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// if tCtx.Name != &quot;execute&quot; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 	return endpoint, nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;args&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;opts&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StreamReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;], &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 第一次执行：检查是否已被中断过&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		wasInterrupted, _, storedArgs &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInterruptState&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;](ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;wasInterrupted {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 首次执行，触发 StatefulInterrupt： 保存args，返回审批信息，暂停执行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, tool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StatefulInterrupt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;commontool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				ToolName:        tCtx.Name,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				ArgumentsInJSON: args,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}, args)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 恢复执行：获取用户的审批结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		isTarget, hasData, data &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetResumeContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;commontool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalResult&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;](ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; isTarget &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; hasData {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; data.Approved {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 用户批准，继续执行工具&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, storedArgs, opts&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 用户拒绝，返回包含拒绝消息的单块读取器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; data.DisapproveReason &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; singleChunkReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;工具 &apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos; 审批被拒绝: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, tCtx.Name, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;data.DisapproveReason)), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; singleChunkReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;工具 &apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos; 审批被拒绝&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, tCtx.Name)), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 检查是否还有其他中断点未处理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		isTarget, _, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetResumeContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;any&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;](ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; isTarget {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 还有其他中断点未处理，继续中断当前点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, tool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StatefulInterrupt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;commontool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				ToolName:        tCtx.Name,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				ArgumentsInJSON: args,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}, args)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 所有中断点都已处理，执行工具&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, storedArgs, opts&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;然后我们在创建agent时使用该中间件：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/agent/agent.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建DeepAgent类型的Agent实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	agentConfig &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;deep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Name:           AmiyaName,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Description:    AmiyaDescription,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Instruction:    AmiyaInstruction &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; extInstruction, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 将文件操作说明添加到系统提示词中&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ChatModel:      model,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ToolsConfig:    toolsConfig,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Backend:        backend, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 注入LocalBackend工具集&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		StreamingShell: backend, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 支持流式 Shell 输出&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MaxIteration:   &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;50&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 最大思考/工具调用循环次数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 注册安全工具中间件，用于捕获和处理工具调用错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Handlers: []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ChatModelAgentMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;component&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 处理工具调用中的用户审批流程&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;component&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SafeToolMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 捕获工具调用错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 配置模型重试策略，处理速率限制错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ModelRetryConfig: &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ModelRetryConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			MaxRetries: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			IsRetryAble: &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (_ context.Context,err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Contains&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;429&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Contains&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Too Many Requests&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Contains&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;qpm limit&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	agent, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; deep.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, agentConfig)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;并在创建&lt;code&gt;AgentRunne&lt;/code&gt;r时使用&lt;code&gt;CheckPoint&lt;/code&gt;，&lt;code&gt;CheckPoint&lt;/code&gt;可以使agent在中断时保存状态（Tool 参数、执行位置等）并在恢复时加载状态（从中断点继续执行）&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/cmd/main.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建agentRunner实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	runner &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; adk.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewRunner&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RunnerConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Agent:           agent,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		EnableStreaming: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		CheckPointStore: store.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewInMemoryStore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;AgentRunner 实例创建成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;随后我们在流程主循环里集成&lt;code&gt;CheckPoint&lt;/code&gt;和&lt;code&gt;Interrupt&lt;/code&gt;：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/cmd/main.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;checkPointID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sessionID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	reader &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bufio.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdin)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;博士：&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		line, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; reader.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Is&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err, io.EOF) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;读取用户输入失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(line)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 封装用户消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		userMsg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; schema.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserMessage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(line)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userMsg); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 将消息保存到会话&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;保存用户消息失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 获取当前会话的消息历史&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		messages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetMessages&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 调用 AgentRunner 生成回复&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;阿米娅：&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		events &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; runner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Run&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, messages, adk.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithCheckPointID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(checkPointID))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		content,interruptInfo, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getAssistantMsg&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(events)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;生成回复失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 回滚消息历史&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			messages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; messages[:&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(messages)&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 如果 Agent 执行过程中触发了中断，处理中断&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; interruptInfo &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			content, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; handleInterrupt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, runner, checkPointID, interruptInfo, reader)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				_, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stderr, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 将模型回复加入对话历史&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; session.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(schema.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AssistantMessage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;保存助手消息失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;会话已保存，会话ID：&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, sessionID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getAssistantMsg&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;events&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AsyncIterator&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AgentEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InterruptInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建一个字符串构建器，用于累积所有回复内容&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; builder &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Builder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; interruptInfo &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InterruptInfo&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 循环遍历事件迭代器中的所有事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 从迭代器中获取下一个事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		event, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; events.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 检查事件中是否包含错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, event.Err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 检测中断事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Action &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Action.Interrupted &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			interruptInfo &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Action.Interrupted&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 保存中断信息，继续处理其他事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 检查事件的输出是否为空或消息输出为空&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Output &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Output.MessageOutput &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 获取消息输出对象，简化后续代码&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		msg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Output.MessageOutput&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 若本次消息为工具调用结果，则提取工具输出内容并打印（不累积到最终回复中）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Role &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; schema.Tool {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getToolMsg&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;[调用工具结果] &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;truncate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;200&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 只处理Assistant消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Role &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; schema.Assistant {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 检查消息是否为流式传输&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.IsStreaming {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 设置消息流为自动关闭模式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			msg.MessageStream.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetAutomaticClose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 初始化工具收集器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; toolCalls []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToolCall&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 循环接收流中的每一帧数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 从流中接收一帧数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				frame, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.MessageStream.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Recv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 表示流已完全接收，正常退出循环&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Is&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err, io.EOF) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 返回错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 检查帧数据是否有效&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; frame &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;					// AI正在生成的文字内容&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; frame.Content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;						// 将帧内容添加到字符串构建器中&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;						builder.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(frame.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;						// 同时将内容实时打印到标准输出（不换行）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;						_, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdout, frame.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;					// 收集AI想要调用的工具&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(frame.ToolCalls) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;						toolCalls &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(toolCalls, frame.ToolCalls&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 打印工具调用信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, toolCall &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; toolCalls {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; toolCall.Function.Name &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; toolCall.Function.Arguments &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[调用工具] &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, toolCall.Function.Name, toolCall.Function.Arguments)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 流处理完毕后，打印一个换行符&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			_, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdout)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 处理非流式消息（一次性返回的完整消息）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Message &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 将消息内容添加到字符串构建器中&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			builder.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg.Message.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 将消息内容打印到标准输出（带换行符）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			_, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdout, msg.Message.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		} &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 如果消息为空，仅打印一个空行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			_, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdout)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 返回累积的所有助手回复内容&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; builder.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), interruptInfo, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// handleInterrupt 处理中断并恢复执行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; handleInterrupt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;runner&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Runner&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;checkPointID&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;interruptInfo&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InterruptInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;reader&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;bufio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Reader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 遍历所有中断上下文，找到根本原因的中断&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, ic &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; interruptInfo.InterruptContexts {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// IsRootCause 标记这是否是触发中断的根本原因&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 在多层嵌套的中断中，只有根本原因的中断需要用户处理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ic.IsRootCause {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 尝试将中断信息转换为 ApprovalInfo&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		info, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ic.Info.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;commontool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 向用户展示需要审批的信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;⚠️  需要用户审批 ⚠️&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;工具: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, info.ToolName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;参数: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, info.ArgumentsInJSON)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;是否批准? (y/n): &quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 读取用户输入&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		response, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; reader.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;读取用户输入失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		response &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToLower&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(response))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 根据用户输入构建恢复数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; resumeData &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;commontool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalResult&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; response &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;y&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; response &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;yes&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			resumeData &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;commontool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalResult&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Approved: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;✓ 已批准，正在执行...&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		} &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			resumeData &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;commontool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalResult&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Approved: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;✗ 已拒绝&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 使用用户的审批决定继续 Agent 执行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		events, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; runner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ResumeWithParams&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, checkPointID, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ResumeParams&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Targets: &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;any&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				ic.ID: resumeData,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ic.ID 是中断点的唯一标识&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;恢复执行失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 收集恢复后的输出&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		content, newInterruptInfo, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getAssistantMsg&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(events)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 递归处理新的中断&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; newInterruptInfo &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; handleInterrupt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, runner, checkPointID, newInterruptInfo, reader)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; content, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;未找到需要处理的根本原因中断&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-graph-tool-rag-1&quot;&gt;Graph Tool &amp;amp; RAG&lt;/h4&gt;&lt;p&gt;&lt;code&gt;compose.Workflow&lt;/code&gt; 是 Eino 中构建工作流的核心组件&lt;/p&gt;
&lt;p&gt;我们以该工具为例为Agent创建一个rag系统：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/graphTool.rag.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; graphTool&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;encoding/json&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sort&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/components/model&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/components/tool&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/compose&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino/schema&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino-examples/adk/common/tool/graphtool&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/eino-examples/compose/batch/batch&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Input 是工具调用的参数结构体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 其 JSON 标签被 utils.InferTool 用于自动生成工具的参数 Schema&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Input&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	FilePath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;file_path&quot; jsonschema:&quot;description=已上传文档文件的绝对路径&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Question &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;question&quot;  jsonschema:&quot;description=需要根据文档回答的问题&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Output 是工具返回的结构化结果。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Output&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Answer  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;   `json:&quot;answer&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Sources []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;sources&quot;`&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 用于生成答案的关键摘录来源&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// scoreTask 是喂给内部 BatchNode 工作流的单个分块输入&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreTask&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Text     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Question &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// scoredChunk 是内部 BatchNode 工作流生成的单个分块结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Text    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Score   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 0–10 分，表示与问题的相关性&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Excerpt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 该分块中最相关的句子或短语&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// scoreIn 是外部 &quot;score&quot; Lambda 节点的输入。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 它通过字段映射从两个来源汇集而成：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   - Chunks: &quot;chunk&quot; 节点的完整输出 ([]*schema.Document)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   - Question: START 节点的 Question 字段 (来自 Input)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreIn&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Chunks   []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Question &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// synthIn 是 &quot;synthesize&quot; Lambda 节点的输入&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 它通过字段映射从两个来源汇集而成：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   - TopK: &quot;filter&quot; 节点的完整输出 ([]scoredChunk)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   - Question: START 节点的 Question 字段 (来自 Input)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; synthIn&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	TopK     []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Question &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// BuildTool 构建由 RAG 工作流支持的 answer_from_document 工具&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 它使用了 graphtool.NewInvokableGraphTool，该工具在每次调用时编译工作流 并支持通过内置的检查点存储（checkpoint store）进行中断/恢复&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; BuildTool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cm&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseTool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; buildWorkflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cm)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; graphtool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewInvokableGraphTool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Input&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;](&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		wf,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;answer_from_document&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;在大型上传文档中搜索与问题相关的内容，并从最相关的段落中合成带有引用的答案。&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;当文档太大无法放入上下文窗口时，请使用此工具代替 read_file。&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// buildWorkflow 构建 RAG compose.Workflow（未编译状态）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// graphtool.NewInvokableGraphTool 会在每次调用时对其进行编译&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; buildWorkflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cm&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Workflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Input&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;] {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	scoreWF &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; newScoreWorkflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cm)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	scorer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; batch.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewBatchNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;batch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NodeConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Name:           &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;ChunkScorer&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		InnerTask:      scoreWF,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MaxConcurrency: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewWorkflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Input&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// load: 从磁盘读取文件，输出单个 Document&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLambdaNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;load&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableLambda&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;in&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Input&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) ([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			data, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(in.FilePath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;read &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%q&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, in.FilePath, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{{Content: &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(data)}}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(compose.START)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// chunk: 将每个 Document 拆分成约 800 字符的片段&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLambdaNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunk&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableLambda&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;docs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) ([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; out []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, d &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; docs {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				out &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(out, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;splitIntoChunks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(d.Content, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;800&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; out, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;load&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// score: 通过 BatchNode 并行针对问题对每个分块进行评分&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// Chunks 来自 &quot;chunk&quot; 节点；Question 直接来自 START 节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 两者都使用 WithNoDirectDependency，因为执行顺序已经由&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// START→load→chunk→score 的直接边缘建立&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLambdaNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;score&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableLambda&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;in&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;any&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) ([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 从 map 中手动提取字段，并进行类型断言&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 注意：这里的 key 必须和下面 AddInputWithOptions 里的字段名完全一致&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        chunks, ok1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; in[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Chunks&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;].([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        question, ok2 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; in[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Question&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;].(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok2 {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;score节点输入类型错误: Chunks 类型断言成功=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, Question 类型断言成功=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, ok1, ok2)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        tasks &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunks))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i, c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunks {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            tasks[i] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Text: c.Content, Question: question}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scorer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Invoke&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, tasks)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		AddInputWithOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunk&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			[]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FieldMapping&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Chunks&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithNoDirectDependency&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		AddInputWithOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(compose.START,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			[]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FieldMapping&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MapFields&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Question&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Question&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithNoDirectDependency&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// filter: 按分数降序排列，保留最多 3 个分数 ≥ 3 的分块&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLambdaNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;filter&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableLambda&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;scored&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) ([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			sort.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Slice&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(scored, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;i&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;j&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scored[i].Score &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scored[j].Score&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			const&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; maxK&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; top []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scored {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.Score &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				top &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(top, c)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(top) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; maxK {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; top, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;score&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// answer: 从前 K 个分块中合成回答，如果为空则返回未找到消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// TopK 来自 &quot;filter&quot; 节点；Question 直接来自 START 节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 两者都使用 WithNoDirectDependency：&quot;filter&quot; 节点通过其直接边缘控制执行顺序&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLambdaNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;answer&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableLambda&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;in&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;any&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        topK, ok1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; in[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;TopK&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;].([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        question, ok2 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; in[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Question&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;].(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok2 {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;answer node input error: topK or question missing&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(topK) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                Answer: fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;在文档中未找到与 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%q&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 相关的内容&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, question),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 构造临时结构体传给 synthesize 函数，或者直接修改 synthesize 接收 map&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; synthesize&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, cm, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;synthIn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{TopK: topK, Question: question})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		AddInputWithOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;filter&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			[]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FieldMapping&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;TopK&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithNoDirectDependency&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		AddInputWithOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(compose.START,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			[]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FieldMapping&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MapFields&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Question&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Question&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithNoDirectDependency&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// END 节点接收来自 answer 的输出&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;End&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		AddInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;answer&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wf&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// newScoreWorkflow 构建用于每个 BatchNode 任务的单节点内部工作流&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; newScoreWorkflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cm&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;compose&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Workflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;] {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewWorkflow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLambdaNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;score_chunk&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, compose.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InvokableLambda&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;t&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreOneChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, cm, t)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(compose.START)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	wf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;End&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInput&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;score_chunk&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wf&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// scoreOneChunk 要求模型对单个分块的相关性进行评分（0–10）并提取最相关的摘录&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 解析错误会被视为 0 分，因此错误的 JSON 响应永远不会导致整个流水线中止&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreOneChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cm&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;t&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoreTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	prompt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;`请评分以下文本分块与问题的相关性。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;问题: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;文本分块:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;仅回复 JSON — 不要解释，不要 Markdown 代码块：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;{&quot;score&quot;: &amp;lt;0-10&amp;gt;, &quot;excerpt&quot;: &quot;&amp;lt;最相关的句子或短语，如果分数位 0 则为空字符串&amp;gt;&quot;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;评分指南: 0=完全无关, 3=略微相关, 7=清晰相关, 10=直接回答了问题。`&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		t.Question, t.Text)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resp, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cm.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Generate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{schema.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserMessage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(prompt)})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 将模型错误视为不相关，而不是中止整个批处理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Text: t.Text, Score: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(resp.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 去除可选的 markdown 代码块包装&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimPrefix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;```json&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimPrefix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;```&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSuffix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;```&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Score   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `json:&quot;score&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Excerpt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;excerpt&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unmarshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(content), &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;sr); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Text: t.Text, Score: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; scoredChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Text: t.Text, Score: sr.Score, Excerpt: sr.Excerpt}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// synthesize 根据前 K 个分块构建提示词并生成带有引用的回答。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; synthesize&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cm&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BaseChatModel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;in&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; synthIn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sb &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Builder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;仅使用提供的文档摘录回答以下问题。&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;问题: &quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(in.Question)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;文档摘录:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sources &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(in.TopK))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i, c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; in.TopK {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		excerpt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.Excerpt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; excerpt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			excerpt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.Text&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		sources[i] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; excerpt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;sb, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;] &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, excerpt)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;提供简洁清晰的回答。在引用来源时，请注明摘录编号，如 [1]。&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resp, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cm.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Generate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{schema.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserMessage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(sb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;synthesize: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Output&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Answer: resp.Content, Sources: sources}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// splitIntoChunks 将文本切分为最大 chunkSize 字符的分块，&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 尽可能在段落边界 (\n\n) 处断开，其次是换行符。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; splitIntoChunks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;text&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;chunkSize&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunks []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Builder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	flush &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			chunks &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunks, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;schema&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Document&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Content: s})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Reset&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, para &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Split&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(text, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		para &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(para)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; para &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(para)&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;			flush&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 如果段落本身超过了 chunkSize：按行拆分&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(para) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkSize {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Split&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(para, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(line)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(line)&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;					flush&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteByte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(line)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		} &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(para)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	flush&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunks&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 该包提供了一个由 compose.Workflow 支持的 answer_from_document（根据文档回答问题）工具。&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 该工作流使用字段映射（field mapping）在非相邻节点（score, answer）之间共享用户的提问，&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 而无需将提问参数穿透传递给每一个中间节点的输出类型：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	开始节点 START{文件路径 FilePath, 提问 Question}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	   │ (通过 WithNoDirectDependency 传递数据)─────────────────────────────────────┐&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	  ▼                                                                            │ 提问 Question&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	[load 节点]  os.ReadFile → []*schema.Document (读取文档)                       │&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	  ▼                                                                            │&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	[chunk 节点] 段落拆分器 → []*schema.Document (分块)                            │&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	  ▼  分块 Chunks ──────────────────────────────────────────────────────────► [score 节点]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                                │ []scoredChunk (已评分分块)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                               ▼&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                            [filter 节点] 获取 Top-K&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                                │ TopK (可能为空)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                               ▼&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                            [answer 节点] ◄─ 提问 (来自 START)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                     (在线合成答案或返回未找到)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                                │&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//	                                                                              结束 END&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// [score] 节点包装了一个 BatchNode，其内部工作流通过并行调用 ChatModel 对每个分块进行评分（最大并发数为 5）。&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;随后调用BuildTool会返回一个被包装为Tool.BaseTool的工具，可以供我们正常注册&lt;/p&gt;

&lt;h5 id=&quot;article-websearch-1&quot;&gt;WebSearch&lt;/h5&gt;&lt;p&gt;同样的我们可以使用Graph Tool实现联网搜索（Websearch）的功能&lt;/p&gt;
&lt;p&gt;值得一提，DuckDuck是一个方便的社区开源搜索API：&lt;strong&gt;&lt;a href=&quot;https://blog.csdn.net/a131529/article/details/145667129&quot;&gt;DuckDuckGo API使用指南&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-skill-2&quot;&gt;Skill&lt;/h4&gt;&lt;p&gt;为agent添加&lt;code&gt;skill.NewMiddleware&lt;/code&gt;就可以实现Skill的读取，同时要为其配置&lt;code&gt;Backend&lt;/code&gt;和&lt;code&gt;baseURL&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;同时，我们可以设置为如果没有Skill文件就不加载相关中间件，避免报错&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/internal/agent/agent.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 加载中间件，如果没有Skill文件就不加载相关中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; handlers []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;adk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ChatModelAgentMiddleware&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	skillsDir, found &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; resolveSkillsDir&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(skillDir)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; found {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		skillBackend, sbErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; skill.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewBackendFromFilesystem&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;skill&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BackendFromFilesystemConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Backend: backend,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			BaseDir: skillsDir,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sbErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			_, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stderr, sbErr)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		skillMiddleware, smErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; skill.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;skill&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Backend: skillBackend,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; smErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			_, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stderr, smErr)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		handlers &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(handlers, skillMiddleware)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 注册审批中间件和安全工具调用中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	handlers &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(handlers, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;component&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ApprovalMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;component&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SafeToolMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{})&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AmiyaAgent/internal/agent/agent.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 查找本地Skills文件夹&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; resolveSkillsDir&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;skillsDir&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; skillsDir &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; absSkillsDir, absErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Abs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(skillsDir); absErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		skillsDir &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; absSkillsDir&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fi, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Stat&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(skillsDir)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fi.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsDir&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; skillsDir, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-a2ui-agent-to-ui-1&quot;&gt;A2UI（Agent to UI）&lt;/h4&gt;&lt;p&gt;A2UI 并不属于 Eino 框架本身的范畴，它是一个业务层的 UI 协议/渲染方案。本章把 A2UI 集成进前面章节逐步构建出来的 Agent，是为了提供一个端到端、可落地的完整示例：从模型调用、工具调用、工作流编排，到最终把结果以更友好的 UI 方式呈现出来&lt;/p&gt;

&lt;h2 id=&quot;article-qqbot-1&quot;&gt;QQBot&lt;/h2&gt;&lt;p&gt;这个算是顺带一提的，我们可以用自己搭的Agent套个OneBot协议框架（如NapCat、LLOneBot）手搓一个高定制化的Bot，也可以用现成的Bot框架（如AstrBot）直接部署Bot，自由度由框架生态决定（插件等）&lt;/p&gt;
&lt;p&gt;具体搭建方法网上有很多，也可以去看AstrBot官方文档：&lt;strong&gt;&lt;a href=&quot;https://github.com/AstrBotDevs/AstrBot&quot;&gt;AstrBotDevs | AstrBot&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;，这里不在过多赘述&lt;/p&gt;
&lt;p&gt;搭建好了后顺便买个小服务器部署一下再测试几天，顺带算是把DevOps这块也简单了解一下，搞出来还是挺好玩的&lt;/p&gt;

&lt;h2 id=&quot;article-后记-1&quot;&gt;后记&lt;/h2&gt;&lt;p&gt;清明节这几天比较摆，基本没什么产出，一直在搞AstrBot、服务器、中转站、体验Vibe Coding啥的，最近才沉下来搞点产出，不过充其量也就是个用Eino搭的Agent而已，大神们玩烂的东西罢了，甚至汪神早就自己搓了一个LLM应用框架，瑰夏了。&lt;/p&gt;
&lt;p&gt;之后想写个分布式项目先，同时复习下算法啥的，感觉图论啥的都忘了，也没怎么用Go写过算法&lt;/p&gt;
&lt;p&gt;写完项目5月中左右？再看底层？哎呀反正很恼火捏&lt;/p&gt;

&lt;h2 id=&quot;article-参考文章-1&quot;&gt;参考文章&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.cloudwego.io/zh/docs/eino&quot;&gt;CloudWeGo | Eino&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://github.com/cloudwego/eino-examples/tree/main/quickstart/chatwitheino/cmd&quot;&gt;Eino官方仓库示例代码&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://blog.csdn.net/sinat_41460394/article/details/159516864&quot;&gt;Eino Tool 实战指南：三种创建方式详解&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/7596955804261679154#heading-20&quot;&gt;满血 Claude 不降智：Claude Code + 国内中转站实战指南&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://github.com/kengerlwl/phoneMcp&quot;&gt;kengerlwl | phoneMcp&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://github.com/AstrBotDevs/AstrBot&quot;&gt;AstrBotDevs | AstrBot&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://blog.csdn.net/m0_48891301/article/details/156265899&quot;&gt;RAG工作原理详解：11张图带你吃透RAG完整工作流程&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/29001189476&quot;&gt;MCP (Model Context Protocol)，一篇就够了&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://modelcontextprotocol.io/&quot;&gt;Model Context Protocol&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/2024269041427072886&quot;&gt;Harness到底是什么？&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/2026412619725116184&quot;&gt;什么是Harness？什么是Harness Engineering？&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/2021148229522206903&quot;&gt;一文读懂Skill：从基础到实操&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://docs.coze.cn/cozeloop/what-is-cozeloop&quot;&gt;Coze | CozeLoop&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://blog.csdn.net/a131529/article/details/145667129&quot;&gt;DuckDuckGo API使用指南&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-Agent/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Agent</category><category>Golang</category><category>架构设计</category></item><item><title>随笔.8：努力地追赶与不绝的焦虑</title><link>https://www.claran-blog.work/posts/diary8/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/diary8/</guid><description>分布式学习完结的总结与对未来的规划.</description><pubDate>Mon, 30 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-近期的总结和思考-1&quot;&gt;近期的总结和思考&lt;/h2&gt;
&lt;h3 id=&quot;article-总结-1&quot;&gt;总结&lt;/h3&gt;&lt;p&gt;从三月初开始，我就紧锣密鼓地开始了微服务和分布式这方面学习&lt;/p&gt;
&lt;p&gt;一方面，耄耋汪神T神这些大手子老早就把微服务这一块搞完了，还在很久以前就产出了实际项目，另一方面因为之前几个月有点摆，所以在学习过程中总是有无穷的压力和焦虑伴随着我&lt;/p&gt;
&lt;p&gt;刚开始学微服务的时候，理解微服务的基础概念相当简单，学习框架使用倒也不难，但是在实际写了一天Demo后，对照我的Demo和别人的分布式项目，我发现我的架构出了很大的问题，直接把分布式项目变成单体式架构了。为什么会这样呢？原来是因为我跟着学习的AI不知道什么时候出现了幻觉，从某一时刻开始就顺从了我的错误并继续对话，甚至AI还对正确的架构义正言辞地告诉我“不是这么写的”，最后换了个模型才终于解决，但是当时我已经按照原AI给的错误架构写了一天Demo了&lt;/p&gt;
&lt;p&gt;虽然过程出了点小插曲，但是微服务基础方面还是很快就学习完了，接下来继续学习注册中心和etcd，这一方面我先去学习并实现了不依赖外部组件，也就是手搓了一个注册中心，了解了注册中心的核心机制，再集成了etcd和kitex框架下的快速服务注册和发现。不过在学习etcd时，我曾纠结过要不要先暂停当前的学习转而去学习mit6.824，也就是分布式系统和Raft算法那部分，不过最终我还是选择了继续学习微服务组件，而分布式系统和Raft的部分我则在之后的分布式事务后才进行了学习&lt;/p&gt;
&lt;p&gt;服务治理这方面也学得很快，其中唯一值得一提的就是手搓了一个熔断器完成了熔断器的实现，了解了熔断器的核心机制&lt;/p&gt;
&lt;p&gt;接下来就到了消息队列这一板块，我觉得理解基础概念与使用哲学反而是核心，否则容易陷入为了使用消息队列而使用消息队列的尴尬处境。在了解了消息队列部分的实现原理后，我便用Kafka写了个Demo。比较不足的是我目前也只了解了kafka和RocketMQ两种消息队列&lt;/p&gt;
&lt;p&gt;在接下来就是可观测性了，这一部分相比前面部分就比较复杂，难的不是了解实现机制和代码实现，而是合理编排容器，编写docker-compose等。从Prometheus到Jaeger，再到ELK，都是学文章-&amp;gt;写Demo-&amp;gt;写docker-compose-&amp;gt;测试-&amp;gt;改docker-compose-&amp;gt;测试-&amp;gt; ... -&amp;gt; 完全实现 这样完成的，不过最后在Web UI上看到Demo的指标链路啥的还是很爽的&lt;/p&gt;
&lt;p&gt;最后就是重头戏分布式事务，作为最重要也是最复杂的一部分，我花了将近一周时间在这上面，从最开始理解数据一致性到分析数据一致性，再到分布式事务的机制和Raft算法的底层原理，到最后用DTM框架实现分布式事务，每一步都仔细地看了各种技术文章，我博客上关于这一部分的总结文章也是第一个突破万字的文章。&lt;/p&gt;
&lt;p&gt;另外，在学习分布式的途中，我还去了解了一个架构——DDD架构，本身作为充血模型就非常适合分布式的大型项目，不过在Java那边使用得更多一些，同时写该架构也有更高的难度，目前仅仅是学习完了，并没有去写Demo实践&lt;/p&gt;
&lt;p&gt;当然，目前对于分布式这款的学习也不算尽全，包括Raft没有自己去手搓一遍（耄耋跟着mit6.824一边学一边写lab，跪了），也没有去完全了解消息队列这一块，DDD架构更是还没有去写Demo，包括八股啥的也没看完，目前先搁置在这里吧&lt;/p&gt;
&lt;p&gt;综上，三月整体上来说学习得还算是比较紧张，每天都是翘了课就往数图跑（只有数图有让我一直学习的氛围），一边看别人的项目代码，一边看课件和其他文章，又一边与AI斗智斗勇，才慢慢地搞完了这一板块。可以说这一段时间有点过于充实了，经常十点半才开始往明志走。不过一边听歌一边散步（赶路）还是很惬意的。&lt;/p&gt;
&lt;p&gt;不过三月后期我就开始回家学习了，氛围虽说比不上数图这么好，但是自由了不少，学习效率也差不多，顺便还能蹭家里饭省钱&lt;/p&gt;
&lt;p&gt;扯远了。最终在三月末也算是把分布式这方面搞完了，可喜可贺，不过目前还是觉得自己技术太垃圾了。同时耄耋和汪神也离我更远了，都学完了操作系统等计算机底层，搞了ai agent，甚至还做了开源，真给你们跪了，还有T神和Ocean，也给你们跪了，还有Met大手子，还有其他大手子，我都给你们跪了。&lt;/p&gt;
&lt;p&gt;不过也在某个平台上看到了这样的一句话：“&lt;strong&gt;保持那份清醒的忧虑，它会让你走的更远&lt;/strong&gt;”&lt;/p&gt;
&lt;p&gt;xtt聚餐因为有点社恐没去，我也不好意思主动请缨😭😭😭未能窥见汪神T神Ocean真容😭😭😭希望有时间再说吧&lt;/p&gt;

&lt;h3 id=&quot;article-思考-1&quot;&gt;思考&lt;/h3&gt;&lt;p&gt;这一个月，我不仅仅在学习新知识，也在不断地被不绝的焦虑折磨（学计算机的有不焦虑的吗？）&lt;/p&gt;
&lt;p&gt;一是觉得有时候自己学习得比较浅薄，只是“会使用某个组件”或者“会调用某个API”，而不是深入这个组件的源码去学习深层实现和思想&lt;/p&gt;
&lt;p&gt;当我再回首时，才能感觉到：&lt;strong&gt;我学微服务，不是在学Kitex或Hertz的API，而是在学“如何拆分、治理、观测一个分布式系统”。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;这套思想，放之任何技术而皆准。我真正的投资应该放在“底层原理”和“核心思想”上，放在应对任何技术变迁的“元能力”上&lt;/p&gt;
&lt;p&gt;因此在学习后面的部分时，我多少都去看了组件的基础机制和源码，这也是八股的一大重要部分&lt;/p&gt;
&lt;p&gt;二是最近AI“侵入”愈演愈烈，月初有被内行看笑话的“OpenClaw”，月中有三石的“开除速度一定要快”和“有人截屏了！”，月末有ApiFox内部Leader因为过度AI转型导致的供应链投毒事件（咱也中招了，还好咱没服务器啥的），计算机行业从事者（特别是还未入行的我们）能显著地感觉到，低能或者普通的程序员被ai agent降本增效的速度和程度都越来越快，越来越大，计算机这个“围城”的尺寸也愈来愈小，更多的人想挤进去，更多的人被赶出来。&lt;/p&gt;
&lt;p&gt;我想，再过几年，甚至再过一年，这个行业又会是怎样的？我能挤进这个围城吗？现在我们正站在行业转型的风口吗？一切仍未可知，但好像又已初见端倪。&lt;/p&gt;

&lt;h2 id=&quot;article-未来规划-1&quot;&gt;未来规划&lt;/h2&gt;&lt;p&gt;未来计划学习的有很多，包括ai agent，计算机底层，K8s，以此把之前学的落地写一个DDD的分布式项目&lt;/p&gt;
&lt;p&gt;但是，我该先干哪件事，再学那一部分，我却对此感到迷茫&lt;/p&gt;
&lt;p&gt;诚然，最好的前景是我可以并发学习这几个板块的内容，但这显然不太现实&lt;/p&gt;
&lt;p&gt;同时，随着AI对计算机的冲击，我觉得我们对于ai agent方向应有的的技术栈也许不仅仅是了解和使用这么简单了&lt;/p&gt;
&lt;p&gt;所以，最后我决定先把AI agent这一板块搞完，一方面这是我一个比较感兴趣的部分，另一方面也方便我们之后vibe coding或者利用ai进行其他操作&lt;/p&gt;
&lt;p&gt;与此并发，在学AI agent之余，也该把计算机底层看一看了，从基础的计组开始，到操作系统，再到计网，想必又是很长的一段路&lt;/p&gt;
&lt;p&gt;当然，有时间的话也写一下项目比较好，刚好完成寒假的考核任务&lt;/p&gt;
&lt;p&gt;如果音律能抢到票的话，就先把项目搁置一下。如果音律抢不到票，我就悲天呛地发疯抑郁地写一个分布式&lt;strong&gt;抢票&lt;/strong&gt;秒杀项目吧，可恶的大麦啊&lt;/p&gt;

&lt;h2 id=&quot;article-其他-1&quot;&gt;其他&lt;/h2&gt;
&lt;h3 id=&quot;article-音律联觉-1&quot;&gt;音律联觉&lt;/h3&gt;&lt;p&gt;明天就要抢票了，一定要让我抢到票啊😭😭😭如果真能抢到票大概会让我开心好几个月吧😭抢不到票这种事补药啊😭😭😭无法想象抢不到票这件事啊😭😭😭我可是攒了好久的钱啊😭😭😭我一定要去上海看音律联觉啊😭😭😭&lt;/p&gt;
&lt;p&gt;先不发电了（虽然是真情流露）。作为一个忠诚的舟批，我从很久以前就想去音律联觉了（哪个舟批不想去？）&lt;/p&gt;
&lt;p&gt;唯一从以前喜欢的现在的游戏ip就是《明日方舟》了，也许不光是因为它本身的游戏性，剧情和运营都做的很好，也因为舟独特的世界观、如此完美的看板娘阿米娅、无敌的音乐的平面设计，也更是因为它填充了我的青春的色彩吧&lt;/p&gt;
&lt;p&gt;综上，我是一名忠诚的舟批&lt;/p&gt;
&lt;p&gt;一定要让我抢到票啊😭😭😭&lt;/p&gt;
&lt;p&gt;补：没有抢到票，想似。。。。。&lt;/p&gt;

&lt;h3 id=&quot;article-装修-1&quot;&gt;装修&lt;/h3&gt;&lt;p&gt;最近家里要重新装修了，十八年后的首次重装&lt;/p&gt;
&lt;p&gt;虽然目前家里没啥毛病，而且也还算感觉，甚至我才刚搞完我的电脑桌区域并对我的房间装饰进行了全面改造，但是家人还是想把家里重新装修一遍，而且还让我主导&lt;/p&gt;
&lt;p&gt;所有三月份我还有一个重要支线就是规划房屋的翻新&lt;/p&gt;
&lt;p&gt;过程挺繁琐的，最后选了天怡美装修公司，谈定了相关事宜，最近就要搬家然后开工了，所以旧房子也是住一天少一天，也能算作即将消失的童年回忆了&lt;/p&gt;
&lt;p&gt;不过搬家也是临时租的房子，还是同小区，甚至同栋的，所以对我其实也没啥大影响，顶多就是刚刚布置好的房间又要没了，跟我美好的房间说拜拜😭😭😭&lt;/p&gt;
&lt;p&gt;记录一下费尽心思搞的舒适区~!&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/d84.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/d81.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/d82.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/d83.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-神经-1&quot;&gt;神经&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;这一块主要是对平常的突发奇想或者若有感触的产出和时不时的发电的即时记录，跟写博客的时候无关&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;枯燥的按部就班或者一味地奋斗是能长期持续的，所以我便喜欢找一个无事或有事的晚上，一个人下山做着追寻自由一样地漫游。可以做346或者347下山，再乘地铁到石桥铺，或者到观音桥，解放碑，大坪，又或者坐347直接到南坪。在大一的这段时间，这些地方我都去过，坐上车，戴上耳机听着喜欢的歌，漫游在城市的大街小巷。往往这个时候，脑中不在思考繁琐的生活或学习，也不在为未来的规划焦虑。或偶尔有课有事我也会偷偷翘掉溜出山上，这时反而更能体会到自由的滋味，是那种想长舒一口气到“这才是生活啊！”的滋味。这段文字也正式我在某个无趣的日子坐车下山途中若有所思记录下来的。&lt;/p&gt;
&lt;p&gt;有时也会叫上我的一位高中同学，下山只是下山，我们不会想我们要去干什么，或者说为了什么目的而去什么地方。我们只是下山，先做上公交车到上新街再说。可能接下来会去商圈逛商场，去古镇漫游，或者突袭高中...干什么不重要，重要的是先下山，先迈出脱离繁杂生活的第一步，就像我们平时学习做的那样&lt;/p&gt;
&lt;p&gt;听歌真是好文明啊，我喜欢把音量开到最大，感受音乐带给我的感受和情绪。或激昂富有节奏感的欧美流行曲，或耐听抓耳的术力口，或者一些包含故事的BGM，都能让我在思绪的世界流连忘返。&lt;/p&gt;
&lt;p&gt;那种感觉，就像是你真正成为了故事的主人公，或者一段史诗的旁观者，让脚步都能踩出故事的韵脚来。脑海里回荡着的旋律，甚至会冲破声波的桎梏，迈动着你的身体，直击你心中最渴求情绪的部位&lt;/p&gt;
&lt;p&gt;话说回来，我听音乐的习惯相比其他人可能会很奇怪，主要是平台，我只喜欢用b站的后台播放听歌，一是不会被音乐平台的vip桎梏，二是一些喜欢的歌可能在音乐平台找不全而b站几乎都能全收集，三是长久养成的习惯如此&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/diary8/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>随笔</category><category>杂项</category></item><item><title>充血架构：走进领域驱动设计（DDD架构）</title><link>https://www.claran-blog.work/posts/go-DDD/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-DDD/</guid><description>领域驱动设计（DDD架构）从理论讲解到落地实践.</description><pubDate>Fri, 27 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-浅谈架构设计-1&quot;&gt;浅谈架构设计&lt;/h2&gt;&lt;p&gt;说道架构设计，我们首先想到的应该就是我们之前写单体式架构用到的三层架构（handler/controller-service-dao），或者最近学习的微服务架构。世界上没有所谓完美的架构，简单的架构可拓展性低，性能优异的架构实现难度又很高&lt;/p&gt;

&lt;h3 id=&quot;article-传统三层架构-1&quot;&gt;传统三层架构&lt;/h3&gt;&lt;p&gt;传统三层架构是一种经典的软件分层模式，将应用程序分为表现层、业务逻辑层和数据访问层。在我们之前实现的单体式架构项目、或者通常的Web开发中，就实现了相应的Handler-Service-Dao的三层架构&lt;/p&gt;
&lt;p&gt;这种架构职责分离清晰，上手简单，适用于业务逻辑相对固定的中小型项目。然而，接连不断的问题随着项目复杂程度的增加初见端倪：&lt;/p&gt;
&lt;p&gt;在三层架构中，handler层只负责提取请求信息并包装到service层，dao层只负责基础的数据和缓存交互，这样一来当我们的项目越做越大，需要添加的功能越来越多，就会有越来越多的业务逻辑堆积在service层，service层的代码就会无限制地扩大，成为类似于屎山的存在&lt;/p&gt;
&lt;p&gt;这就叫做“贫血架构”，在这种架构中，业务逻辑容易“贫血”，大量业务规则和流程代码堆积在Service中，导致Service类日益臃肿，成为“上帝类”，领域知识（业务的核心概念和规则）分散在各处，可维护性和可测试性变差&lt;/p&gt;

&lt;h3 id=&quot;article-mvc架构-1&quot;&gt;MVC架构&lt;/h3&gt;&lt;p&gt;MVC架构有些许类似于三层架构，是另一种广为人知的架构模式，主要用于分离用户界面逻辑。Model代表数据和业务规则，View负责展示，Controller处理用户输入。&lt;/p&gt;
&lt;p&gt;在Web开发中，MVC常与传统三层架构结合，其中的Controller和View可视为“表现层”，而Model则可能变得“贫血”——仅作为数据的载体，真正的业务逻辑被转移到了Controller或专门的Service中。MVC解决了UI与逻辑的耦合，但对于复杂业务领域内部的组织结构，它并没有提供更多指导&lt;/p&gt;

&lt;h3 id=&quot;article-贫血模型和充血模型-1&quot;&gt;贫血模型和充血模型&lt;/h3&gt;&lt;p&gt;在对上面两个架构的介绍中，我们可以抽离一个新概念，用于描述一个架构的封装思想——“贫血模型”和“充血模型”&lt;/p&gt;
&lt;p&gt;“贫血模型”和“充血模型”是理解架构演进的关键。贫血模型 (Anemic Domain Model)是指对象（如User、Order）只包含数据（字段）和简单的getter/setter，而不包含业务行为。所有业务逻辑都存在于所谓的“服务层”（Service）中。这正是传统三层架构的常见结果&lt;/p&gt;
&lt;p&gt;充血模型 (Rich Domain Model)则强调对象应该是“智能”的，它将与该对象紧密相关的数据和行为封装在一起。例如，User对象不仅有Balance字段，还有Transfer(amount)、ChangePassword(newPwd)等方法。业务规则内聚在对象内部，更符合面向对象设计的封装思想。领域驱动设计（DDD）的核心就是构建充血模型&lt;/p&gt;

&lt;h3 id=&quot;article-贫血模型不能忽视的问题-1&quot;&gt;贫血模型不能忽视的问题&lt;/h3&gt;&lt;p&gt;随着微服务和业务复杂性的爆炸式增长，传统架构面临严峻挑战：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;业务逻辑分散：核心的业务规则隐藏在庞大的Service方法和流程控制代码中，久而久之变得难以理解和维护&lt;/li&gt;
&lt;li&gt;技术细节与业务逻辑耦合：数据库操作、缓存、消息队列等基础设施代码与核心业务代码混杂&lt;/li&gt;
&lt;li&gt;可测试性差：由于高度耦合，单元测试往往需要启动整个应用上下文，变成了集成测试，运行慢且不稳定&lt;/li&gt;
&lt;li&gt;演进困难：当需要调整业务规则或替换技术组件时，牵一发而动全身，风险高&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;为了解决这些问题，我们需要一种将业务复杂性置于设计核心的方法论，这就是领域驱动设计（DDD架构）&lt;/p&gt;

&lt;h2 id=&quot;article-领域驱动设计-ddd架构-1&quot;&gt;领域驱动设计（DDD架构）&lt;/h2&gt;
&lt;h3 id=&quot;article-ddd的意义-1&quot;&gt;DDD的意义&lt;/h3&gt;&lt;p&gt;在 DDD (领域驱动设计) 中，需要将重点放在领域层（Domain Layer）进行业务逻辑和规则的实现。服务层（Service Layer）主要负责协调和调度各个领域对象之间的交互&lt;/p&gt;
&lt;p&gt;简单来说，如果传统模型是重service轻dao的话，对于面向对象充血模型的 DDD 而言，是重 Domain 轻 Service&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;严格来说，因为Go语言本身的简明性和其他机制，DDD架构在Java领域的应用远比Go更富有实际意义。但我们还是需要学会在Go里实现这种架构模式，这种模式不仅仅可以提升我们完成业务的能力，还能让我们对架构设计理念有一个更透彻的认知&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;DDD不仅是一套架构模式，更是一种思维方式。它强调开发人员、领域专家通过通用语言 (Ubiquitous Language)进行协作，专注于核心业务（核心域）的建模，通过限界上下文 (Bounded Context)划分大型系统的边界，并使用聚合 (Aggregate)、实体 (Entity)、值对象 (Value Object)等模式构建出反映真实业务的、丰富的领域模型。在架构层面，DDD引导我们将这个“充血”的领域模型置于系统的核心位置，并围绕它组织代码结构&lt;/p&gt;
&lt;p&gt;当然，我和多数人一样，在看到上面这串由无数个专有名词统合而成的解释句子时，这些专有名词就在概念中拧成了一团乱麻，理解不了各个部分的含义。我们接下来就来细细对它们进行解释&lt;/p&gt;

&lt;h3 id=&quot;article-ddd基本概念-1&quot;&gt;DDD基本概念&lt;/h3&gt;&lt;p&gt;首先，我们需要知道，DDD架构主要有四层——接口层（对应三层架构的handler）、应用层（对应没有具体业务逻辑的service层）、领域层（对应service层的业务代码）和基础设施层（对应dao层）&lt;/p&gt;
&lt;p&gt;为了更好理解DDD架构，我们可以先入为主地理解（但实际上有差别）——我们可以把DDD架构想象为把原三层架构的service层拆解为业务编排+业务实现两层后的架构，其中的领域层就是把service的各种臃肿的业务逻辑包装成各个具体方法（例如“检查库存是否足够”或者“判断操作是否合法”），应用层就是对领域层的各个方法进行事件编排实现的抽象业务逻辑&lt;/p&gt;
&lt;p&gt;当然实际上DDD架构与三层架构还有很多区别，例如我们之前提到过的“充血模型”，要求“与对象紧密相关的数据和行为封装在一起”。因此实际上在领域层内“解耦合的业务实现”还需要被包装在特殊的模型下，这个模型就是聚合（Aggregate）。聚合内部会包装具体的数据模型（如User）和一些特殊值（totalUserCount），这些就叫做实体（Entity）和值对象（Object Value）&lt;/p&gt;
&lt;p&gt;这下，我们就可以把领域层梳理清楚了：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/DDD1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;因此，聚合可以看作是领域层的核心，它封装了数据模型和值（实体和值对象），同时依赖于数据层的接口，完成了业务逻辑的包装和实现。需要注意的是，聚合依赖的是抽象的数据层接口，而非实际的接口，因此领域层并不直接依赖于数据层，而是让数据层的方法主动实现领域层的接口&lt;/p&gt;
&lt;p&gt;而图中的界限上下文这是划分领域与领域间的重要区分标志，相当于不同的服务划分，如User和Post&lt;/p&gt;

&lt;h4 id=&quot;article-option模式-1&quot;&gt;Option模式&lt;/h4&gt;&lt;p&gt;在深入DDD架构前，我们先来补充一个重要概念——Option模式&lt;/p&gt;
&lt;p&gt;Option模式（也称函数式选项模式）是一种在Go中优雅处理可选参数的设计模式。它解决了传统构造函数的痛点，特别适合配置项多、有默认值、可选的场景&lt;/p&gt;
&lt;p&gt;我们传统的传统函数构造如下：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 传统构造函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Server&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Addr     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Port     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Timeout  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    MaxConns &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    TLS      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tls&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 问题1：参数太多，调用时难以阅读&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;addr&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;port&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;timeout&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;maxConns&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;tls&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tls&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{addr, port, timeout, maxConns, tls}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 调用时：参数顺序必须正确，可读性差&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;localhost&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;8080&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;30&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.Second, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 问题2：使用配置结构体，但必须传递整个结构体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Config&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Addr     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Port     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Timeout  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    MaxConns &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    TLS      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tls&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;config&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Addr:     config.Addr,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Port:     config.Port,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Timeout:  config.Timeout,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        MaxConns: config.MaxConns,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        TLS:      config.TLS,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 调用时：即使只用一个字段，也要创建完整Config&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Addr: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;localhost&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Port: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;8080&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 其他字段用零值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 问题3：零值歧义&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 如果Port=0，是有意设置为0还是忘记设置了？&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 如果Timeout=0，是立即超时还是用默认值？&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;因此，为了更优雅地构造函数及传递参数，我们使用Option模式：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 核心：定义一个Option函数类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Option&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 为每个可选参数创建配置函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WithAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;addr&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s.Addr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; addr&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WithPort&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;port&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s.Port &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; port&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WithTimeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;timeout&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s.Timeout &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; timeout&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WithMaxConns&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;maxConns&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s.MaxConns &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; maxConns&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WithTLS&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;tls&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tls&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s.TLS &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tls&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 构造函数接收可变参数的Option&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;opts&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 设置默认值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Addr:     &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 默认地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Port:     &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;8080&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,         &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 默认端口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Timeout:  &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;30&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 默认超时&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        MaxConns: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,          &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 默认最大连接数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 应用所有Option函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, opt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; opts {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        opt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 优雅的使用方式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 只设置需要的参数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    s1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;localhost&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 任意顺序，任意数量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    s2 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        WithPort&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;9000&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        WithAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;0.0.0.0&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        WithMaxConns&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;200&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 全部使用默认值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    s3 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 清晰、可读、可扩展&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    s4 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        WithAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;api.example.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        WithPort&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;443&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        WithTLS&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tls&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        WithTimeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;60&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.Second),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这种Option模式，在DDD中则广泛作为实体店构造方式，这保证了对象的不可变性和有效性，与DDD中聚合根需要维护自身一致性的思想相契合&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; User&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ID       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Name     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Email    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Email&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Option&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WithEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;addr&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;u&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        email, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(addr) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 值对象构造，可包含验证&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            u.Email &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; email&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;opts&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    u &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{ID: id, Name: name}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, opt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; opts {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        opt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(u)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // ... 其他一致性校验&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; u, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-依赖注入-1&quot;&gt;依赖注入&lt;/h4&gt;&lt;p&gt;我们早在之前的单体式架构就已经用过了依赖注入思想，其是解耦领域层与基础设施层的关键。领域层只定义Repository接口（依赖抽象），具体的实现（如MySQL、Redis版本）在基础设施层实现，并在应用启动时通过构造器注入。这遵循了依赖倒置原则（DIP），使领域层保持“纯净”，不依赖于任何技术细节&lt;/p&gt;
&lt;p&gt;例如，在领域层，我们之前说过的聚合依赖的数据层的接口，实际上是现在领域层定义的抽象接口，领域层内并没有具体的实现方法：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// internal/domain/user/repository/user_repository.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; repository&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your-app/internal/domain/user/entity&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// UserRepository 领域层定义的仓储接口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserRepository&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    FindByID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    Save&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    ExistsByEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;email&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-依赖倒置-1&quot;&gt;依赖倒置&lt;/h4&gt;&lt;p&gt;在传统的三层结构中，我们总是从上到下地注入依赖：handler-&amp;gt;service-&amp;gt;dao&lt;/p&gt;
&lt;p&gt;但是在DDD架构在，领域层不需要任何依赖，反而需要基础设施层实现领域层的依赖，这便是依赖倒置&lt;/p&gt;
&lt;p&gt;因此，在领域层中，我们定义抽象的仓储接口，不实现具体的仓储业务，反而让基础设施层的数据持久化部分来主动实现我们领域层的接口，这也是DDD的精髓&lt;/p&gt;

&lt;h4 id=&quot;article-ddd经典四层架构-1&quot;&gt;DDD经典四层架构&lt;/h4&gt;&lt;p&gt;接下来，我们来拆解一下DDD四层架构的核心实现：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;──────────────────────────────────────────────────────&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                Interface Layer (接口层)              &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        负责与外部世界通信，协议转换，输入输出处理              &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;──────────────────────────────────────────────────────&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;               Application Layer (应用层)             &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        协调用例流程，事务管理，不包含业务规则                  &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;──────────────────────────────────────────────────────&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                Domain Layer (领域层)                &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            核心业务逻辑，领域模型，业务规则                       &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;──────────────────────────────────────────────────────&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;           Infrastructure Layer (基础设施层)           &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        技术实现细节：数据库、外部服务、消息队列等              &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;──────────────────────────────────────────────────────&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;              外层依赖内层，内层不依赖外层&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-interface-接口层-1&quot;&gt;Interface（接口层）&lt;/h5&gt;&lt;p&gt;这一层类似于我们原三层架构的handler层，主要负责： &lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;将外部协议（HTTP、RPC、消息、CLI等）转换为内部调用，例如kitex_handler&lt;/li&gt;
&lt;li&gt;向外部返回响应&lt;/li&gt;
&lt;li&gt;认证、授权、限流、日志、监控和其他中间件等&lt;/li&gt;
&lt;li&gt;消息队列的消费者&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;在这其中，我们要实现数据协议的转换，例如捕获请求中的JSON格式数据，或者将请求数据转换为JSON响应，这一步就叫作DTO（数据传输对象）&lt;/p&gt;
&lt;p&gt;这一层较为简单，且只依赖应用层来完成业务处理&lt;/p&gt;

&lt;h5 id=&quot;article-application-应用层-1&quot;&gt;Application（应用层）&lt;/h5&gt;&lt;p&gt;在该层，我们应该实现：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;用例编排&lt;/strong&gt;：协调多个领域对象完成一个完整的用户用例&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;事务管理&lt;/strong&gt;：确保一个用例内的所有操作在一个事务中&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;安全控制&lt;/strong&gt;：权限检查、访问控制&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;工作单元&lt;/strong&gt;：管理聚合根的加载、修改、保存生命周期&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;事件发布&lt;/strong&gt;：发布领域事件到消息总线&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;CQRS分离&lt;/strong&gt;：将命令（写操作）和查询（读操作）分离&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;需要注意的是，该层的业务逻辑只负责简单的业务编排，不包含复杂的业务代码，例如在一个注册用户的业务中：&lt;/p&gt;
&lt;p&gt;我们进行前置唯一性检查后，便开启事物，在事物内部：创建值对象 -&amp;gt; 创建并保存聚合根(调用的是领域层的抽象仓储接口) -&amp;gt; 发布领域事件&lt;/p&gt;
&lt;p&gt;查询用户:直接调用领域层的抽象仓储接口&lt;/p&gt;
&lt;p&gt;更新用户:加载聚合根(领域层抽象仓储接口) -&amp;gt; 更新用户（领域对象方法） -&amp;gt; 检查邮箱唯一性(领域层抽象仓储接口) -&amp;gt; 保存聚合根(领域层抽象仓储接口) -&amp;gt; 发布领域事件&lt;/p&gt;

&lt;h5 id=&quot;article-domain-领域层-1&quot;&gt;Domain（领域层）&lt;/h5&gt;&lt;p&gt;这一层的核心逻辑是：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;封装业务逻辑&lt;/strong&gt;：实现所有业务规则和领域逻辑&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;定义领域模型&lt;/strong&gt;：实体、值对象、聚合、领域服务&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;定义仓储接口&lt;/strong&gt;：抽象数据访问，不关心实现细节&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;定义领域事件&lt;/strong&gt;：表示领域中发生的重要事情&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;保持纯净&lt;/strong&gt;：不依赖任何技术框架、数据库、外部服务&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这一层涉及到多个次结构：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;实体和所属工厂方法和业务方法（User、NewUser、ChangePassword）&lt;/li&gt;
&lt;li&gt;值对象和所属工厂方法和业务方法（Email、NewEmail、GetEmailDomain）&lt;/li&gt;
&lt;li&gt;领域服务（涉及多个实体或值对象的方法）&lt;/li&gt;
&lt;li&gt;抽象仓储接口（FindByID、ExitsByUsername）&lt;/li&gt;
&lt;li&gt;领域事件（相当于单服务内的简化消息队列）&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;需要注意的是，这里的领域事件可以看作是单服务内的生产/消费者思想，用于对应用层和领域服务解耦&lt;/p&gt;

&lt;h5 id=&quot;article-infrastructure-基础设施层-1&quot;&gt;Infrastructure（基础设施层）&lt;/h5&gt;&lt;p&gt;字面意思，如果领域层是项目的脚手架，那么基础设施层就是撑起我们整个项目的基石，拥有这些职责：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;技术实现：提供具体的技术实现，如保存用户信息&lt;/li&gt;
&lt;li&gt;数据持久化（PO）：实现仓储接口，访问数据库&lt;/li&gt;
&lt;li&gt;外部服务集成：调用第三方API、消息队列、缓存等&lt;/li&gt;
&lt;li&gt;技术框架：数据库连接、HTTP客户端、配置管理等&lt;/li&gt;
&lt;li&gt;横切关注点实现：日志、监控、追踪的具体实现&lt;/li&gt;
&lt;li&gt;组件集成：集成其他微服务组件（如配置中心等）&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;需要特别说明的是，基础设施层的仓储实现需要主动去实现在领域层抽象定义的仓储接口，并实现各模型的转换（如将领域模型转换成数据库模型PO）&lt;/p&gt;

&lt;h3 id=&quot;article-从三层架构到ddd架构的思想转变-1&quot;&gt;从三层架构到DDD架构的思想转变&lt;/h3&gt;&lt;p&gt;我们都知道，在三层架构中，数据层不仅包含了具体的数据库交互方法，还包含了各种数据model。而在DDD内部，这种数据model变化成了Aggregate、Entity和Object Value，并将业务代码与这些“model”耦合（封装），减轻service层的负担&lt;/p&gt;
&lt;p&gt;另外，各个层次之间的数据交互也更加严格（DTO、PO），也提升了项目整体的可拓展性&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;最重要，也是最核心的思想就是：从以数据库/CRUD为中心，转向以业务领域模型为中心&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;三层架构思考“数据怎么存、怎么取”，DDD思考“业务是什么、怎么运作”&lt;/p&gt;
&lt;p&gt;三层架构的Model是“贫血”的数据容器；DDD的Domain Model是包含行为和规则的“活”的对象&lt;/p&gt;
&lt;p&gt;三层架构的Service是承载业务逻辑的主体；DDD的Application Service是薄薄的协调层，核心逻辑在Domain中&lt;/p&gt;
&lt;p&gt;三层架构常表现为上层依赖下层的数据库；DDD通过依赖倒置，让核心的Domain层定义接口，底层Infrastructure去实现&lt;/p&gt;

&lt;h2 id=&quot;article-ddd-的-go-代码实战-1&quot;&gt;DDD 的 Go 代码实战&lt;/h2&gt;&lt;p&gt;DDD架构示例代码仓库：&lt;strong&gt;&lt;a href=&quot;https://github.com/pokeyaro/go-ddd-layout&quot;&gt;go-ddd-layout&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;我们可以阅读该仓库的代码来加深我们对DDD架构的理解&lt;/p&gt;
&lt;p&gt;以下是一个在分布式系统中user-service单服务的DDD架构示例结构图：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;user-service/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── cmd/                          # 启动入口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── server/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       └── main.go              # 主入口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── kitex_gen/                   # Kitex框架&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── idl/                         # IDL定义文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── internal/                    # 内部代码（DDD四层）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── domain/                  # 领域层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   └── user/                # 用户聚合&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       ├── entity/          # 实体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       │   ├── user.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       │   └── role.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       ├── valueobj/        # 值对象&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       │   ├── email.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       │   ├── password.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       │   └── phone.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       ├── repository/      # 仓储接口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       │   ├── user_repository.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       │   └── role_repository.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       ├── service/         # 领域服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       │   └── user_service.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       └── event/           # 领域事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │           ├── user_created.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │           └── user_updated.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── application/             # 应用层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   └── user/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       └── service/         # 应用服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │           └── user_app_service.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── interfaces/              # 接口层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   ├── kt_handler/          # Kitex处理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │   └── user_handler.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   ├── adapter/             # 适配器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │   ├── assembler/       # 组装器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │   │   └── user_assembler.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │   ├── converter/       # 转换器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │   │   └── user_converter.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │   └── middleware/      # 中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │       ├── logging.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │       ├── recovery.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │       ├── tracing.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │       └── validator.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   └── dto/                 # 数据传输对象&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       ├── request/         # 请求DTO&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       │   └── user/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       └── response/        # 响应DTO&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │           └── user/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── infrastructure/          # 基础设施层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       ├── config/              # 配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   ├── config.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   └── consul.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       ├── persistence/         # 持久化&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   ├── mysql/           # MySQL仓储实现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   │   ├── user_repository.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   │   └── role_repository.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   ├── po/              # 持久化对象&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   │   ├── user.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   │   └── role.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   └── converter/       # PO-DO转换器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │       └── user_converter.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       ├── kt_client/           # Kitex客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       ├── service_discovery/   # 服务发现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   ├── consul/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   │   ├── registry.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   │   ├── discovery.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   │   └── health.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   └── nacos/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       ├── message/             # 消息队列&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   ├── kafka/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   │   ├── producer.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   │   └── consumer.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   └── event_handler/   # 事件处理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │       └── user_event_handler.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       ├── cache/               # 缓存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   └── redis_cache.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       ├── log/                 # 日志&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       │   └── logger.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       └── tracer/              # 分布式追踪&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│           └── jaeger_tracer.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;└── pkg/                         # 工具包&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;看着一大堆可能眼睛都看花了，不过我们只需要知道，相比于之前的三层架构，新架构的变化主要还是DDD的四层架构：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;user-service/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;└─ internal/                     # 内部代码（DDD四层）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── domain/                  # 领域层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │   └── user/                # 用户聚合&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │       ├── entity/          # 实体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │       ├── valueobj/        # 值对象&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │       ├── repository/      # 仓储接口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │       ├── service/         # 领域服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │       └── event/           # 领域事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── application/             # 应用层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │   └── user/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │       └── service/         # 应用服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── interfaces/              # 接口层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │   ├── kt_handler/          # Kitex处理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │   ├── adapter/             # 适配器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │   │   ├── assembler/       # 组装器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │   │   ├── converter/       # 转换器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │   │   └── middleware/      # 中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │   └── dto/                 # 数据传输对象&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │       ├── request/         # 请求DTO&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │       └── response/        # 响应DTO&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    └── infrastructure/          # 基础设施层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        ├── config/              # 配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        ├── persistence/         # 持久化&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        │   ├── mysql/           # MySQL仓储实现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        │   ├── po/              # 持久化对象&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        │   └── converter/       # PO-DO转换器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        └── ......               # 其他微服务组件&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;对项目结构有了一个大致的认知后，我们来看看当一个请求流入user-service各层次时的都发生了什么：&lt;/p&gt;

&lt;h3 id=&quot;article-interface层-1&quot;&gt;Interface层&lt;/h3&gt;
&lt;h4 id=&quot;article-kitex-handler-1&quot;&gt;kitex_handler&lt;/h4&gt;&lt;p&gt;这是服务的入口，通常是Kitex框架生成的处理器。它接收RPC请求，解析出参数，并进行最基本的参数校验（如非空、格式）。它的职责是“协议适配”，将网络请求转化为内部可理解的数据结构&lt;/p&gt;

&lt;h4 id=&quot;article-数据转换-dto-1&quot;&gt;数据转换（DTO）&lt;/h4&gt;&lt;p&gt;接口层定义DTO（数据传输对象），如CreateUserReq、UserResp。handler会调用Assembler或Converter，将外部请求的DTO转换为应用层所需的命令或查询对象（通常是一个简单的结构体），或者将应用层返回的领域对象转换为对外的Resp DTO。DTO是接口层与外部世界的契约&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//go-ddd-layout/interfaces/dto/user/user.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; user&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Userinfo&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Name         &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;   `json:&quot;name&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	EmpID        &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;      `json:&quot;emp_id&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Username     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;   `json:&quot;username&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Avatar       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;   `json:&quot;avatar&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Email        &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;   `json:&quot;email&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Organization &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;   `json:&quot;organization&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Company      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;   `json:&quot;company&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Region       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;   `json:&quot;region&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	City         &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;   `json:&quot;city&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Roles        []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;roles&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; User&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ID           &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `json:&quot;uid&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	UUID         &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;uuid,omitempty&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Name         &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;name&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	NickName     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;nickname&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	EmployeeID   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `json:&quot;employee_id,omitempty&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	EmployeeType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;employee_type,omitempty&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Company      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;company,omitempty&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	WorkCountry  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;work_country,omitempty&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	WorkCity     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;work_city,omitempty&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Department   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;department,omitempty&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Email        &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;email&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Avatar       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;avatar&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Username     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;username&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Password     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;password&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	IsActive     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;   `json:&quot;is_active&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	CreatedAt    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;ctime&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	UpdatedAt    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;utime&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; LoginPasswd&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Username &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;username&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Password &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;password&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-assembler-1&quot;&gt;assembler&lt;/h4&gt;&lt;p&gt;负责各类数据模型格式转换&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//go-ddd-layout/interfaces/assembler/user/user.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; user&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;server/domain/user/entity&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	dto &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;server/interfaces/dto/user&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DTOToEntity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;dto&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Name:         user.Name,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		NickName:     user.NickName,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		EmployeeID:   user.EmployeeID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		EmployeeType: user.EmployeeType,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Company:      user.Company,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		WorkCountry:  user.WorkCountry,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		WorkCity:     user.WorkCity,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Department:   user.Department,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Email:        user.Email,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Avatar:       user.Avatar,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Username:     user.Username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Password:     user.Password,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		IsActive:     user.IsActive,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; EntityToDTO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;dto&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;dto&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ID:           user.ID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		UUID:         user.UUID.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Name:         user.Name,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		NickName:     user.NickName,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		EmployeeID:   user.EmployeeID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		EmployeeType: user.EmployeeType,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Company:      user.Company,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		WorkCountry:  user.WorkCountry,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		WorkCity:     user.WorkCity,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Department:   user.Department,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Email:        user.Email,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Avatar:       user.Avatar,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Username:     user.Username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Password:     user.Password,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		IsActive:     user.IsActive,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		CreatedAt:    user.CreatedAt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Format&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(time.DateTime),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		UpdatedAt:    user.UpdatedAt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Format&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(time.DateTime),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ListEntityToDTO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;users&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;dto&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dtoUsers []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;dto&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; users {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		dtoUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; dto&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			ID:           user.ID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Name:         user.Name,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			NickName:     user.NickName,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			EmployeeID:   user.EmployeeID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			EmployeeType: user.EmployeeType,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Company:      user.Company,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			WorkCountry:  user.WorkCountry,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			WorkCity:     user.WorkCity,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Department:   user.Department,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Email:        user.Email,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Avatar:       user.Avatar,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Username:     user.Username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Password:     user.Password,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			IsActive:     user.IsActive,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			CreatedAt:    user.CreatedAt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Format&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(time.DateTime),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			UpdatedAt:    user.UpdatedAt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Format&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(time.DateTime),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		dtoUsers &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(dtoUsers, dtoUser)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dtoUsers&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-application层-1&quot;&gt;Application层&lt;/h3&gt;
&lt;h4 id=&quot;article-包装领域对象-编排领域服务-1&quot;&gt;包装领域对象&amp;amp;编排领域服务&lt;/h4&gt;&lt;p&gt;应用服务接收来自接口层的命令（如CreateUserCommand）。它首先会根据ID或条件，通过仓储接口获取已有的领域对象（聚合根）&lt;/p&gt;
&lt;p&gt;然后，它调用领域对象的行为方法（如user.ChangePassword(...)）或领域服务（如transferService.Transfer(...)）来执行业务操作。应用层负责事务边界，通常一个应用服务方法对应一个数据库事务。业务操作完成后，它通过仓储接口保存聚合根，并可能发布领域事件。最后，将结果（可能是保存后的聚合根，或一个自定义的响应）返回给接口层&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// application/service/user_app_service.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; service&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;myapp/domain&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;myapp/domain/event&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;myapp/domain/repository&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 定义命令和查询&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; RegisterUserCommand&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Username &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Email    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Password &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; GetUserQuery&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    UserID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UpdateUserCommand&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    UserID   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Username &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Email    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 应用服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserAppService&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    userRepo        &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;repository&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepository&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    unitOfWork      &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;repository&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UnitOfWork&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    eventPublisher  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;event&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Publisher&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    passwordHasher  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;domain&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PasswordHasher&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    emailService    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;domain&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EmailService&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewUserAppService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    userRepo&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; repository&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepository&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    unitOfWork&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; repository&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UnitOfWork&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    eventPublisher&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; event&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Publisher&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    passwordHasher&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; domain&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PasswordHasher&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    emailService&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; domain&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EmailService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserAppService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserAppService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        userRepo:        userRepo,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        unitOfWork:      unitOfWork,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        eventPublisher:  eventPublisher,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        passwordHasher:  passwordHasher,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        emailService:    emailService,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserAppService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cmd&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; RegisterUserCommand&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;domain&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 验证唯一性&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; existing, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.userRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByUsername&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, cmd.Username); existing &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username already exists&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; existing, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.userRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, cmd.Email); existing &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email already exists&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 开启事务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.unitOfWork.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Execute&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;domain&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 创建值对象&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        email, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; domain.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cmd.Email)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 创建聚合根&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        hashedPassword, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.passwordHasher.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Hash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cmd.Password)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        user, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; domain.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cmd.Username, email, hashedPassword)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 保存聚合根&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.userRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Save&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, user); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 发布领域事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        userCreatedEvent &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewUserCreatedEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user.ID, user.Username, user.Email)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.eventPublisher.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Publish&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, userCreatedEvent); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 记录日志，但不回滚事务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;failed to publish event: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 发送欢迎邮件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.emailService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SendWelcomeEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user.Email, user.Username); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;failed to send welcome email: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserAppService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;query&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; GetUserQuery&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;domain&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    user, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.userRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, query.UserID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user not found&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserAppService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UpdateUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cmd&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UpdateUserCommand&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.unitOfWork.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Execute&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 加载聚合根&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        user, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.userRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, cmd.UserID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user not found&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 更新用户&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cmd.Username &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ChangeUsername&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;cmd.Username); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cmd.Email &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            email, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; domain.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;cmd.Email)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 检查邮箱是否已被使用&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; existing, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.userRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, email); existing &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; existing.ID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user.ID {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email already in use&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ChangeEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(email); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 保存聚合根&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.userRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Save&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, user); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 发布事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        userUpdatedEvent &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewUserUpdatedEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user.ID, time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s.eventPublisher.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Publish&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, userUpdatedEvent)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-domain层-1&quot;&gt;Domain层&lt;/h3&gt;
&lt;h4 id=&quot;article-实体处理-1&quot;&gt;实体处理&lt;/h4&gt;&lt;p&gt;这里是业务逻辑的核心。实体（聚合根）的方法封装了状态变更的规则。例如，User.ChangePassword(oldPwd, newPwd)方法内部会验证原密码、校验新密码强度，然后才修改Password值对象。所有不变量和业务规则在此得到强制执行&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//domain/user/entity/user.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; entity&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user-service/internal/domain/user/valueobj&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user-service/internal/domain/user/event&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// User 用户实体（聚合根）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; User&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ID        &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Username  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Email     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;valueobj&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Email&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Password  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;valueobj&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Password&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Status    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserStatus&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	CreatedAt &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	UpdatedAt &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 存储未发布的事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	events []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;event&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DomainEvent&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserStatus&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;	UserStatusInactive&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserStatus&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; iota&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;	UserStatusActive&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;	UserStatusBanned&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// NewUser 创建新用户（工厂方法）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;username&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;email&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;valueobj&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;password&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;valueobj&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Password&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; username &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username cannot be empty&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; email &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email is required&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; password &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;password is required&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	now &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Username:  username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Email:     email,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Password:  password,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Status:    UserStatusInactive,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		CreatedAt: now,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		UpdatedAt: now,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		events:    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;event&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DomainEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 发布用户已创建事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user.events &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user.events, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;event&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserCreated&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		UserID:    user.ID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Username:  username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Email:     email.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		CreatedAt: now,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Activate 激活用户&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;u &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Activate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; u.Status &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; UserStatusActive {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user is already active&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	u.Status &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; UserStatusActive&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	u.UpdatedAt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 发布用户已激活事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	u.events &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(u.events, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;event&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserActivated&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		UserID:    u.ID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Timestamp: time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ChangeEmail 修改邮箱&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;u &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ChangeEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;newEmail&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;valueobj&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; newEmail &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;new email is required&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	oldEmail &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; u.Email.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	u.Email &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; newEmail&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	u.UpdatedAt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 发布邮箱修改事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	u.events &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(u.events, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;event&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EmailChanged&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		UserID:    u.ID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		OldEmail:  oldEmail,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		NewEmail:  newEmail.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Timestamp: time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ChangePassword 修改密码&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;u &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ChangePassword&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;oldPassword&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;newPassword&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;valueobj&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Password&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;u.Password.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Verify&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(oldPassword) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;old password is incorrect&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	u.Password &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; newPassword&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	u.UpdatedAt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// GetEvents 获取并清空未发布的事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;u &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetEvents&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;event&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DomainEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	events &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; u.events&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	u.events &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;event&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DomainEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; events&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-值对象-1&quot;&gt;值对象&lt;/h4&gt;&lt;p&gt;值对象通常是不可变的，且包含自验证逻辑。例如，Email值对象在创建时（通过工厂函数NewEmail）就确保地址格式有效。它们使代码更清晰、更安全&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//domain/user/valueobj/eamil.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; valueobj&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net/mail&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Email 邮箱值对象&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Email&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	address &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// NewEmail 创建邮箱值对象（包含验证）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;address&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; address &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email address cannot be empty&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 验证邮箱格式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; mail.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ParseAddress&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(address); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;invalid email address&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 转换为小写&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	address &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToLower&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(address))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{address: address}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// String 返回字符串表示&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e.address&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Equals 比较两个邮箱是否相等&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Equals&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;other&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; other &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e.address &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; other.address&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-领域事件-1&quot;&gt;领域事件&lt;/h4&gt;&lt;p&gt;实现聚合间通信、保持限界上下文松散耦合的核心机制。在实现上，核心在于事件内聚——实体自身在引发状态变更时创建并暂存事件，外部只需订阅关心的事件类型&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//domain/user/event/user_created.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; event&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/google/uuid&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// DomainEvent 领域事件接口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DomainEvent&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	EventID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	EventName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	AggregateID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	OccurredAt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	ToMap&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// UserCreated 用户已创建事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserCreated&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	eventID   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	userID    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	username  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	email     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	createdAt &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewUserCreated&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;userID&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;username&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;email&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserCreated&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserCreated&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		eventID:   uuid.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		userID:    userID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		username:  username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		email:     email,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		createdAt: time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserCreated&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EventID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e.eventID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserCreated&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EventName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;user.created&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserCreated&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AggregateID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e.userID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserCreated&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;OccurredAt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e.createdAt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserCreated&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ToMap&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;event_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:   e.eventID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;event_name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: e.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EventName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    e.userID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:   e.username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;email&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:      e.email,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;timestamp&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  e.createdAt,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-仓储接口-1&quot;&gt;仓储接口&lt;/h4&gt;&lt;p&gt;在领域层，只有接口定义，如type UserRepository interface { FindByID(id int) (*User, error); Save(user *User) error }。它明确了领域层“需要什么”，而不关心“如何实现”&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//go-ddd-layout/domain/user/repository/user.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; repository&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;server/domain/user/entity&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserRepository&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	UserRepositoryBase&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	UserRepositoryQuery&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserRepositoryBase&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	SaveUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	DeleteUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	UpdateUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	UpdatesUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	GetUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	GetUsers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() ([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserRepositoryQuery&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	FindByName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	FindByEmpID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;empId&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	FindByEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;email&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	FindByUsername&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;username&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	FindByUsernameAndPassword&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;username&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;password&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	UpdatePassword&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;password&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-infrastructure层-1&quot;&gt;Infrastructure层&lt;/h3&gt;
&lt;h4 id=&quot;article-数据转换-po-1&quot;&gt;数据转换（PO）&lt;/h4&gt;&lt;p&gt;当仓储实现（如MySQLUserRepository）从数据库获取数据后，需要将数据库的持久化对象转换为领域层的实体/聚合根。PO是纯粹的数据结构，与数据库表结构对应，不含业务逻辑&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//go-ddd-layout/infrastructure/persistence/user/po/user.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; po&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;server/domain/user/entity/valueobj&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/google/uuid&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gorm.io/gorm&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; User&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	gorm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Model&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	UUID         &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;uuid&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UUID&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `gorm:&quot;column:uuid;           type:varchar(36);   not null; index:idx_uuid; unique;     comment:&apos;Unique identifier&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Name         &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `gorm:&quot;column:name;           type:varchar(50);   not null; index:idx_name;             comment:&apos;English name&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	NickName     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `gorm:&quot;column:nickname;       type:varchar(50);   not null;                             comment:&apos;Chinese name&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	EmployeeID   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;       `gorm:&quot;column:employee_id;    type:int;                                                 comment:&apos;Employee ID&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	EmployeeType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `gorm:&quot;column:employee_type;  type:varchar(50);                                         comment:&apos;Employee type&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Company      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `gorm:&quot;column:company;        type:varchar(50);                                         comment:&apos;Company name&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	WorkCountry  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `gorm:&quot;column:work_country;   type:varchar(50);                                         comment:&apos;Work country&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	WorkCity     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `gorm:&quot;column:work_city;      type:varchar(50);                                         comment:&apos;Work city&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Department   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `gorm:&quot;column:department;     type:varchar(50);                                         comment:&apos;Department&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Email        &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `gorm:&quot;column:email;          type:varchar(50);   not null; index:idx_email; unique;    comment:&apos;Email address&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Avatar       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `gorm:&quot;column:avatar;         type:text;                                                comment:&apos;User avatar URL&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Username     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `gorm:&quot;column:username;       type:varchar(50);   index:idx_username; unique;           comment:&apos;System login username&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Password     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `gorm:&quot;column:password;       type:varchar(255);  index:idx_password;                   comment:&apos;Local system login password&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	IsActive     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;      `gorm:&quot;column:is_active;      type:boolean;       index:idx_is_active; default:1;       comment:&apos;Whether the user is active (0 for inactive, 1 for active)&apos;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Roles        []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Role&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `gorm:&quot;many2many:rbac_user_roles;&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;u &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TableName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;t_rbac_user&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// BeforeCreate - Pre Insert Hook.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;u &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BeforeCreate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;tx&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gorm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DB&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;err&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	u.IsActive &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	u.UUID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; uuid.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; role &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Role&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;role_name = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, valueobj.DefaultRoleName).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;First&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;role)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	u.Roles &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Role&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{role}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-数据持久化处理-1&quot;&gt;数据持久化处理&lt;/h4&gt;&lt;p&gt;仓储的具体实现位于此。它实现Domain层定义的接口，处理与数据库、缓存等的实际交互。它负责将领域对象的状态持久化到数据库（将实体转为PO再执行SQL），或从数据库重建领域对象。这里是所有技术细节（SQL、Redis命令、ORM等）的藏身之处&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//go-ddd-layout/infrastructure/persistence/user/user_repo.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; user&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;reflect&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;server/domain/user/entity&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;server/domain/user/entity/valueobj&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;server/domain/user/repository&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;server/infrastructure/common/random&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;server/infrastructure/persistence/user/converter&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;server/infrastructure/persistence/user/po&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gorm.io/gorm&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	db &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gorm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DB&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewUserRepository&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;db&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gorm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DB&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;repository&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepository&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{db: db}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ur &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SaveUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	poUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserEntityToPO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Create&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(poUser)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Error &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result.Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.RowsAffected &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;unable to save user&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	entityUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserPOToEntity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(poUser)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; entityUser, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ur &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DeleteUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tx &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Begin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 软删除用户&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Delete&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;po&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, id).Error; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Rollback&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 真删除关联关系表&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exec&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;DELETE FROM t_rbac_user_roles WHERE user_id = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, id).Error; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Rollback&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Commit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ur &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UpdateUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	poUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserEntityToPO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	userValue &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; reflect.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ValueOf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Elem&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userValue.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NumField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(); i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fieldName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userValue.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Type&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Field&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(i).Name&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fieldValue &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userValue.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Field&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(i)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fieldValue.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsZero&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;poUser).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;id = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, poUser.ID).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Update&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fieldName, fieldValue.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Error &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result.Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	entityUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserPOToEntity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(poUser)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; entityUser, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ur &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UpdatesUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	poUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserEntityToPO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(poUser).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;id = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, poUser.ID).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Updates&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;poUser)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Error &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result.Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.RowsAffected &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;unable to update user&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	entityUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserPOToEntity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(poUser)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; entityUser, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ur &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;po&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;First&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user, id)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Error &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result.Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	entityUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserPOToEntity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; entityUser, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ur &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetUsers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() ([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	users &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;po&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Find&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;users)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Error &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result.Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	entityUsers &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(users))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, u &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; users {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		entityUsers &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(entityUsers, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserPOToEntity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;u))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; entityUsers, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ur &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;po&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;name = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, name).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;First&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Error &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result.Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	entityUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserPOToEntity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; entityUser, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ur &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByEmpID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;empId&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;po&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;employee_id = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, empId).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;First&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Error &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result.Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	entityUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserPOToEntity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; entityUser, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ur &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;email&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;po&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, email).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;First&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Error &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result.Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	entityUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserPOToEntity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; entityUser, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ur &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByUsername&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;username&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;po&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// manytomany 需要 preload 预加载才可以拿到关联表信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Preload&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Roles&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, username).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;First&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Error &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result.Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	entityUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserPOToEntity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; entityUser, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ur &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByUsernameAndPassword&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;username&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;password&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;entity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;po&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Preload&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Roles&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username = ? AND password = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, username, password).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;First&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Error &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result.Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	entityUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; converter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserPOToEntity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; entityUser, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ur &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepositoryImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UpdatePassword&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;password&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; newPassword &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(password) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		newPassword &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; random.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GeneratePassword&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(valueobj.PasswordDigits)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	} &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		newPassword &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; password[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;po&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;First&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user, id).Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user.Password &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; newPassword&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ur.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Save&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user).Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; newPassword, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-后记-1&quot;&gt;后记&lt;/h2&gt;&lt;p&gt;DDD不是银弹，它引入了显著的复杂度。对于业务简单、生命周期短的项目，传统的三层或清洁架构可能是更经济的选择。然而，当面对核心业务逻辑复杂、需要长期演进且团队规模较大的系统时，DDD提供的统一语言、清晰的边界和以领域为核心的设计思想，能极大地提升软件的可理解性、可测试性和可维护性&lt;/p&gt;
&lt;p&gt;在Go中实践DDD，需要克服语言本身在面向对象特性上的“简洁”风格，更多地通过接口、组合和包组织来体现架构约束。这既是一种挑战，也是深入理解软件设计本质的绝佳途径&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;所以如果让我用DDD架构写项目，大概会因心力交瘁而亡吧&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2 id=&quot;article-参考资料-1&quot;&gt;参考资料&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/7298160530292703244&quot;&gt;Go 的 DDD 工程化项目实践&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://segmentfault.com/a/1190000046562541&quot;&gt;深入浅出DDD：从理论到落地的关键&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://github.com/pokeyaro/go-ddd-layout&quot;&gt;go-ddd-layout&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/2016926013846732883&quot;&gt;架构演进之 DDD：从 CRUD 到领域驱动设计&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://developer.cloud.tencent.com/article/2638826&quot;&gt;领域驱动设计 DDD（Domain-Driven Design）软件架构学习笔记&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-DDD/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>微服务</category><category>分布式</category><category>架构设计</category></item><item><title>数据一致性：分布式事务的实现</title><link>https://www.claran-blog.work/posts/go-DataConsistency/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-DataConsistency/</guid><description>如何在分布式架构中确保数据一致性与分布式事务使用的讲解.</description><pubDate>Tue, 24 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-引言-1&quot;&gt;引言&lt;/h2&gt;&lt;p&gt;我们继续学习微服务架构中极其重要的一个环节-分布式事务。在单体式架构中，保证数据库读写ACID原则的情况下，我们往往不需要对数据的强一致性过多担心。但是在分布式架构中，不同服务节点对数据库的并发访问就很可能会带来新的一致性问题，例如两个用户在同一瞬间完成下单操作，服务器同事处理这两个请求，不足库存就会超卖。分布式事务作为微服务体系中的重要内容，可以保障不同服务或不同服务节点之间难以保证的数据一致性&lt;/p&gt;

&lt;h2 id=&quot;article-数据一致性-1&quot;&gt;数据一致性&lt;/h2&gt;&lt;p&gt;数据一致性是分布式事务中最重要的核心理念，它表示&lt;strong&gt;在分布式系统的多个节点或服务中，数据副本之间保持统一和正确的状态，使得用户或程序在任何时刻、从任何节点读取数据时，都能获得符合预期的、逻辑上正确的结果&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;数据一致性并不是所谓非黑即白的“一致”或“不一致”，而是可以根据不同实际情况不同划分结果，是一个从绝对严格到非常宽松的谱系。我们根据这个谱系，可以将数据一致性划从严格到宽松分为三个级别：“强一致性”、“顺序一致性”和“最终一致性”&lt;/p&gt;
&lt;p&gt;在深入了解数据一致性之前，我们先讲解一些必备的知识概念&lt;/p&gt;

&lt;h3 id=&quot;article-分布式理论-1&quot;&gt;分布式理论&lt;/h3&gt;
&lt;h4 id=&quot;article-cap理论-1&quot;&gt;CAP理论&lt;/h4&gt;&lt;p&gt;CAP定理指出，在一个可能发生网络分区的分布式系统中，无法同时完美满足以下三点：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Consistency (一致性)：强调数据的正确性，要求各节点提供的数据都是一致准确的&lt;/li&gt;
&lt;li&gt;Availability (可用性)：要求系统的可用性高，每个请求都能得到响应（不保证是最新数据）&lt;/li&gt;
&lt;li&gt;Partition Tolerance (分区容错性)：系统在部分网络节点失联（分区）时，要求系统仍然能够正常运作&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;对于分布式系统而言，网络分区（P）是必然存在的，因此，我们只能在一致性（C）和可用性（A）之间二选一&lt;/p&gt;
&lt;p&gt;而这种一致性（C）和可用性（A）之间的二选一，产生了两种主要的系统类型：CP和AP&lt;/p&gt;
&lt;p&gt;CP系统选择&lt;strong&gt;放弃部分可用性以保证一致性&lt;/strong&gt;，当网络分区发生时，系统会锁定数据或返回错误，直到分区恢复、数据达成一致，以保证数据绝对正确&lt;/p&gt;
&lt;p&gt;AP系统选择&lt;strong&gt;放弃强一致性以保证更高可用性&lt;/strong&gt;，当网络分区发生时，系统允许继续读写，但不同分区间的数据可能暂时不一致&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;一般而言，一致性的实现更加复杂，可用性的实现更加简便&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;需要特别说明的是，一个系统并不是一定需要极端CP或极端AP，更多时候是依据具体的业务情况来决定倾向于一致性还是可用性。例如对于用户的个人信息或帖子的统计数据，我们不需要对这些信息立即更新或者实时响应，就可以舍弃部分一致性，以简化业务代码，提升可用性。对于用户转账之类的业务，我们就需要保证数据的强一致性，舍弃部分可用性，为用户返回“正在更新信息，请稍候”之类的讯息&lt;/p&gt;
&lt;p&gt;由此可见，我们之前所说的“强一致性”或“最终一致性”系统就是更加偏向于CP或者AP的系统&lt;/p&gt;

&lt;h4 id=&quot;article-base理论-1&quot;&gt;BASE理论&lt;/h4&gt;&lt;p&gt;由上述理论我们可以知道，CP系统的实现相对复杂，因此对于非严格业务（如统计信息、边缘业务等），我们主要使用AP模式模型，而BASE理论则提供了在AP道路上如何尽可能好地走下去的具体方法论，是对强一致性模型的补充和妥协&lt;/p&gt;
&lt;p&gt;BASE理论的核心思想是：&lt;strong&gt;既然无法做到强一致，就用一种更柔和、更具弹性的方式，通过接受暂时的、可控的不一致，来换取系统整体的高可用和可扩展性&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;BASE全称 Basically Available, Soft state, Eventually consistent(基本可用、软状态、最终一致性)&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;BA（基本可用）：系统在出现故障时，允许损失部分非核心功能的可用性，但核心功能必须保持可用&lt;/p&gt;
&lt;p&gt;  如降级、熔断、限流：双十一期间，关闭商品评价功能，确保下单、支付核心链路畅通&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;S（软状态）：允许系统中的数据存在中间状态，并且该状态不会影响系统整体可用性&lt;/p&gt;
&lt;p&gt;  数据副本在不同节点间同步存在延迟，这个“不一致的窗口期”就是软状态。比如主数据库写入成功，从数据库还未同步完成&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;E - 最终一致性：经过一段时间的同步后，所有数据副本最终会达到一致的状态&lt;/p&gt;
&lt;p&gt;  这是BASE的最终目标。系统保证，只要没有新的更新，最终所有读取都会返回最新的值&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-分布式id-1&quot;&gt;分布式ID&lt;/h3&gt;&lt;p&gt;分布式ID是在分布式系统环境下，&lt;strong&gt;用于唯一标识一条数据、一个请求或一个实体的全局唯一标识符&lt;/strong&gt;，是构建分布式系统的基石之一&lt;/p&gt;

&lt;h4 id=&quot;article-我们为什么需要分布式id-1&quot;&gt;我们为什么需要分布式ID？&lt;/h4&gt;&lt;p&gt;在单机数据库时代，使用数据库的自增字段（AUTO_INCREMENT）就足够了。但在分布式系统中，这会导致一些严重问题：&lt;/p&gt;
&lt;p&gt;当所有插入都依赖一个数据库的自增序列，数据库可能会成为单点性能瓶颈；分库分表时，不同数据库节点会产生重复ID；连续的自增ID会暴露业务量（如订单数），容易被爬取&lt;/p&gt;
&lt;p&gt;因此，分布式ID可以在全局方位作唯一的ID标识，并满足以下核心要求：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;全局唯一：作为基本要求，整个系统不出现重复ID&lt;/li&gt;
&lt;li&gt;趋势递增：可用作数据库索引（例如数据库主键）&lt;/li&gt;
&lt;li&gt;高可用：ID生成服务必须高度可靠&lt;/li&gt;
&lt;li&gt;高并发：能应对海量请求&lt;/li&gt;
&lt;li&gt;安全：ID本身无敏感信息，无序或难以猜测&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;分布式ID是在分布式系统环境下，用于唯一标识一条数据、一个请求或一个实体的全局唯一标识符。它是构建分布式系统的基石之一。&lt;/p&gt;
&lt;p&gt;常见的分布式ID生成方案如下，其中以雪花算法（Snowflake）最为广泛应用:&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;方案&lt;/th&gt;
&lt;th&gt;原理&lt;/th&gt;
&lt;th&gt;优点&lt;/th&gt;
&lt;th&gt;缺点&lt;/th&gt;
&lt;th&gt;典型代表&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;UUID&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;基于随机数、时间、MAC地址等生成128位字符串。&lt;/td&gt;
&lt;td&gt;1. 本地生成，性能极高。&lt;br /&gt;2. 全球唯一性概率极高。&lt;/td&gt;
&lt;td&gt;1. 字符串存储，占用空间大。&lt;br /&gt;2. &lt;strong&gt;无序&lt;/strong&gt;，作为主键插入数据库时性能差。&lt;br /&gt;3. 无业务含义。&lt;/td&gt;
&lt;td&gt;&lt;code&gt;UUID.randomUUID()&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;数据库自增&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;单独一个数据库实例，利用其自增机制生成ID。&lt;/td&gt;
&lt;td&gt;1. 实现简单。&lt;br /&gt;2. ID绝对有序递增。&lt;/td&gt;
&lt;td&gt;1. &lt;strong&gt;数据库单点，有性能瓶颈和故障风险&lt;/strong&gt;。&lt;br /&gt;2. 扩展性差。&lt;/td&gt;
&lt;td&gt;单独一个MySQL表&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Redis生成&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;利用Redis的 &lt;code&gt;INCR&lt;/code&gt; 或 &lt;code&gt;INCRBY&lt;/code&gt; 原子命令生成序列。&lt;/td&gt;
&lt;td&gt;1. 性能优于数据库。&lt;br /&gt;2. 数字ID，有序。&lt;/td&gt;
&lt;td&gt;1. 需引入和运维Redis。&lt;br /&gt;2. 存在数据持久化问题（宕机可能丢失序列）。&lt;/td&gt;
&lt;td&gt;Redis &lt;code&gt;INCR&lt;/code&gt; 命令&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;雪花算法&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;最流行的方案&lt;/strong&gt;。将一个64位Long型ID按位划分，包含时间戳、工作机器ID、序列号。&lt;/td&gt;
&lt;td&gt;1. &lt;strong&gt;本地生成，性能超高&lt;/strong&gt;。&lt;br /&gt;2. 趋势递增，对数据库友好。&lt;br /&gt;3. 可包含时间信息。&lt;/td&gt;
&lt;td&gt;1. &lt;strong&gt;依赖系统时钟&lt;/strong&gt;，如果时钟回拨会导致ID重复。&lt;br /&gt;2. 需要分配和管理机器ID。&lt;/td&gt;
&lt;td&gt;Twitter Snowflake, 百度UidGenerator&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;号段模式&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;从数据库批量获取一个号段（如1~1000）缓存在本地，用完后再次获取。&lt;/td&gt;
&lt;td&gt;1. 数据库压力小（批量获取）。&lt;br /&gt;2. 本地生成，性能好。&lt;/td&gt;
&lt;td&gt;1. 服务重启可能浪费号段。&lt;br /&gt;2. ID不是严格连续，是趋势递增。&lt;/td&gt;
&lt;td&gt;美团Leaf（Segment模式）&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h4 id=&quot;article-雪花算法-1&quot;&gt;雪花算法&lt;/h4&gt;&lt;p&gt;雪花算法基于时间戳生成分布式ID：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/dataC1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;第1位：符号位，固定为0（表示正数）&lt;/li&gt;
&lt;li&gt;接下来41位：时间戳（毫秒级），可用约69年&lt;/li&gt;
&lt;li&gt;接下来10位：工作机器ID，其中5位是数据中心ID，5位是机器ID，可部署1024个节点&lt;/li&gt;
&lt;li&gt;最后12位：序列号，同一毫秒内产生的自增序列，支持每节点每毫秒生成4096个ID&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;生成过程：在同一毫秒内，如果请求并发量超过4096，会等待下一毫秒。这保证了ID在单节点上是严格递增的，全局是趋势递增的&lt;/p&gt;
&lt;p&gt;但是即便如此，雪花算法还是面临一些问题，例如时间回拨问题：时间被调整回到了之前的时间。由于雪花算法重度依赖机器的当前时间，所以一旦发生时间回拨，将有可能导致生成的 ID 可能与此前已经生成的某个 ID 重复（前提是刚好在同一毫秒生成 ID 时序列号也刚好一致），这就是雪花算法最经常讨论的时间回拨问题&lt;/p&gt;
&lt;p&gt;不过，我们依然可以用基于时钟序列的方法解决时间回拨问题，详细细节参考此篇文章：&lt;a href=&quot;https://www.cnblogs.com/shoshana-kong/p/17319231.html&quot;&gt;雪花算法的详解及时间回拨解决方案&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;在实际项目中，我们可以直接使用成熟的开源实现（如美团的Leaf、百度的UidGenerator），它们已经解决了时钟回拨、机器ID分配等问题&lt;/p&gt;

&lt;h3 id=&quot;article-分布式锁-1&quot;&gt;分布式锁&lt;/h3&gt;&lt;p&gt;其实我们早已在之前的单体式项目实践中接触过分布式锁，不过我们只是单纯以redis的setnx作简单的分布式锁实现，这里我们会更拓展一点&lt;/p&gt;
&lt;p&gt;在分布式系统中，不同服务运行在不同机器上，我们需要一个跨进程的全局分布式锁，用于协调多个进程/服务对共享资源进行互斥访问的机制&lt;/p&gt;
&lt;p&gt;分布式锁是分布式系统中，&lt;strong&gt;用于协调多个进程/服务对共享资源进行互斥访问&lt;/strong&gt;的机制。在单机系统中，你可以用线程锁（如Go的&lt;code&gt;sync.Mutex&lt;/code&gt;）保证同一时刻只有一个线程访问资源。但在分布式系统中，不同服务运行在不同机器上，就需要一个跨进程的全局锁。&lt;/p&gt;
&lt;p&gt;主流的分布式锁实现方案如下&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;方案&lt;/th&gt;
&lt;th&gt;核心原理&lt;/th&gt;
&lt;th&gt;优点&lt;/th&gt;
&lt;th&gt;缺点&lt;/th&gt;
&lt;th&gt;适用场景&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;基于数据库&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;利用唯一约束或乐观锁版本号实现。&lt;/td&gt;
&lt;td&gt;实现简单，无需引入新组件。&lt;/td&gt;
&lt;td&gt;性能差，数据库压力大；连接数有限；锁释放需处理。&lt;/td&gt;
&lt;td&gt;并发量低，已有数据库的场景。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;基于Redis&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;使用&lt;code&gt;SET key value NX PX timeout&lt;/code&gt;命令实现。&lt;/td&gt;
&lt;td&gt;性能极高，实现相对简单。&lt;/td&gt;
&lt;td&gt;主从切换时可能锁失效（Redlock算法可缓解）。&lt;/td&gt;
&lt;td&gt;高并发，可容忍极低概率锁失效的场景。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;基于ZooKeeper&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;创建临时顺序节点，最小节点获得锁。&lt;/td&gt;
&lt;td&gt;可靠性高，无锁失效问题；原生支持公平锁。&lt;/td&gt;
&lt;td&gt;性能较Redis低；需要维护ZK集群。&lt;/td&gt;
&lt;td&gt;对可靠性要求极高，如金融交易。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;基于etcd&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;基于租约创建Key，利用Revision机制。&lt;/td&gt;
&lt;td&gt;强一致，高可靠；支持公平锁。&lt;/td&gt;
&lt;td&gt;相比Redis性能略低。&lt;/td&gt;
&lt;td&gt;Kubernetes生态，对一致性要求高的场景。&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;接下来我们着重对Redis分布式锁和ETCD分布式锁进行详解&lt;/p&gt;

&lt;h4 id=&quot;article-redis分布式锁-1&quot;&gt;Redis分布式锁&lt;/h4&gt;&lt;p&gt;在我们之前的单体式项目中已经使用过，通过redis的setnx(set if not exist)命令实现分布式锁，我们在此基础上进阶讲解分布式系统中使用分布式锁会遇到的诸多问题的解决方案&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;Redis分布式锁是AP倾向的&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h5 id=&quot;article-死锁-1&quot;&gt;死锁&lt;/h5&gt;&lt;p&gt;如果一个程序获取到了分布式锁，但是在执行业务代码，还没来得及释放锁时这个程序就挂掉了，这个分布式锁就会一致锁住，造成死锁&lt;/p&gt;
&lt;p&gt;我们可以在获取锁时为锁添加一个过期时间，来避免死锁的发生。需要注意的是，这个过程必须是原子操作（或用lua实现），否则在没来得及设置过期时间时挂掉也会造成死锁&lt;/p&gt;

&lt;h5 id=&quot;article-锁续期-watchdog机制-1&quot;&gt;锁续期（WatchDog机制）&lt;/h5&gt;&lt;p&gt;如果一个程序业务执行时间超过了锁的过期时间，在业务还没来得及执行完锁就被释放了，会导致其他进程获取这个锁，导致多线程并发访问数据造成数据不一致。因此我们通常使用WatchDog续期机制为未执行完业务的程序的锁续约：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    setnx key1 val1 ex {exTime}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; holdingLock {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 每10秒续期一次&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 使用Lua脚本，只有还是自己的锁才续期&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			redis.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Eval&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;if redis.call(&apos;get&apos;, KEYS[1]) == ARGV[1] then &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				&quot;return redis.call(&apos;pexpire&apos;, KEYS[1], ARGV[2]) &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				&quot;else return 0 end&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				[]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{lockKey}, clientID, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;30000&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;同理，如果在释放锁时锁就已经过期了，就会导致释放新拿到锁的线程的锁。因此，我们可以在释放锁前判断是否时自己加的锁&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getKey&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; myVal{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    del key&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-redis集群-1&quot;&gt;Redis集群&lt;/h5&gt;&lt;p&gt;在此之前我们可能只部署了单节点Redis，这样做会导致低可用性，如果这个单节点Redis挂了，那么整个缓存层就全挂了，导致数据库压力激增造成业务熔断。因此我们在分布式架构中多部署redis集群，实现多个redis节点的部署（通常为3主3从）&lt;/p&gt;
&lt;p&gt;Redis集群由16384个哈希槽组成，槽位分配给集群中的主节点，例如在3主集群中，节点1占槽 0-5460，节点2占槽 5461-10922，节点3占槽 10923-16383，每个键通过 CRC16 算法计算后对 16384 取模，得到槽位。每个新键值对都会进行这样的运算并被分配给相应槽位的集群节点进行缓存存储&lt;/p&gt;
&lt;p&gt;每个Redis集群都有多个Redis节点，每个Redis节点也会有不同节点身份，通常为Master（主节点）和Slave（从节点）两个节点身份。Master节点负责处理其负责槽的所有读写命令，并参与集群管理（故障检测、投票）；Slave节点作为主节点的完整副本，通过异步复制同步主节点数据，可以在主节点故障时，通过选举接替其成为新的主节点，并接管对应的槽。 一个主节点可以有多个从节点，实现读写分离和更高等级的可靠性&lt;/p&gt;
&lt;p&gt;集群没有中心化的管理节点。所有节点通过 Gossip 协议彼此互联，定期交换以下信息：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;MEET/PING/PONG 消息：用于节点发现、心跳检测和元数据传播。每个节点每秒会随机选择几个节点发送 PING，并交换集群状态&lt;/li&gt;
&lt;li&gt;FAIL 消息：当某个节点判定另一个节点下线时，会向整个集群广播 FAIL 消息，触发故障转移流程&lt;/li&gt;
&lt;li&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这种去中心化设计避免了单点故障，但意味着集群状态变更的传播有轻微延迟&lt;/p&gt;
&lt;p&gt;客户端与集群交互的关键是&lt;strong&gt;请求路由机制&lt;/strong&gt;。当客户端命中正确节点，客户端（如 go-redis）在启动时就会拉取一份“槽位-节点映射表”并缓存。当要操作 Key 时，它本地计算槽位，并直接连接负责该槽位的节点，让请求被直接处理。&lt;br /&gt;而当客户端连接了错误节点或迁移中的槽位，可能返回两类错误：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;MOVED 错误：如果槽位已永久迁移到另一个节点，当前节点会返回 &lt;code&gt;-MOVED &amp;lt;slot&amp;gt; &amp;lt;target-node-ip:port&amp;gt;&lt;/code&gt;错误。智能客户端会更新本地映射表，然后重试请求到新节点&lt;/li&gt;
&lt;li&gt;ASK 错误：发生在槽位迁移过程中。当前节点可能有一部分Key已迁走，一部分还在。如果请求的Key已迁走，它会返回 &lt;code&gt;-ASK &amp;lt;slot&amp;gt; &amp;lt;target-node-ip:port&amp;gt;&lt;/code&gt;错误，这是一个临时重定向。客户端需要向新节点发送一个 ASKING命令，然后才能执行原命令。这确保了迁移期间的可用性&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Redis集群由完全自动化的故障检测与自动故障转移机制：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;主观下线：节点 A 在 &lt;code&gt;cluster-node-timeout&lt;/code&gt;内未收到节点 B 的 PONG 响应，则节点 A 将节点 B 标记为 PFAIL（疑似下线）&lt;/li&gt;
&lt;li&gt;客观下线：节点 A 通过 Gossip 协议发现集群中大多数主节点都认为节点 B 处于 PFAIL状态。此时，节点 A 会向集群广播一个 FAIL消息，正式将节点 B 标记为客观下线&lt;/li&gt;
&lt;li&gt;从节点选举：&lt;ul&gt;
&lt;li&gt;当主节点 B 被标记为客观下线后，其下属的从节点会发起选举&lt;/li&gt;
&lt;li&gt;从节点会延迟一段时间（与复制偏移量有关，数据越新的延迟越小）后发起投票请求&lt;/li&gt;
&lt;li&gt;其他存活的主节点进行投票，获得多数票的从节点获胜&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;故障转移：获胜的从节点执行 &lt;code&gt;SLAVEOF no one&lt;/code&gt;升级为主节点，并通过广播通知集群，接管原主节点负责的所有哈希槽&lt;/li&gt;
&lt;/ol&gt;
&lt;blockquote&gt;
&lt;p&gt;需要注意的是，Redis集群不支持多键操作：涉及多个Key的命令（如 MGET, MSET, SINTER）要求所有Key必须位于同一个节点。需用 {}哈希标签强制它们落入同一槽，如：&lt;code&gt;MSET user:{1000}:name “Alice” user:{1000}:age 30&lt;/code&gt;。同样的，事务和脚本中所有操作的Key也必须属于同一个槽&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;我们可以使用官方的github.com/go-redsync/redsync/v4包实现redis集群的链接和使用：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/go-redsync/redsync/v4&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建多个 Redis 连接池&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    pools &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;redsync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Pool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        redis.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(redisClient1),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        redis.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(redisClient2),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        redis.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(redisClient3),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        redis.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(redisClient4),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        redis.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(redisClient5),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建 RedLock 实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    rs &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; redsync.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(pools)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 获取锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mutex &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rs.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewMutex&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;resource-name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        redsync.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithExpiry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.Second),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        redsync.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithTries&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 重试次数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; mutex.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 处理错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 执行业务操作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; mutex.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-redlock算法-1&quot;&gt;RedLock算法&lt;/h5&gt;
&lt;h6 id=&quot;article-为什么需要redlock算法-1&quot;&gt;为什么需要RedLock算法？&lt;/h6&gt;&lt;p&gt;在单个集群的主从架构中，可能存在以下问题：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;客户端 A 在主节点 M1 上成功获取锁&lt;/li&gt;
&lt;li&gt;Master节点 M1 在将锁信息同步到从节点 S1 之前崩溃&lt;/li&gt;
&lt;li&gt;Slave节点 S1 被提升为新的主节点&lt;/li&gt;
&lt;li&gt;此时新的主节点上没有锁信息&lt;/li&gt;
&lt;li&gt;客户端 B 向新的主节点请求同一把锁，成功获取&lt;/li&gt;
&lt;li&gt;结果：A 和 B 同时持有同一把锁 → 锁失效&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;这就是 RedLock 要解决的核心问题：防止因 Redis 主从切换导致的锁意外失效&lt;/p&gt;

&lt;h6 id=&quot;article-算法详解-1&quot;&gt;算法详解&lt;/h6&gt;&lt;p&gt;RedLock使用多个（奇数个）不同的独立Redis实例（如不同的Redis集群的Master节点），所有实例都是独立的不进行数据同步&lt;/p&gt;
&lt;p&gt;算法基本流程如下：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;获取锁&lt;/strong&gt;：&lt;ul&gt;
&lt;li&gt;当客户端尝试获取锁时，向集群中的多个 Redis 实例发送锁请求&lt;/li&gt;
&lt;li&gt;每个请求包含一个唯一的锁标识符（例如，UUID）和一个过期时间&lt;/li&gt;
&lt;li&gt;客户端尝试在所有实例上几乎同时获取锁&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;锁获取规则&lt;/strong&gt;：&lt;ul&gt;
&lt;li&gt;如果客户端在大多数（比如，N/2 + 1，其中 N 是总的实例数）的 Redis 实例上成功设置了锁，并且获取锁的总耗时小于锁的有效期，那么被认为成功获取了锁&lt;/li&gt;
&lt;li&gt;如果客户端未能在大多数实例上获得锁，立即从那些设置了锁的实例上释放（删除）锁&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;锁的释放&lt;/strong&gt;：&lt;ul&gt;
&lt;li&gt;当锁的持有者完成其任务后，向所有实例发送解锁命令，释放锁&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;时间和时钟漂移&lt;/strong&gt;：&lt;ul&gt;
&lt;li&gt;重要的是要确保所有 Redis 实例的时钟尽可能同步&lt;/li&gt;
&lt;li&gt;客户端应该考虑网络延迟和小的时钟漂移&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;h6 id=&quot;article-原理简介-1&quot;&gt;原理简介&lt;/h6&gt;&lt;ol&gt;
&lt;li&gt;&lt;p&gt;多数决&lt;/p&gt;
&lt;p&gt; 假设有 N 个实例，最多允许 f 个实例故障：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;正确性要求：不能有两个客户端同时获得多数锁 &lt;/li&gt;
&lt;li&gt;可用性要求：即使有 f 个实例故障，客户端仍可能获得锁&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt; 因为客户端需要获得至少 ⌈N/2⌉ + 1 个锁才能获取锁，而由于&lt;code&gt;2 × (⌈N/2⌉ + 1) &amp;gt; N&lt;/code&gt;，所有两个客户端不可能同时满足这个条件&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;有效期&lt;/p&gt;
&lt;p&gt;实际有效时间 = 初始TTL - 获取锁总耗时&lt;/p&gt;
&lt;p&gt;确保客户端在获得锁时，所有实例上的锁都还有剩余时间&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;h5 id=&quot;article-轮子-1&quot;&gt;轮子&lt;/h5&gt;&lt;p&gt;&lt;code&gt;&quot;github.com/bsm/redislock&quot;&lt;/code&gt;提供了专门的Redis集群分布式锁包与相关API&lt;/p&gt;

&lt;h4 id=&quot;article-etcd分布式锁-1&quot;&gt;ETCD分布式锁&lt;/h4&gt;&lt;p&gt;我们之前学习注册中心的时候就接触过etcd，一个键值对存储系统，有着独特的租约（lease）机制&lt;/p&gt;
&lt;p&gt;etcd 分布式锁是基于 etcd 的强一致性特性实现的分布式锁机制。与 Redis 的 AP 倾向不同，etcd 是 CP 系统（优先保证一致性和分区容错性），使用 Raft 共识算法，所有写操作必须经过多数节点确认才成功&lt;/p&gt;
&lt;p&gt;并且，etcd由独特的Revision 机制：etcd 中每个键都有全局单调递增的&lt;code&gt; Revision&lt;/code&gt; ，锁竞争时，所有客户端可以按照 &lt;code&gt;Revision&lt;/code&gt; 顺序获得锁，实现完全公平的 FIFO 队列&lt;/p&gt;
&lt;p&gt;我们知道有个概念叫做惊群效应：倘若一把分布式锁的竞争比较激烈，那么锁的释放事件可能同时被多个的取锁方所监听，一旦锁真的被释放了，所有的取锁方都会一拥而上尝试取锁&lt;/p&gt;
&lt;p&gt;得益于etcd的Revision机制，对于同一把分布式锁，锁记录数据的 &lt;code&gt;key&lt;/code&gt; 拥有共同的前缀 &lt;code&gt;prefix&lt;/code&gt;，作为锁的标识，&lt;br /&gt;每个取锁方取锁时，会以锁前缀 &lt;code&gt;prefix&lt;/code&gt; 拼接上自身的身份标识（租约 id），生成完整的 &lt;code&gt;lock key&lt;/code&gt;. 因此各取锁方完整的 &lt;code&gt;lock key&lt;/code&gt; 都是互不相同的（只是有着相同的前缀），理论上所有取锁方都能成功把锁记录数据插入到 etcd 中。&lt;br /&gt;每个取锁方插入锁记录数据时，会获得自身 &lt;code&gt;lock key&lt;/code&gt; 处在锁前缀 &lt;code&gt;prefix&lt;/code&gt; 范围下唯一且递增的版本号&lt;code&gt; revision&lt;/code&gt;。&lt;br /&gt;取锁方插入加锁记录数据不意味着加锁成功，而是需要在插入数据后查询一次锁前缀 &lt;code&gt;prefix&lt;/code&gt; 下的记录列表，判定自身 &lt;code&gt;lock key&lt;/code&gt; 对应的 &lt;code&gt;revision&lt;/code&gt; 是不是其中最小的，如果是的话，才表示加锁成功。&lt;br /&gt;如果锁被他人占用，取锁方会 &lt;code&gt;watch&lt;/code&gt; 监听 &lt;code&gt;revision&lt;/code&gt; 小于自己但最接近自己的那个 &lt;code&gt;lock key&lt;/code&gt; 的删除事件。&lt;/p&gt;
&lt;p&gt;这样所有的取锁方就会在 &lt;code&gt;revision&lt;/code&gt; 机制的协调下，根据取锁序号&lt;code&gt;revision&lt;/code&gt;的先后顺序排成一条队列，每当锁被释放，只会惊动到下一顺位的取锁方，惊群问题得以避免.&lt;/p&gt;
&lt;p&gt;而etcd分布式锁的实现如下所示：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;1. 客户端创建会话(Session)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;   ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;2. 会话绑定租约(Lease)，设置TTL&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;   ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;3. 发起事务(Txn)尝试创建锁键&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;   ├─ 成功: 获得锁，启动租约自动续期&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;   └─ 失败: 监听前一个Revision的删除事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        等待并重试(公平排队)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;   ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;4. 执行业务逻辑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;   ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;5. 释放锁(删除键)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;   ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;6. 关闭租约，释放资源&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;我们可以使用官方的clientv3/concurrency包快速使用etcd分布式锁的功能：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go.etcd.io/etcd/client/v3&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go.etcd.io/etcd/client/v3/concurrency&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 连接 etcd&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    cli, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; clientv3.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;clientv3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Endpoints:   []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;localhost:2379&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        DialTimeout: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建会话（自动绑定租约）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    session, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; concurrency.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewSession&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cli, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        concurrency.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithTTL&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 10秒TTL&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建互斥锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mutex &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; concurrency.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewMutex&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(session, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/my-lock/&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 获取锁（阻塞直到成功）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ctx, cancel &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithTimeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;30&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; cancel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; mutex.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 处理错误（超时或其他）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 执行业务操作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获得锁，执行业务逻辑&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 释放锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; mutex.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 重入锁（同一客户端可多次加锁）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; reentrantExample&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;session&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;concurrency&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Session&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mutex &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; concurrency.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewMutex&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(session, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/reentrant-lock&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 第一次加锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mutex.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 同一 goroutine 可以再次调用（实际不会阻塞）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    doWorkWithLock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(mutex)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mutex.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 读写锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; rwLockExample&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;session&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;concurrency&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Session&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建读写锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    rwlock &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; concurrency.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewRWMutex&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(session, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/rw-lock&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 读锁（共享）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rwlock.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RLock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 多个客户端可同时持有读锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 写锁（独占）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rwlock.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 等待所有读锁释放&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;我们也可以进一步使用etcd的watch机制，实现类似于watch dog的死锁解决方案&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3 id=&quot;article-分布式事务-1&quot;&gt;分布式事务&lt;/h3&gt;&lt;p&gt;我们都知道，在单体式架构中，事物用于保证数据库操作的原子性。而在分布式架构中，分布式事务就是用来保证&lt;strong&gt;别位于不同的分布式系统节点上的事务的参与者、支持事务的服务器、资源服务器以及事务管理器这些节点上的操作要么全部成功，要么全部失败&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;同时，在分布式系统下，传统的ACID（原子性，一致性，隔离性，持久性）面临巨大挑战：原子性不能保证多个独立系统如何保证&quot;全成功或全失败&quot;，一致性不能保证多个数据源如何保持逻辑一致，隔离性的跨服务并发控制极其复杂，持久性的日志不能保证全部节点全部成功&lt;/p&gt;
&lt;p&gt;本质上来说，分布式事务就是为了保证在分布式场景下，数据操作的正确执行&lt;/p&gt;
&lt;p&gt;而分布式事务由多个核心方案：&lt;/p&gt;

&lt;h4 id=&quot;article-2pc-1&quot;&gt;2PC&lt;/h4&gt;&lt;p&gt;2PC能保证数据的强一致性，偏向CP，且依赖数据库&lt;/p&gt;
&lt;p&gt;我们通常将服务称之为&lt;strong&gt;事物的参与者&lt;/strong&gt;，除此之外，我们通常还需要实现一个&lt;strong&gt;事物的协调者&lt;/strong&gt;。2PC机制由两个阶段完成：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;第一阶段（PreCommit）：事物协调者会通知所有的事物参与者是否准备好，事物参与者接受通知后会开启各自事物并执行相关业务操作，但并不提交事务，而是在提交事务前全局阻塞自身进程&lt;/li&gt;
&lt;li&gt;第二阶段（DoCommit）：若第一阶段正常结束，则事物协调者通知所有事物参与者进行事物提交。否则，第一阶段时事物参与者发生异常或超时，事物协调者会通知所有事物参与者执行回滚操作&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/2PC.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;2PC带来的问题是，在第一阶段会造成整个事物的全局阻塞，进而影响系统的整体性能。且若当发生异常情况，会浪费系统资源，比如在第一阶段某个参与者发生异常，会造成其他参与者的系统资源被浪费。或当协调者宕机时，所有的参与者资源会一直锁定。且若第二阶段协调者发送部分提交后崩溃，仍有数据不一致风险，且性能开销大，在准备阶段和提交阶段需要两次网络通信，增加了延迟&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;2PC能保证数据的强一致性&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-3pc-1&quot;&gt;3PC&lt;/h4&gt;&lt;p&gt;3PC在2PC的基础上，多出了一个“询问”阶段（CanCommit），在该阶段，事物协调者会询问各个事物参与者是否存在，各个参与者收到消息后立刻返回自己是否可用，不发送任何业务逻辑，也不锁定资源。之后再进入常规的2PC机制（PreCommit&amp;amp;DoCommit）&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/3PC.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;这样的机制能避免在某个参与者不可用的情况下造成的资源浪费，减少资源锁定时间，降低阻塞。但并未解决2PC机制的全部痛点&lt;/p&gt;

&lt;h4 id=&quot;article-tcc-1&quot;&gt;TCC&lt;/h4&gt;&lt;p&gt;TCC机制是&lt;code&gt;Try、Confirm、Cancel&lt;/code&gt;的缩写，类似2PC，但阻塞粒度更小，更依赖代码逻辑而非数据库，且保证最终一致性，倾向AP&lt;/p&gt;
&lt;p&gt;TCC同样分为两步：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;第一阶段（Try）：事物协调者通知所有事物参与者尝试运行自身业务内容，进行资源的预处理（比如创建标记为“enable:false”的订单、对“冻结数据”进行增减而非真实数据）以排查一切可能的错误&lt;/li&gt;
&lt;li&gt;第二阶段（Confirm）：事物协调者通知所有事物参与者将预处理的数据实际执行（例如将enable设置为true，将“冻结库存”-1，将“库存”+1）&lt;/li&gt;
&lt;li&gt;异常阶段（Cancel）：当第一阶段由事物参与者产生异常，事物协调者对所有事物参与者通知Cancel信息，将第一阶段的改动回滚&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/TCC1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/TCC2.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;TCC能防止线程阻塞，性能更好（只在短时间内持有资源锁），但只能保证最终一致性，更适合高并发场景，同时TCC也会为业务编写增加复杂度（需要手动实现Try等方法）&lt;/p&gt;

&lt;h4 id=&quot;article-本地消息表-1&quot;&gt;本地消息表&lt;/h4&gt;&lt;p&gt;本地消息表也是保证数据最终一致性（AP）的一个方案，利用本地数据库的事务能力，将业务操作和消息记录绑定在同一个事务中，通过异步重试确保消息最终被消费，从而实现业务与下游操作的最终一致性&lt;/p&gt;
&lt;p&gt;本地事物表机制的实现如下，需要我们额外设计消息表数据库存储消息的元数据：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;原子写入业务消息:&lt;/p&gt;
&lt;p&gt; 开启本地数据库事务,执行业务主操作（例如在orders表中插入一条新订单记录）,并在同一个事务中，向本地消息表插入一条消息记录，记录消息ID（唯一标识）、业务类型和业务ID、消息内容（通常是JSON格式，包含下游服务需要的数据）、状态（初始为待发送）、重试次数（初始为0）等。之后提交事务，并保证业务数据和消息记录要么同时成功，要么同时失败，保证“业务完成”和“通知下游”这两个操作的原子性&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;异步消息投递:&lt;/p&gt;
&lt;p&gt; 在独立的定时任务（或线程）中扫描本地消息表，找出状态为待发送的记录，并将消息内容发送到消息队列。如果发送成功，将本地消息表中的该条记录状态更新为已发送，否则记录重试次数并等待下次重试（通常会设置最大重试次数和指数退避策略）&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;下游服务幂等消费：&lt;/p&gt;
&lt;p&gt; 下游服务从消息队列消费消息，并保证消费业务实现幂等逻辑。通常根据消息ID或业务唯一键检查是否已处理过。如果已处理，直接确认消息，避免重复操作。如果未处理，则执行相应的业务逻辑，并在本地记录处理完成的状态，消费成功后，向MQ确认消息&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;最终一致性的达成&lt;/p&gt;
&lt;p&gt; 经过上述流程，只要消息最终被成功消费，业务主系统（订单）和下游系统（库存）的状态就会达成一致。由于是异步过程，中间会有一个短暂的不一致窗口（订单已创建，但库存还未扣）。但能在最后保证数据一致（最终一致性）&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;h4 id=&quot;article-消息事物-1&quot;&gt;消息事物&lt;/h4&gt;&lt;p&gt;事务消息是 RocketMQ 提供的事务功能，可以由消息中间件提供的特殊机制，确保消息发送与本地业务事务具备“类2PC”的原子性：即消息要么随业务成功而最终被投递，要么随业务失败而被撤回，支持生产者在执行本地事务后决定消息的最终状态（提交或回滚），实现分布式事务，从而保证数据的最终一致性&lt;/p&gt;
&lt;p&gt;在接触消息事物之前，我们先来了解一下RocketMQ。&lt;/p&gt;
&lt;p&gt;RocketMQ 的事务消息基于以下设计：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;半消息（Half Message）：生产者发送的消息首先作为“半消息”存储在 Broker 中，对消费者不可见。Broker 会先等待生产者确认消息状态（提交或回滚）&lt;/li&gt;
&lt;li&gt;事务状态检查：如果生产者未及时确认，Broker 会定时回查生产者的事务状态，决定消息是提交（对消费者可见）还是回滚（丢弃）&lt;/li&gt;
&lt;li&gt;API 支持：RocketMQ 提供了专门用于发送和管理事务消息的API并处理本地事务逻辑&lt;/li&gt;
&lt;li&gt;存储与可靠性：事务消息会存储在 Broker 的专用队列中，记录事务状态日志，确保高可用性和一致&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;而事物消息的完整实现流程如下：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;发送半消息（Half Message）并执行业务：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;生产者发送“半消息”到MQ Broker。这种消息对消费者是不可见的，它只是暂存在Broker上，用于后续确认&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;MQ Broker持久化半消息后，向生产者返回“发送成功”&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;生产者在本地执行业务事务（如订单入库）&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;生产者根据本地事务的执行结果，向MQ Broker发送二次确认（Commit或Rollback）：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;如果本地事务成功，发送Commit，半消息将变为正式消息，对消费者可见。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;如果本地事务失败，发送Rollback，MQ Broker将删除半消息。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;事务状态回查&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;如果MQ Broker长时间未收到生产者的二次确认（例如生产者宕机），MQ会主动向生产者发起事务状态回查&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;生产者需要实现一个“事务状态回查监听器”和回调函数（Callback）。当收到回查请求时，它必须去检查本地事务的实际状态（例如查询订单表是否存在对应的订单）&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;生产者根据检查结果，再次向Broker返回Commit或Rollback指令，Broker据此决定消息的最终结果&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;消息消费&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;一旦消息被Commit，其流程就与普通消息一致：对消费者可见，被消费，并保证至少投递一次。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;消费者同样需要实现幂等消费&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/RDC.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;这样，业务系统和消息队列便像两个人握手合作，共同保证了原子性&lt;/p&gt;

&lt;h4 id=&quot;article-saga模式-1&quot;&gt;Saga模式&lt;/h4&gt;&lt;p&gt;Saga模式就是将一个庞大的分布式事务拆解为一系列按顺序执行的本地子事务。每个子事务都有对应的补偿操作。通过正向执行和反向补偿，保证整个业务链的最终一致性&lt;/p&gt;
&lt;p&gt;Saga由两种实现模式：协同式和编排式&lt;/p&gt;
&lt;p&gt;协同式：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;事务编排与启动&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Saga协调器（Orchestrator）接收到一个业务请求&lt;/strong&gt;（例如：“预订旅行套餐”）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;协调器根据预定义的Saga流程，编排出一个子事务执行序列&lt;/strong&gt;。例如：&lt;ul&gt;
&lt;li&gt;T1: 预订酒店&lt;/li&gt;
&lt;li&gt;T2: 预订机票&lt;/li&gt;
&lt;li&gt;T3: 租车&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;正向执行流程（Try-Phase）&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;协调器向“酒店服务”发送执行T1的命令&lt;/strong&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;酒店服务执行本地事务&lt;/strong&gt;（在酒店库存中预留一个房间）。成功后向协调器报告成功&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;协调器收到T1成功，接着向“机票服务”发送执行T2的命令&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;机票服务执行本地事务&lt;/strong&gt;（锁定一个航班座位）。成功后向协调器报告成功&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;协调器收到T2成功，接着向“租车服务”发送执行T3的命令&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;失败与补偿流程（Compensate-Phase）&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;假设租车服务执行T3失败&lt;/strong&gt;（无车可租），它向协调器报告失败&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;协调器开始启动补偿流程，顺序与正向执行相反&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;协调器首先向“机票服务”发送补偿C2的命令&lt;/strong&gt;（要求取消之前锁定的航班座位）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;机票服务执行补偿操作C2&lt;/strong&gt;（释放座位）。成功后报告&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;协调器收到C2成功，接着向“酒店服务”发送补偿C1的命令&lt;/strong&gt;（要求取消预留的房间）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;酒店服务执行补偿操作C1&lt;/strong&gt;（释放房间）。成功后报告&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;至此，所有已完成的步骤都被撤销，系统状态恢复到事务开始前&lt;/strong&gt;。协调器向客户端返回业务失败&lt;/li&gt;
&lt;/ol&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;成功流程&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;如果所有子事务（T1, T2, T3）都成功&lt;/strong&gt;，协调器则标记整个Saga事务成功，并向客户端返回成功&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;由此可见，Saga可靠性的根源，依赖于每个参与者本地事务的可靠性，以及补偿操作的正确设计和执行。其关键设计补偿事务（Compensating Transaction）不是简单的回滚，而是一个业务上的逆向操作（如“取消预订”而非“删除记录”）&lt;/p&gt;
&lt;p&gt;Saga保证最终一致性，倾向AP&lt;/p&gt;

&lt;h3 id=&quot;article-一致性共识算法-1&quot;&gt;一致性共识算法&lt;/h3&gt;&lt;p&gt;虽然我们在项目内部并不会直接手搓一致性共识算法，但是我们有时会接触到相关思想，而且学习这部分对分布式系统的认知也是很重要的&lt;/p&gt;
&lt;p&gt;要介绍一致性共识算法，我们引用一篇技术文章里的解释：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;在分布式系统中，为了消除单点提高系统可用性，通常会使用副本来进行容错，但这会带来另一个问题，即如何保证多个副本之间的一致性？&lt;/p&gt;
&lt;p&gt;所谓的强一致性（线性一致性）并不是指集群中所有节点在任一时刻的状态必须完全一致，而是指一个目标，即让一个分布式系统看起来只有一个数据副本，并且读写操作都是原子的，这样应用层就可以忽略系统底层多个数据副本间的同步问题。也就是说，我们可以将一个强一致性分布式系统当成一个整体，一旦某个客户端成功的执行了写操作，那么所有客户端都一定能读出刚刚写入的值。即使发生网络分区故障，或者少部分节点发生异常，整个集群依然能够像单机一样提供服务。&lt;br /&gt;共识算法（Consensus Algorithm）就是用来做这个事情的，它保证即使在小部分（≤ (N-1)/2）节点故障的情况下，系统仍然能正常对外提供服务。共识算法通常基于状态复制机（Replicated State Machine）模型，也就是所有节点从同一个 state 出发，经过同样的操作 log，最终达到一致的 state&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;一致性共识算法有很多，其中又以Paxos共识算法以及在Paxos基础上诞生的Raft共识算法最为出名，我们熟知的etcd内部就是基于Raft共识算法实现的&lt;/p&gt;
&lt;p&gt;若想详解Raft共识算法，在短篇幅内是很难完成的，看之后有时间的话我再单独开一片来单开文章剖析一下Raft和Paxos这俩共识算法&lt;/p&gt;
&lt;p&gt;这里我们就Raft讲讲最基础的部分，以及对一致性共识算法进行一个笼统的概念解释：&lt;/p&gt;
&lt;p&gt;在Raft算法中存在一个集群，集群中的节点由三种身份：Leader、Follower和Candidate，且整个集群中同一时期内最多只存在一个Leader节点&lt;/p&gt;
&lt;p&gt;Raft通过三大核心机制达成数据一致性：选主（Leader election）、日志复制（Log replication）、安全性（Safety）&lt;/p&gt;
&lt;p&gt;同时，Raft还有两个安全机制：集群身份变更和日志压缩。有关更多Raft的部分不做讲解，短篇幅内实在难以详尽讲解，且我们也不希望用流水账一般的文字对Raft囫囵吞枣，所以此处不再过度深入Raft了&lt;/p&gt;
&lt;p&gt;关于Raft的详细讲解可以看这篇文章，可以说是易懂而且讲的很全面很透彻：&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/6907151199141625870?share_token=b64d349a-e997-4c59-bf55-58e4f8170030&quot;&gt;深度解析 Raft 分布式一致性协议&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;还有这篇关于Paxos的：&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/6844903621499289613?share_token=6f2ef5f6-80a4-4295-a867-6f0ce186b408&quot;&gt;一致性算法Paxos&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-配置中心-1&quot;&gt;配置中心&lt;/h3&gt;&lt;p&gt;配置中心在分布式系统中是一个独立的、中心化的服务器系统，也是分布式系统架构中的一个核心组件，用于在多个服务实例、多个环境中，高效、一致、安全地管理配置，并且能在配置变更时，实时或准实时地通知到所有相关服务，而无需重启服务&lt;/p&gt;
&lt;p&gt;在我们之前写单体式项目时已经接触过Viper这个配置管理工具包，但是在分布式系统中，每个服务都有自己的数据库dsn，端口映射或业务内部键等这种配置文件和字段，当服务数量达到几十个甚至上百个时，我们使用viper和本地配置文件修改和管理配置会异常麻烦，为了解决分布式系统配置管理的痛点、区分不同环境的配置项以及热更新配置（Viper也有），我们遇到了配置中心&lt;/p&gt;
&lt;p&gt;配置中心能够统一管理配置（配置项的修改编辑统一在配置中心页面进行，还包括统一的配置版本管理、环境隔离、灰度发布以及热发布，在不重启应用的情况下使得修改的配置可以生效起作用）、统一控制权限（控制配置的读取权限以及修改权限，通过统一的权限管理提升运维效率）和统一审计操作（记录用户操作修改配置的历史信息，这样在出现问题的时候可以进行复盘回查，同时进行操作审计）&lt;/p&gt;
&lt;p&gt;当然，即使引入了配置中心，我们还是需要使用viper获取部分引导配置，如配置中心的地址和端口&lt;/p&gt;
&lt;p&gt;常见配置中心有Nacos、Apollo等,我们这里讲解一下Nacos配置中心&lt;/p&gt;
&lt;p&gt;我们可以使用docker快速开启Nacos服务：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -d&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; --name&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; nacos&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 8848:8848&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;   --privileged=true&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -e&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; JVM_XMS=256m&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -e&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; JVM_XMX=256m&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -e&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; MODE=standalone&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; nacos/nacos-server:latest&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;启动后访问 &lt;code&gt;http://127.0.0.1:8848/nacos/&lt;/code&gt; 即可访问Nacos控制台&lt;/p&gt;
&lt;p&gt;关于在Go里集成Nacos，可见这篇文章：&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/7238521725138485305?searchId=20260325205728C7B0B36C6815561A935E&quot;&gt;go集成nacos配置中心并读取配置信息&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-dtm-1&quot;&gt;DTM&lt;/h2&gt;&lt;p&gt;在Go语言中也有一些出名的分布式事务框架，比如DTM，Seata。这里我们着重介绍DTM&lt;/p&gt;
&lt;p&gt;DTM是一款开源的分布式事务管理器，解决跨数据库、跨服务、跨语言栈更新数据的一致性问题&lt;/p&gt;
&lt;p&gt;通俗一点说，DTM提供跨服务事务能力，一组服务要么全部成功，要么全部回滚，避免只更新了一部分数据产生的一致性问题&lt;/p&gt;
&lt;p&gt;需要注意的是，DTM本身只是一个分布式事务管理框架，只为我们提供分布式事务相关功能实现，其他功能例如分布式锁，配置中心和接口幂等性内容还需要我们手动实现&lt;/p&gt;
&lt;p&gt;而DTM本身为我们提供了多种分布式事务模式，例如SAGA，TCC，XA和消息事物等&lt;/p&gt;
&lt;p&gt;例如我们使用SAGA模式在项目中实践分布式事务，这就需要我们为每个参与服务实现一个正向操作接口和一个对应的补偿操作接口（若项目为三层架构则在service层进行），并对接口进行幂等性改造&lt;/p&gt;
&lt;p&gt;快速开始：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 具体业务微服务地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; qsBusi&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;http://localhost:8081/api/busi_saga&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;req &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;amount&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;30&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;} &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 微服务的载荷&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// DtmServer为DTM服务的地址，是一个url&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;DtmServer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;http://localhost:36789/api/dtmsvr&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;saga &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dtmcli.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewSaga&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(DtmServer, shortuuid.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 添加一个TransOut的子事务，正向操作为url: qsBusi+&quot;/TransOut&quot;， 补偿操作为url: qsBusi+&quot;/TransOutCompensate&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(qsBusi&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/TransOut&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, qsBusi&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/TransOutCompensate&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, req).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 添加一个TransIn的子事务，正向操作为url: qsBusi+&quot;/TransIn&quot;， 补偿操作为url: qsBusi+&quot;/TransInCompensate&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(qsBusi&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/TransIn&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, qsBusi&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/TransInCompensate&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, req)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 提交saga事务，dtm会完成所有的子事务/回滚所有的子事务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; saga.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Submit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;整个事务最终成功完成，时序图如下：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/dtm.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;这是一个在go-zero框架下的微服务项目集成dtm的示例：&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/7051205679217901599&quot;&gt;go-zero实战: 11 分布式事务 DTM&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-后记-1&quot;&gt;后记&lt;/h2&gt;&lt;p&gt;分布式事务可以说是分布式系统里最重要，也是较复杂的一个环节。我居然花了三天来弄完这方面的内容（其实有两天摆了半天），不过把这部分搞完让我对分布式系统的理解有了质的飞跃，博客也是突破了万字长文。特别是Raft共识算法这部分。之后打算把之前微服务的demo集成一下redis集群和分布式锁，加上配置中心，再用上dtm和SAGA进行分布式事务管理。在这之后学习一下DDD架构，就算这一大板块的结束吧，K8s之后再说，先学习AI agent，感觉各方面落后了一大截&lt;/p&gt;

&lt;h2 id=&quot;article-参考资料-1&quot;&gt;参考资料&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.cnblogs.com/shoshana-kong/p/17319231.html&quot;&gt;雪花算法的详解及时间回拨解决方案&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.bilibili.com/video/BV1mC4y1f7CG/?spm_id_from=333.337.search-card.all.click&quot;&gt;分布式事务的解决方案&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://developer.aliyun.com/article/1531650&quot;&gt;本地消息表实现分布式事务的原理与步骤&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/7493037770954342438&quot;&gt;RocketMQ事务消息详解与实战&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://rocketmq.apache.org/zh/docs/featureBehavior/04transactionmessage/&quot;&gt;事物消息 | RocketMQ&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://zhuanlan.zhihu.com/p/95852045&quot;&gt;分布式事务系列三：Saga&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/6907151199141625870?share_token=b64d349a-e997-4c59-bf55-58e4f8170030&quot;&gt;深度解析 Raft 分布式一致性协议&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/6844903621499289613?share_token=6f2ef5f6-80a4-4295-a867-6f0ce186b408&quot;&gt;一致性算法Paxos&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/7238521725138485305?searchId=20260325205728C7B0B36C6815561A935E&quot;&gt;go集成nacos配置中心并读取配置信息&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://dtm.pub/guide/start.html&quot;&gt;DTM开源项目文档&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://juejin.cn/post/7051205679217901599&quot;&gt;go-zero实战: 11 分布式事务 DTM&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-DataConsistency/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>微服务</category><category>分布式</category></item><item><title>项目可视化：分布式系统中的可观测性</title><link>https://www.claran-blog.work/posts/go-observability/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-observability/</guid><description>讲解OpenTelemetry、Prometheus、Jaeger和ELK的使用.</description><pubDate>Tue, 17 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-引言-1&quot;&gt;引言&lt;/h2&gt;&lt;p&gt;学完消息队列后象征性学习了一下API网关，现在继续学习可观测性部分的内容，万恶的Docker让我调试了大半天Demo&lt;/p&gt;
&lt;p&gt;我们在之前写单体架构的项目时，总是用Zap等日志库对程序进行监控或获取调试信息。但是在分布式架构中，每个微服务都是不同的整体，这时候再用日志等方式记录调试信息，日志等数据就会分散在各个微服务内部，观测起来略显繁琐，所以，我们需要学习&lt;strong&gt;可观测性&lt;/strong&gt;的相关内容&lt;/p&gt;

&lt;h2 id=&quot;article-可观测性-1&quot;&gt;可观测性&lt;/h2&gt;&lt;p&gt;可观测性到底是什么呢？&lt;/p&gt;
&lt;p&gt;在计算机系统和软件领域，可观测性的含义是：可以从系统和应用对外输出的信息（&lt;strong&gt;指标、日志和链路&lt;/strong&gt;），来&lt;strong&gt;帮助我们了解应用程序的内部系统状态和运行情况&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;但可观测性并不只是简单的数据采集，它更强调对这些数据的关联和分析，这能够帮助我们快速定位，找到问题的根本原因。&lt;strong&gt;最终保障系统的可靠性，构建可靠的后端服务质量&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;而可观测性有三大支柱：&lt;strong&gt;指标&lt;/strong&gt;（&lt;strong&gt;metrics&lt;/strong&gt;），&lt;strong&gt;链路追踪&lt;/strong&gt;（&lt;strong&gt;Tracing&lt;/strong&gt;）&lt;strong&gt;和日志&lt;/strong&gt;（&lt;strong&gt;logs&lt;/strong&gt;）&lt;/p&gt;

&lt;h3 id=&quot;article-指标-metrics-1&quot;&gt;指标（Metrics）&lt;/h3&gt;&lt;p&gt;指标（Metrics）指&lt;strong&gt;服务器内可测量、记录的数据&lt;/strong&gt;。它包括特定属性，例如时间戳、名称、键和值。和⽇志不同，指标在默认情况下是结构化的，这会让查询和优化存储变得更加容易&lt;/p&gt;
&lt;p&gt;指标可以用于记录应用程序的性能指标，例如请求响应时间、内存使用率和CPU负载等&lt;/p&gt;
&lt;p&gt;指标分为三种类型：&lt;strong&gt;Counter&lt;/strong&gt;（&lt;strong&gt;计数器&lt;/strong&gt;），&lt;strong&gt;Histogram&lt;/strong&gt;（&lt;strong&gt;直方图&lt;/strong&gt;）和&lt;strong&gt;Gauge&lt;/strong&gt;（&lt;strong&gt;仪表盘&lt;/strong&gt;）&lt;/p&gt;
&lt;p&gt;在程序中，我们通过Add方式记录Counter类指标，用Record方式记录Histogram指标，用Callback（回调函数）方式记录Gauge指标&lt;/p&gt;
&lt;p&gt;一般来说，我们需要一个目标系统来统合指标数据，比如&lt;code&gt;Prometheus&lt;/code&gt;，我们后文详解&lt;/p&gt;

&lt;h3 id=&quot;article-链路追踪-tracing-1&quot;&gt;链路追踪（Tracing）&lt;/h3&gt;&lt;p&gt;链路追踪，有时候也被称为分布式追踪（Distributed Tracing），表示&lt;strong&gt;请求通过分布式系统的端到端的路径&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;Trace由Span（跨度）和TraceContext（跨度上下文）两个部分组成。一个 Trace 是 Spans 的有向无环图。链路追踪一般会通过一个可视化的瀑布图展现出来。瀑布图展示了用于调试的请求的每个阶段，以及每个部分的开始时间和持续时长&lt;/p&gt;
&lt;p&gt;TraceContext（跟踪上下文）是一种用于在分布式系统中传递跟踪信息的标准格式。TraceContext包含了跟踪ID（Trace ID）、跨度ID（Span ID）、父级跨度ID（Parent Span ID）等属性，用于跨越多个服务和跨度的信息传递&lt;/p&gt;
&lt;p&gt;每次请求都会产生一条Trace，用于记录该请求的信息和流程，该次Trace下请求的每个操作单元都是一条Span，这样我们就可以知道每个请求的链路流程&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/observability1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;为每个Span加上parentIP或者时间戳等信息后，我们就形成了一条完整链路追踪链&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/observability2.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-span-1&quot;&gt;Span&lt;/h4&gt;&lt;p&gt;&lt;strong&gt;Span是一个Trace下的操作单元&lt;/strong&gt;，表示应用程序中的一个操作或事件，例如HTTP请求、数据库查询或RPC调用等&lt;/p&gt;
&lt;p&gt;Span包括一些元数据信息，例如操作名称、起始时间和持续时间等，以及一些我们自己可以添加的标签和注释，用于描述Span的上下文和特征&lt;/p&gt;
&lt;p&gt;一般来说，同一个Trace下的多个Span互相间呈父子关系或树状关系，例如单次请求流过了API网关（api-gateway）-RPC服务器（handler-service-dao），那么这次请求产生的trace就包含&lt;code&gt;api-gateway&lt;/code&gt; -&amp;gt; &lt;code&gt;rpc.handler&lt;/code&gt; -&amp;gt; &lt;code&gt;rpc.service&lt;/code&gt; -&amp;gt; &lt;code&gt;rpc.dao&lt;/code&gt;四条Span，顺序的Span呈父子关系，且各自记录了请求流过该部件时的部分信息&lt;/p&gt;
&lt;p&gt;一般而言，Span间的父子关系由&lt;code&gt;context&lt;/code&gt;声明，例如，子Span提取当前上下文&lt;code&gt;context&lt;/code&gt;中父Span的信息从而产生&lt;/p&gt;

&lt;h5 id=&quot;article-spancontext-1&quot;&gt;SpanContext&lt;/h5&gt;&lt;p&gt;Span Context是Span内部用于存储Span信息的结构，是Span中包含的不可变的对象，子Span可以提取父Span的信息产生父子关系&lt;/p&gt;

&lt;h5 id=&quot;article-spanattribute-1&quot;&gt;SpanAttribute&lt;/h5&gt;&lt;p&gt;pan Attributes（跨度属性）是用于描述Span的一些元数据信息的（K-V）键值对&lt;/p&gt;
&lt;p&gt;pan Attributes可以包含各种有用的信息，例如操作类型、HTTP方法、HTTP路径、请求参数等。Span Attributes通常被用于分析和理解跟踪数据，以便更好地监控和调试应用程序的性能和行为&lt;/p&gt;
&lt;p&gt;我们可以手动添加当前业务需要观测的数据到SpanAttribute中以完善可观测性&lt;/p&gt;

&lt;h3 id=&quot;article-分布式日志-logs-1&quot;&gt;分布式日志（Logs）&lt;/h3&gt;&lt;p&gt;分布式日志，是在单体日志（如Zap）的基础上，对每个微服务的单体日志进行搜索收集、整理聚合在进行优化展示后的日志记录方式&lt;/p&gt;
&lt;p&gt;有关日志的基本实现方法：&lt;strong&gt;&lt;a href=&quot;https://www.claran-blog.work/go-viper&amp;amp;zap/&quot;&gt;Zap的使用&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;一般来说，分布式日志系统以ELK为典型，基于Elasticsearch、Logstash、Kibana三个开源软件构建的集中式日志管理平台&lt;/p&gt;
&lt;p&gt;在分布式日志系统中，由Logstash收集整理各个微服务的日志文件，再进处理转发给Elasticsearch进行查询，最终由Kibana可视化输出给用户&lt;/p&gt;
&lt;p&gt;有关ELK的详细实现后文细嗦&lt;/p&gt;

&lt;h3 id=&quot;article-工具-1&quot;&gt;工具&lt;/h3&gt;&lt;p&gt;以上就是可观测性的一些基本概念，同样的，可观测性的实现还离不开相对工具的使用&lt;/p&gt;

&lt;h4 id=&quot;article-prometheus-1&quot;&gt;Prometheus&lt;/h4&gt;&lt;p&gt;&lt;a href=&quot;https://github.com/prometheus&quot;&gt;Prometheus&lt;span&gt;&lt;/span&gt;&lt;/a&gt; 是由前 Google 工程师从 2012 年开始在 Soundcloud 以开源软件的形式进行研发的系统监控和告警工具包，自此以后，许多公司和组织都采用了 Prometheus 作为监控告警工具。Prometheus 的开发者和用户社区非常活跃，它现在是一个独立的开源项目，可以独立于任何公司进行维护&lt;/p&gt;
&lt;p&gt;Prometheus 的主要优势有：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;由指标名称和和键/值对标签标识的时间序列数据组成的多维数据模型&lt;/li&gt;
&lt;li&gt;强大的查询语言 PromQL&lt;/li&gt;
&lt;li&gt;不依赖分布式存储；单个服务节点具有自治能力&lt;/li&gt;
&lt;li&gt;时间序列数据是服务端通过 HTTP 协议主动拉取获得的&lt;/li&gt;
&lt;li&gt;也可以通过中间网关来推送时间序列数据&lt;/li&gt;
&lt;li&gt;可以通过静态配置文件或服务发现来获取监控目标&lt;/li&gt;
&lt;li&gt;支持多种类型的图表和仪表盘&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;可以使用docker部署（可选，之后我们用docker-compose统一管理）：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 9090:9090&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    -v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; /path/to/prometheus.yml:/etc/prometheus/prometheus.yml&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    prom/prometheus&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;注：Prometheus容器只接受yml配置文件，不要搞错成yaml&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;容器启动后，使用浏览器打开 &lt;a href=&quot;http://localhost:9090/&quot;&gt;http://localhost:9090&lt;span&gt;&lt;/span&gt;&lt;/a&gt; 即可访问 Prometheus UI，如果想要添加数据源，需要配置 prometheus.yml&lt;/p&gt;

&lt;h4 id=&quot;article-jaeger-1&quot;&gt;Jaeger&lt;/h4&gt;&lt;p&gt;&lt;a href=&quot;https://www.jaegertracing.io/&quot;&gt;Jaeger&lt;span&gt;&lt;/span&gt;&lt;/a&gt;  是由 Uber Technologies 作为开源发布的分布式跟踪系统，兼容 OpenTracing 以及 Zipkin 追踪格式，目前已成为 CNCF 基金会的开源项目。其前端采用React语言实现，后端采用GO语言实现，适用于进行链路追踪，分布式跟踪消息传递，分布式事务监控、问题分析、服务依赖性分析、性能优化等场景&lt;/p&gt;
&lt;p&gt;我们一般使用&lt;code&gt;all-in-one&lt;/code&gt;Docker 镜像作为Jaeger部署，其包含包含 Jaeger UI、jaeger-collector、jaeger-query 和 jaeger-agent，以及一个内存存储组件。适用于快速体验 Jaeger ，由于所有追踪数据存储在内存中，不适用于生产环境&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; --rm&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; --name&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; jaeger&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -e&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; COLLECTOR_ZIPKIN_HOST_PORT=:9411&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 6831:6831/udp&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 6832:6832/udp&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 5778:5778&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 16686:16686&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 4317:4317&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 4318:4318&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 14250:14250&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 14268:14268&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 14269:14269&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 9411:9411&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  jaegertracing/all-in-one:1.56&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;容器启动后，使用浏览器打开 &lt;a href=&quot;http://localhost:16686/&quot;&gt;http://localhost:16686&lt;span&gt;&lt;/span&gt;&lt;/a&gt; 即可访问 Jaeger UI&lt;/p&gt;

&lt;h4 id=&quot;article-opentelemetry-1&quot;&gt;OpenTelemetry&lt;/h4&gt;&lt;p&gt;就算有了以上这些工具，我们还是面临一大重量级难题：&lt;strong&gt;各个检测组件的数据传输协议不一致&lt;/strong&gt;，这导致了我们很难去直接使用这些工具进行统一开发&lt;/p&gt;
&lt;p&gt;这时候OpenTelemetry来了：&lt;/p&gt;
&lt;p&gt;OpenTelemetry 简称 OTel， 是 CNCF （ Cloud Native Computing Foundation，云原生计算基金会，是一个开源软件基金会，致力于云原生技术的普及和可持续发展） 的一个可观测性项目。&lt;/p&gt;
&lt;p&gt;OpenTelemetry 旨在提供可观测性领域的标准化方案，解决遥测数据的数据建模、采集、处理、导出等标准化问题，并能够将这些数据发送到你选择的后端（开源或商业均可）。这样你就可以建立不被供应商锁定的可观测，灵活地更改后端，不需要再次更改代码，重新进行插桩（Instrument）了&lt;/p&gt;
&lt;p&gt;也就是说，OpenTelemetry是一个可以统一数据传输协议的工具，可以灵活地整合Jaeger、Prometheus等组件的使用&lt;/p&gt;

&lt;h5 id=&quot;article-otlp-1&quot;&gt;OTLP&lt;/h5&gt;&lt;p&gt;OTLP就是传递遥测信号使用的统一传输协议，用于将数据导出到后端或其他收集器&lt;/p&gt;
&lt;p&gt;OTLP 可以使用 gRPC (OTLP/gRPC) 或 HTTP (OTLP/HTTP)两种方式方式传输数据&lt;/p&gt;

&lt;h5 id=&quot;article-otel-collector-1&quot;&gt;otel-collector&lt;/h5&gt;&lt;p&gt;OpenTelemetry Collector是OpenTelemetry 项目中的一个代理软件，作为遥测数据的中转站，能够对遥测数据做一些预处理的逻辑&lt;/p&gt;
&lt;p&gt;也就是说，otel-collector可以进行数据的统一收集与整理&lt;/p&gt;
&lt;p&gt;一般来说，我们有两种模式可以部署otel-collector：&lt;code&gt;gateway&lt;/code&gt;模式和&lt;code&gt;agent&lt;/code&gt;模式&lt;/p&gt;

&lt;h5 id=&quot;article-pipeline-1&quot;&gt;pipeline&lt;/h5&gt;&lt;p&gt;Collector 采用 Pipeline 方式来接收、处理和导出数据，每个 Collector 可配置一个或多个 Pipeline，每个 pipeline 包含如下组件：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;receiver&lt;/li&gt;
&lt;li&gt;processor&lt;/li&gt;
&lt;li&gt;exporter&lt;/li&gt;
&lt;li&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;每个 receiver 可能被多个 pipeline 共用，多个 pipeline 也可能包含同一个 exporter&lt;/p&gt;
&lt;p&gt;一个pipeline定义了一条数据流动的路径：从 Collector 数据接收开始，然后进一步的处理或修改，到最后通过exporter导出。&lt;/p&gt;
&lt;p&gt;pipeline能够处理3种类型数据：trace、metric和logs。数据类型是需要pipeline配置的一个属性。在pipeline中receiver、processor和exporter必须支持某个特定的数据类型&lt;/p&gt;

&lt;h4 id=&quot;article-elk-1&quot;&gt;ELK&lt;/h4&gt;&lt;p&gt;ELK是一个分布式日志系统，由Filebeat收集微服务日志文件，由Logstash解析、过滤、增强日志，由ElasticSearch存储、索引日志，最后由Kibana或者Grafana将日志文件可视化到Web UI上&lt;/p&gt;
&lt;p&gt;需要注意的是，在使用ELK分布式日志系统时，我们最好确保项目内的日志输出格式是JSON格式，以便于Logstash解析日志内容，例如我们为Zap设置&lt;code&gt;JSONEncoder&lt;/code&gt;而非&lt;code&gt;ConsoleEncoder&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;也可以不使用JSON格式，但需要特别地在Filebeat和Logstash中进行适配Console格式的特殊配置&lt;/p&gt;

&lt;h4 id=&quot;article-grafana-1&quot;&gt;Grafana&lt;/h4&gt;&lt;p&gt;Grafana是一个可以将几乎所有可观测数据和组件统合到一个可视化仪表盘上的工具，我们只需要在docker-compose里适当配置Grafana的接受和监听端口就能实现相关功能，不需要集成到代码中去&lt;/p&gt;

&lt;h4 id=&quot;article-工具整合-1&quot;&gt;工具整合&lt;/h4&gt;&lt;p&gt;那么在项目中，我们完整的可观测性链路呈以下关系：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/observability10.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-实践学习-1&quot;&gt;实践学习&lt;/h2&gt;&lt;p&gt;接下来，我们开始学习在项目里实现完整的可观测性&lt;/p&gt;
&lt;p&gt;此处我们使用hertz+kitex框架&lt;/p&gt;
&lt;p&gt;需要注意的是，hertz和kitex框架也整合了OTel相关方法，以便我们可以快速实现可观测性&lt;/p&gt;

&lt;h3 id=&quot;article-工具部署-1&quot;&gt;工具部署&lt;/h3&gt;&lt;p&gt;我们需要先编写docker-compose.yaml和两个配置文件（otel-collector.yaml和prometheus.yml），统一拉取镜像并管理容器：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;docker-compose.yaml:&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;YAML&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# docker-compose.yaml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;version&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;3.8&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;networks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  otel-network&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    driver&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;bridge&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;services&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  otel-collector&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;otel/opentelemetry-collector-contrib:latest&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;otel-collector&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;../config/collector.yaml:/etc/otelcol-contrib/config.yaml&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 挂载配置文件，注意核查路径&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;8079:4317&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;8082:4318&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;8889:8889&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    networks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;otel-network&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    command&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;--config=/etc/otelcol-contrib/config.yaml&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  prometheus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;prom/prometheus:latest&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;prometheus&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;../config/prometheus.yaml:/etc/prometheus/prometheus.yml&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 确保为yml，Prometheus只会读取yml配置文件，又找了几个小时的bug&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;8084:9090&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    networks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;otel-network&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    depends_on&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;otel-collector&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  jaeger&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;jaegertracing/all-in-one:latest&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;jaeger&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    environment&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;COLLECTOR_OTLP_ENABLED=true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;8085:16686&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    networks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;otel-network&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  grafana&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;grafana/grafana:latest&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;grafana&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    environment&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;GF_SECURITY_ADMIN_PASSWORD=admin123&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;8086:3000&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;grafana-data:/var/lib/grafana&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    networks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;otel-network&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    depends_on&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;prometheus&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;jaeger&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;volumes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  grafana-data&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;otel-collector.yaml:&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;YAML&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# otel-collector.yaml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;receivers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  otlp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    protocols&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      grpc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;        endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;0.0.0.0:4317&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      http&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;        endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;0.0.0.0:4318&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;processors&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  batch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    timeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;10s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    send_batch_size&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1024&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;exporters&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  debug&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    verbosity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;detailed&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  prometheus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;0.0.0.0:8889&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    namespace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;otel&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  otlp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;jaeger:4317&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    tls&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      insecure&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  pipelines&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    traces&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      receivers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;otlp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      processors&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;batch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      exporters&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;debug&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;otlp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# trace通过OTLP发送到Jaeger&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    metrics&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      receivers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;otlp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      processors&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;batch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      exporters&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;debug&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;prometheus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;] &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 指标发送到Prometheus&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;prometheus.yml&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;YAML&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# prometheus.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;global&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  scrape_interval&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;15s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  evaluation_interval&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;15s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  scrape_timeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;10s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;#告警&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;#rule_files:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;#  - &quot;alert.rules.yml&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;alerting&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  alertmanagers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;static_configs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;targets&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: []&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;scrape_configs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;job_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;otel-collector&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    scrape_interval&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;10s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    scrape_timeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;8s&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 不能大于scrape_interval，否则会静默报错，别问我怎么知道，找了一天bug，容器日志也不报错，哭&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    honor_labels&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    metrics_path&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;/metrics&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    static_configs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;targets&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;otel-collector:8889&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;        labels&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;          exported_job&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;otel-collector-scraper&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;          instance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;collector-1&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;          component&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;metrics-gateway&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;          environment&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;dev&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;job_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;prometheus&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    scrape_interval&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;30s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    static_configs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;targets&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;localhost:9090&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;        labels&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;          instance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;prometheus-server-1&apos;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;之后在项目目录执行&lt;code&gt;docker-compose up -d&lt;/code&gt;，即可成功启动容器&lt;/p&gt;

&lt;h3 id=&quot;article-opentelemetry-2&quot;&gt;OpenTelemetry&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;RPC：&lt;/strong&gt;&lt;br /&gt;我们首先在main里初始化OTel Provider：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始化 OpenTelemetry provider&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;otelProvider &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; provider.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewOpenTelemetryProvider&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	provider.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithServiceName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	provider.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithExportEndpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;localhost:8079&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	provider.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithInsecure&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	provider.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithEnableTracing&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	provider.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithEnableMetrics&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; otelProvider.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Shutdown&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;在创建rpc服务端时带上WithSuite集成OTel Tracing&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;svr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userservice.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userHandler,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithServiceAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(addr),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithServerBasicInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;rpcinfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EndpointBasicInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			ServiceName: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithRegistry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(r),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithLimit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;limit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			MaxConnections: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1000&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			MaxQPS:         &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1000&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithSuite&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tracing.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewServerSuite&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 使用 Kitex 的 tracing&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这样我们就创建了一个在当前服务内全局可用的Tracer和Meter&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;API：&lt;/strong&gt;&lt;br /&gt;与rpc的差别只有把框架换成了hertz&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始化OTel Provider&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; hertztracing.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewOpenTelemetryProvider&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	hertztracing.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithServiceName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;api-gateway&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	hertztracing.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithExportEndpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;localhost:8079&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	hertztracing.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithInsecure&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Shutdown&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始化Tracer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;tracer, cfg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tracing.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewServerTracer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;我们使用hertz集成度的链路追踪中间件&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 注册全局Tracing中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Use&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tracing.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServerMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cfg))&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-metrics-1&quot;&gt;Metrics&lt;/h3&gt;&lt;p&gt;我们可以在需要监测指标的地方创建metric，此处以&lt;code&gt;user-service&lt;/code&gt;的&lt;code&gt;handler&lt;/code&gt;为例:&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// internal/user-service/handler/handler.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// Metrics指标&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	requestCounter  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;metric&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Int64Counter&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 计数器类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	requestDuration &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;metric&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Float64Histogram&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 直方图类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	errorCounter    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;metric&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Int64Counter&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; initMetrics&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 从全局获取 meter&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	meter &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; otel.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Meter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-service.handler&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 为Prometheus注册指标，下面两个同理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	requestCounter, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; meter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Int64Counter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;claran_user_request_total&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		metric.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithDescription&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;总请求数&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		panic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建requestCounter失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	requestDuration, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; meter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Float64Histogram&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;claran_user_request_duration_seconds&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		metric.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithDescription&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;请求耗时&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		metric.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithUnit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;s&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		panic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建requestDuration失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	errorCounter, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; meter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Int64Counter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;claran_user_errors_total&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		metric.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithDescription&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;总错误数&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		panic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建errorCounter失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;之后我们在创建&lt;code&gt;UserServiceImpl&lt;/code&gt;实例时顺带初始化&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// internal/user-service/handler/handler.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// UserServiceImpl implements the last service interface defined in the IDL.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	UserService &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewUserServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;userService&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 初始化Metrics&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	initMetrics&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{UserService: userService}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;接下来，我们就可以在涉及到指标监控变化的业务里对指标进行记录，以Register接口为例：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// internal/user-service/handler/handler.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Register implements the UserServiceImpl interface.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterReq&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;resp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterResp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;err&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	startTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 记录指标&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 计算响应时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		duration &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Since&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(startTime).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Seconds&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 记录指标（Histogram类型，对应record方法）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		requestDuration.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Record&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, duration,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 添加描述&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			metric.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Register&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;getstatus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 记录直播（Counter对应Add方法）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		requestCounter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			//描述&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			metric.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Register&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;getstatus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 记录错误数量指标&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			errorCounter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				metric.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Register&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;getstatus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	newUser, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.UserService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(spanCtx, req.Username, req.Email, req.Password)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;执行注册服务失败：&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; resp, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resp &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterResp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Success: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		UserID:  newUser.UserID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Msg:     &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;注册成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; resp, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;以上就完成了基础的指标检测，api中的实现与rpc几乎一样&lt;/p&gt;

&lt;h3 id=&quot;article-trace和span-1&quot;&gt;Trace和Span&lt;/h3&gt;&lt;p&gt;我们在main已经创建了全局Trace，接下来我们只需要在不同业务代码里实现父子Span的创建&lt;/p&gt;
&lt;p&gt;我们以&lt;code&gt;user-service&lt;/code&gt;的&lt;code&gt;handler&lt;/code&gt;和&lt;code&gt;service&lt;/code&gt;为例：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// internal/user-service/handler/handler.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Register implements the UserServiceImpl interface.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterReq&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;resp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterResp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;err&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	startTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 记录指标&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		duration &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Since&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(startTime).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Seconds&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		requestDuration.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Record&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, duration,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			metric.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Register&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;getstatus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		requestCounter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			metric.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Register&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;getstatus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			errorCounter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				metric.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Register&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;getstatus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建span - 从全局获取 tracer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tracer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; otel.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Tracer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 从context生出子Span&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	spanCtx, span &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tracer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Start&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;handler.Register&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// span描述&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		trace.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, req.Username),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 一定要记得关闭span，不然这条tracing会从这里断掉！&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;End&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 可以获取SpanContext，即Span元数据信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//sCtx := trace.SpanContextFromContext(ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//log.Printf(&quot;Handler -&amp;gt; Service, TraceID: %v&quot;, sCtx.TraceID())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 调用下层服务层，传递新的context，即子span的context，用于生成service层的子span&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	newUser, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.UserService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(spanCtx, req.Username, req.Email, req.Password)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;执行注册服务失败：&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//遇到错误，记录在span中&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RecordError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetStatus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(codes.Error, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;执行注册服务失败：&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;service.success&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; resp, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 业务运行成功，记录信息在span中&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, newUser.Username),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, newUser.Email),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;service.success&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resp &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterResp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Success: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		UserID:  newUser.UserID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Msg:     &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;注册成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; resp, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;我们可以从上述代码看到span的使用实例和规范，接下来来到service层：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// internal/user-service/service/service.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;u &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;userServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;username&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;email&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;password&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 获取全局tracer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tracer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; otel.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Tracer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 从handler.span中生出子span和新的context&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	spanCtx, span &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tracer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Start&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;service.Register&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;End&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 一定记住要END！不然链路会断开！&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; username &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; email &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; password &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 记录错误信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RecordError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;关键字段为空&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetStatus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(codes.Error, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;关键字段为空&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;service.success&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;关键字段为空&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Username: username, Email: email, Password: password}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 调用下层dao层，传递新context&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; u.UserRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(spanCtx, user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 记录错误信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RecordError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;添加用户失败: &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetStatus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(codes.Error, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;添加用户失败: &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dao.success&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;添加用户失败: &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 业务流程结束，记录信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, user.Username),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, user.Email),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dao.success&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 生产者发送消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; u.KafkaProducer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		eventData, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Marshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;event_type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;USER_REGISTER&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 明确的事件类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:       user.UserID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:      user.Username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;registered_at&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; u.KafkaProducer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SendUserEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, user.UserID), eventData)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 错误信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RecordError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送用户注册事件失败:user_id:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Itoa&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user.UserID))))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetStatus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(codes.Error, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送用户注册事件失败:user_id:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Itoa&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user.UserID))&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;kafka.success&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送用户注册事件失败:user_id:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, user.UserID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送用户注册事件:user_id:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, user.UserID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 保存业务成功信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	span.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetAttributes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(attribute.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;kafka.success&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;以上，我们完成了链路追踪tracing的实现，api同理&lt;/p&gt;

&lt;h3 id=&quot;article-elk-2&quot;&gt;ELK&lt;/h3&gt;&lt;p&gt;特别地，&lt;strong&gt;使用ELK基本不需要对服务源代码进行修改&lt;/strong&gt;，ELK本身是非嵌入的服务，我们只需要正确配置docker-compose和各组件的配置文件，就能实现分布式日志的观测&lt;/p&gt;
&lt;p&gt;此处我们以如下项目结构为例实现配置：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;ELK-Demo/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── docker/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── config/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   └── logstash&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │   ├── logstash.conf&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │   └── services-template.json&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   ├── elasticsearch.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   ├── filebeat.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   └── kibana.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── ELK/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   └── docker-compose.yaml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── OTel/...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;└── logs/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── api-gateway/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │   └── 2026-03-18/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │       ├── ERR.log&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    │       └── INFO.log&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ├── post-service/...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    └── user-service/...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;首先，我们创建&lt;code&gt;docker-compose.yaml&lt;/code&gt;文件&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;YAML&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;#ELK-Demo/docker/ELK/docker-compose.yaml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;version&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;3.8&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;services&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  elasticsearch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;elasticsearch:8.11.0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;elasticsearch&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    environment&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;discovery.type=single-node&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;ES_JAVA_OPTS=-Xms512m -Xmx512m&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;xpack.security.enabled=false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;xpack.security.enrollment.enabled=false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;bootstrap.memory_lock=false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    ulimits&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      memlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;        soft&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;-1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;        hard&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;-1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;elasticsearch-data:/usr/share/elasticsearch/data&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;../config/elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml:ro&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;9200:9200&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    networks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;elk-network&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    healthcheck&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      test&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;CMD-SHELL&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;curl -s -f http://localhost:9200/_cat/health &amp;gt; /dev/null || exit 1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      interval&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;10s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      timeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;10s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      retries&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;20&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      start_period&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;60s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  kibana&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;kibana:8.11.0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;kibana&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    environment&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;ELASTICSEARCH_HOSTS=http://elasticsearch:9200&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;XPACK_SECURITY_ENABLED=false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;XPACK_ENCRYPTEDSAVEDOBJECTS_ENCRYPTIONKEY=something_at_least_32_characters&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;XPACK_REPORTING_ENCRYPTIONKEY=something_at_least_32_characters&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;../config/kibana.yml:/usr/share/kibana/config/kibana.yml:ro&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;5601:5601&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    networks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;elk-network&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    depends_on&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      elasticsearch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;        condition&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;service_healthy&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    healthcheck&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      test&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;CMD-SHELL&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;curl -s -f http://localhost:5601/api/status &amp;gt; /dev/null || exit 1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      interval&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;10s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      timeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;10s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      retries&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;20&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      start_period&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;60s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  logstash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;logstash:8.11.0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;logstash&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    environment&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;LS_JAVA_OPTS=-Xmx256m -Xms128m&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;XPACK_MONITORING_ENABLED=false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;../config/logstash/logstash.conf:/usr/share/logstash/pipeline/logstash.conf:ro&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;5044:5044&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    networks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;elk-network&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    depends_on&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      elasticsearch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;        condition&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;service_healthy&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    command&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;logstash -f /usr/share/logstash/pipeline/logstash.conf&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    healthcheck&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      test&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;CMD-SHELL&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;curl -s -f http://localhost:9600 &amp;gt; /dev/null || exit 1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      interval&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;10s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      timeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;10s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      retries&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      start_period&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;30s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  filebeat&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;elastic/filebeat:8.11.0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;filebeat&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;root&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;../../logs/:/var/log/services:ro&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;../config/filebeat.yml:/usr/share/filebeat/filebeat.yml:ro&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;filebeat-data:/usr/share/filebeat/data&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    networks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;elk-network&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    depends_on&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      logstash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;        condition&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;service_started&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    restart&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;unless-stopped&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    command&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;filebeat -e -strict.perms=false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    healthcheck&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      test&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;CMD&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;filebeat&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;test&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;config&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      interval&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;10s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      timeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;10s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      retries&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      start_period&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;30s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;networks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  elk-network&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    driver&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;bridge&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    ipam&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;subnet&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;172.20.0.0/16&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;volumes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  elasticsearch-data&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    driver&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;local&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  filebeat-data&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    driver&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;local&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;然后创建&lt;code&gt;Filebeat.yml&lt;/code&gt;配置文件，注意使用合理路径策略正确挂载日志文件&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;YAML&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;##ELK-Demo/docker/config/filebeat.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;######################## Filebeat Configuration ########################&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 采集器全局配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;filebeat.config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  modules&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    path&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${path.config}/modules.d/*.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    reload.enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 自动重载配置（开发环境启用）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;filebeat.autodiscover&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  providers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;docker&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      hints.enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 输出配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;output.logstash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  hosts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;logstash:5044&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  compression_level&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  bulk_max_size&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2048&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  timeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;30s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  ssl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 监控&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;monitoring&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  elasticsearch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    hosts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;http://elasticsearch:9200&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    username&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;elastic&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    password&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;changeme&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 日志&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;logging.level&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;info&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;logging.to_files&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;logging.files&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  path&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/var/log/filebeat&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;filebeat&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  keepfiles&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;7&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  permissions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0644&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;######################## Inputs Configuration ########################&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 修改输入配置，支持子目录和特定文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;filebeat.inputs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  # 用户服务 - 所有 .log 文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;filestream&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    id&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;user-service&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    paths&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/var/log/services/user-service/**/*.log&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    fields&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-service&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    fields_under_root&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    json&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      keys_under_root&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      overwrite_keys&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    tags&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  # 帖子服务 - 所有 .log 文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;filestream&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    id&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;post-service&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    paths&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/var/log/services/post-service/**/*.log&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    fields&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;post-service&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    fields_under_root&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    json&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      keys_under_root&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      overwrite_keys&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    tags&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;post-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  # API 网关 - ERR.log&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;filestream&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    id&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;api-gateway-error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    paths&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/var/log/services/api-gateway/**/ERR.log&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    fields&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;api-gateway&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      log_type&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;error&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    fields_under_root&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    json&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      keys_under_root&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      overwrite_keys&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    tags&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;api-gateway&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  # API 网关 - INFO.log&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;filestream&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    id&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;api-gateway-info&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    paths&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/var/log/services/api-gateway/**/INFO.log&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    fields&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;api-gateway&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      log_type&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;info&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    fields_under_root&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    json&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      keys_under_root&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      overwrite_keys&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    tags&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;api-gateway&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;info&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 处理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;processors&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  - &lt;/span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;drop_fields&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      fields&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;host&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;agent&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;ecs&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;log&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      ignore_missing&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;随后创建logstash.conf配置Logstash，注意合理解析日志文件，此处我们对日志文件是JSON格式，我们要对JSON日志文件内的不同字段名进行合理解析&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;conf&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# ELK-Demo/docker/config/logstash.conf&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;input {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  beats {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    port =&amp;gt; 5044&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;filter {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  grok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    match =&amp;gt; { &quot;message&quot; =&amp;gt; &quot;\[%{DATA:extracted_service}\]\s*(?&amp;lt;json_message&amp;gt;.+)&quot; }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  json {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    source =&amp;gt; &quot;json_message&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    target =&amp;gt; &quot;parsed&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  mutate {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    add_field =&amp;gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      &quot;service&quot; =&amp;gt; &quot;%{[parsed][service]}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      &quot;level&quot; =&amp;gt; &quot;%{[parsed][level]}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      &quot;error_message&quot; =&amp;gt; &quot;%{[parsed][error]}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      &quot;log_message&quot; =&amp;gt; &quot;%{[parsed][message]}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      &quot;caller&quot; =&amp;gt; &quot;%{[parsed][caller]}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    replace =&amp;gt; { &quot;service&quot; =&amp;gt; &quot;%{extracted_service}&quot; }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    remove_field =&amp;gt; [&quot;json_message&quot;, &quot;message&quot;, &quot;parsed&quot;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  date {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    match =&amp;gt; [&quot;[parsed][timestamp]&quot;, &quot;yyyy-MM-dd HH:mm:ss&quot;, &quot;ISO8601&quot;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    target =&amp;gt; &quot;@timestamp&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;output {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  elasticsearch {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    hosts =&amp;gt; [&quot;elasticsearch:9200&quot;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    index =&amp;gt; &quot;services-%{+YYYY.MM.dd}&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  stdout {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    codec =&amp;gt; rubydebug&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;随后创建&lt;code&gt;elasticsearch.yml&lt;/code&gt;进行Elasticsearch配置&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;YAML&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# ELK-Demo/docker/config/elasticsearch/elasticsearch.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 集群设置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;cluster.name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;docker-cluster&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;node.name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;elasticsearch-node-1&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;network.host&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.0.0.0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;http.port&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;9200&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;transport.port&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;9300&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 集群发现 - 单节点模式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;discovery.type&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;single-node&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 内存设置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;bootstrap.memory_lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  # Windows 上必须设置为 false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 路径&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;path.data&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/usr/share/elasticsearch/data&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;path.logs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/usr/share/elasticsearch/logs&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 安全设置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;xpack.security.enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;xpack.security.enrollment.enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;xpack.security.http.ssl.enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;xpack.security.transport.ssl.enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 跨域设置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;http.cors.enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;http.cors.allow-origin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;*&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;http.cors.allow-headers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;X-Requested-With,X-Auth-Token,Content-Type,Content-Length,Authorization&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;http.cors.allow-credentials&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;最后创建&lt;code&gt;kibana.yml&lt;/code&gt;配置kibana可视化&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;YAML&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;server.name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;kibana&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;server.host&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.0.0.0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;server.port&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5601&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;elasticsearch.hosts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;http://elasticsearch:9200&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 安全设置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;xpack.security.enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;xpack.encryptedSavedObjects.encryptionKey&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;something_at_least_32_characters&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;xpack.reporting.encryptionKey&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;something_at_least_32_characters&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 监控&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;monitoring.ui.container.elasticsearch.enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;monitoring.ui.container.logstash.enabled&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 数据视图默认设置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;kibana&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  autocompleteTimeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1000&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  autocompleteTerminateAfter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100000&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;配置完成后，启动docker-compose&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker-compose&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; up&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -d&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这样ELK组件就成功在docker中运行了&lt;/p&gt;
&lt;p&gt;如果遇到错误，可以查看组件健康状态，检查容器日志并让AI分析，一步步排查错误&lt;/p&gt;
&lt;p&gt;一切就绪后，我们就可以访问Kibana Web UI观测日志了：&lt;/p&gt;
&lt;p&gt;Kibana:&lt;strong&gt;&lt;a href=&quot;http://localhost:5601/&quot;&gt;http://localhost:5601&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;进入Kibana UI后，我们要先查看Kibana监控的对象是否包含我们的项目： &lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;左侧菜单栏：&lt;code&gt;Stack Manager -&amp;gt; Data -&amp;gt; Index Management&lt;/code&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;此处我们应该看到我们对service被监控：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/obser1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;随后我们添加数据源：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;左侧菜单栏 &lt;code&gt;Kibana -&amp;gt; Data View -&amp;gt; Create Data View&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;选择需要监控的服务，服务列表位于右侧&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;添加好数据源后，我们返回主页面，在左侧菜单栏&lt;code&gt;discover&lt;/code&gt;里就能看到我们对服务日志了：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/obser2.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;我们可以使用KQL（Kibana查询语句）对日志进行筛选和查找&lt;/p&gt;
&lt;p&gt;比如，我们可以使用&lt;code&gt;level :&quot;error&quot;&lt;/code&gt;查找Level为ERROR级别的日志条目：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/obser3.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;至此，ELK就算完成了&lt;/p&gt;

&lt;h3 id=&quot;article-ui观测-1&quot;&gt;UI观测&lt;/h3&gt;&lt;p&gt;仿照以上步骤，我们写好了微服务全部的代码并开始运行，我们可以通过docker中规定的端口访问Prometheus、Jaeger和Grafana的Web UI，测试可观测性结果并调试程序&lt;/p&gt;

&lt;h4 id=&quot;article-prometheus-2&quot;&gt;Prometheus&lt;/h4&gt;&lt;p&gt;Prometheus: &lt;a href=&quot;http://localhost:8084/&quot;&gt;http://localhost:8084&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;成功的Prometheus指标监控：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/observability4.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;Prometheus监控&lt;code&gt;otel-collector&lt;/code&gt;和自身两个Job&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/observability3.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;我们可以输入在程序中注册的指标名查看指标数据&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;Prometheus有时会自动转义指标名，如在指标名前加&lt;code&gt;otel-&lt;/code&gt;前缀&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-jaeger-2&quot;&gt;Jaeger&lt;/h4&gt;&lt;p&gt;Jaeger: &lt;a href=&quot;http://localhost:8085/&quot;&gt;http://localhost:8085&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;进入Jaeger Web UI后，我们对&lt;code&gt;user-service&lt;/code&gt;的&lt;code&gt;trace&lt;/code&gt;进行查找&lt;/p&gt;
&lt;p&gt;成功的Jaeger Trace：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/observability5.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;我们可以看到Trace里呈父子关系的Span：&lt;code&gt;rpc-handler-service-dao&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/observability6.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;也可以查看span的详细数据&lt;/p&gt;

&lt;h4 id=&quot;article-grafana-2&quot;&gt;Grafana&lt;/h4&gt;&lt;p&gt;除了用Prometheus和Jaeger自带的Web UI，我们也可以使用Grafana Web UI：&lt;/p&gt;
&lt;p&gt;Grafana: &lt;a href=&quot;http://localhost:8086/&quot;&gt;http://localhost:8086&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;初始账号/密码：admin/admin123&lt;/p&gt;
&lt;p&gt;进入Grafana后，我们要新添加数据源：在Connections-Data Sources中搜索并添加Prometheus、Jaeger和ElasticSearch（可选），并使用容器内docker网络连接&lt;code&gt;http://prometheus:9090&lt;/code&gt;和&lt;code&gt;http://jaeger:16686&lt;/code&gt;、&lt;code&gt;http://elasticsearch:9200&lt;/code&gt;&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/observability7.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;添加好数据源后，我们便可以在Explore里进行Metrics和Tracing的检测&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/observability9.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/observability8.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;另外，我们还可以在Dashboard里创建仪表盘或使用别人的仪表盘模板，美化或系统换资源监控界面&lt;/p&gt;

&lt;h2 id=&quot;article-参考资料-1&quot;&gt;参考资料&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://github.com/LanshanTeam/Courseware-Backend-Go-2023/blob/main/lesson17/%E5%90%8E%E7%AB%AF%20Go%20%E7%AC%AC%E5%8D%81%E4%B8%83%E6%AC%A1%E8%AF%BE.md&quot;&gt;Lanshan-Go-2023-lesson17 | 可观测性&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-observability/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>微服务</category><category>分布式</category></item><item><title>请求闸口：反向代理和API网关</title><link>https://www.claran-blog.work/posts/go-APIgateway/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-APIgateway/</guid><description>对反向代理和API网关的介绍.</description><pubDate>Wed, 11 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-引言-1&quot;&gt;引言&lt;/h2&gt;&lt;p&gt;经过前面的学习，我们已经掌握了微服务架构，注册中心，服务治理和消息队列，在步入可观测性和分布式事务之前，我们先来学习，准确地说，回顾一下，反向代理和API网关的内容&lt;/p&gt;

&lt;h2 id=&quot;article-概念简述-1&quot;&gt;概念简述&lt;/h2&gt;
&lt;h3 id=&quot;article-反向代理-1&quot;&gt;反向代理&lt;/h3&gt;&lt;p&gt;首先，我们要知道反向代理是什么&lt;/p&gt;
&lt;p&gt;反向代理是&lt;strong&gt;代理服务器&lt;/strong&gt;的一种。&lt;strong&gt;它接收客户端请求，然后代为转发给内部的后端服务器，并将结果返回给客户端&lt;/strong&gt;。客户端感知不到后端服务器的存在&lt;/p&gt;
&lt;p&gt;反向代理仅实现代为转发，不对请求进行处理等操作&lt;/p&gt;
&lt;p&gt;反向代理可以代理任何HTTP/HTTPS流量，比如一个静态网站、一个PHP应用。它可以隐藏后端，均衡负载，SSL终结，缓存静态内容...&lt;/p&gt;
&lt;p&gt;比较出名的反向代理技术-&lt;code&gt;Nginx&lt;/code&gt;:高性能的HTTP服务器和反向代理&lt;/p&gt;

&lt;h3 id=&quot;article-api网关-1&quot;&gt;API网关&lt;/h3&gt;&lt;p&gt;API网关是一种特殊的反向代理，或者说，是反向代理的超集和演进。它专为API设计，是所有客户端请求的单一入口点。&lt;/p&gt;
&lt;p&gt;API网关在反向代理的基础之上，增加了API生命周期管理：路由、认证授权、限流熔断、监控日志、请求/响应转换、协议转换等&lt;/p&gt;
&lt;p&gt;一个比较好用的API网关工具就是&lt;code&gt;Traefik&lt;/code&gt;一款现代的HTTP反向代理和API网关，天生为微服务和容器设计&lt;/p&gt;

&lt;h2 id=&quot;article-技术实现-1&quot;&gt;技术实现&lt;/h2&gt;&lt;p&gt;其实这一部分的实现，只需要注意学习反向代理工具和API网关的工具的使用即可，对于一个复杂API网关的设计，其实在我们之前的微服务架构和服务治理中已经实现过了，&lt;br /&gt;不过当时我们并没有体系化地行程&lt;code&gt;API网关&lt;/code&gt;这一具体概念，只是将这一模块作为一个&lt;code&gt;api-gateway&lt;/code&gt;的服务去实现的，所以API网关这一块其实已经基本学习地差不多了，或者可以说，API网关的内容只是对之前内容的整理与总结罢了&lt;/p&gt;
&lt;p&gt;既然是整理和总结了，多少还是提一嘴吧&lt;/p&gt;

&lt;h3 id=&quot;article-api网关-2&quot;&gt;API网关&lt;/h3&gt;&lt;p&gt;我们在实现API网关，也就是实现微服务API入口时，通常会包括以下方面：依赖管理、中间件/工具模块初始化、客户端创建、路由注册和管理&lt;/p&gt;
&lt;p&gt;而我们在项目中可以拆分成这么几个结构：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;Project&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  -- api-gateway&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      -- main.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      -- client&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      -- middleware&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      -- routes&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      -- handler&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-main-go-1&quot;&gt;main.go&lt;/h4&gt;&lt;p&gt;&lt;code&gt;main.go&lt;/code&gt;主要负责依赖管理、其他包和工具模块的初始化、注册服务器等功能&lt;/p&gt;

&lt;h4 id=&quot;article-client-1&quot;&gt;client&lt;/h4&gt;&lt;p&gt;&lt;code&gt;client&lt;/code&gt;负责创建并封装rpc客户端、并集成注册中心解析器、熔断器等客户端&lt;/p&gt;

&lt;h4 id=&quot;article-middleware-1&quot;&gt;middleware&lt;/h4&gt;&lt;p&gt;&lt;code&gt;middleware&lt;/code&gt;负责实现中间件方法&lt;/p&gt;

&lt;h4 id=&quot;article-router-1&quot;&gt;router&lt;/h4&gt;&lt;p&gt;&lt;code&gt;router&lt;/code&gt;负责注册路由、或者实现路由分发与管理、中间件注册等方法&lt;/p&gt;

&lt;h4 id=&quot;article-handler-1&quot;&gt;handler&lt;/h4&gt;&lt;p&gt;&lt;code&gt;handler&lt;/code&gt;用于实现各个api路由的处理器方法，封装路由处理器和业务逻辑&lt;/p&gt;

&lt;h3 id=&quot;article-traefik-1&quot;&gt;Traefik&lt;/h3&gt;&lt;p&gt;Traefik可搭配K8s使用，具体方法K8s再细嗦&lt;/p&gt;
&lt;p&gt;实现注册用户注册登录接口的简单示例&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;客户端 → [Traefik/Nginx] → [api-gateway] → Kitex RPC服务&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-traefik-静态配置-1&quot;&gt;Traefik 静态配置&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;YAML&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# traefik/traefik.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;api&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  dashboard&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  debug&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;entryPoints&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  web&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    address&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:80&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    http&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      redirections&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;        entryPoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;          to&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;websecure&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;          scheme&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;https&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  websecure&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    address&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:443&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 自动HTTPS&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;certificatesResolvers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  letsencrypt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    acme&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;admin@yourdomain.com&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      storage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/etc/traefik/acme.json&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      httpChallenge&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;        entryPoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;web&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 日志&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  level&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;INFO&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  filePath&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/var/log/traefik/traefik.log&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;accessLog&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  filePath&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/var/log/traefik/access.log&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  format&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;json&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  bufferingSize&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 提供者配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;providers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  docker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;unix:///var/run/docker.sock&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    exposedByDefault&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    network&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;traefik-network&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  file&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    filename&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/etc/traefik/dynamic/config.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    watch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 指标&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;metrics&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  prometheus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    entryPoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;metrics&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    addRoutersLabels&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    addServicesLabels&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;tracing&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  jaeger&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    samplingServerURL&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;http://jaeger:5778/sampling&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    localAgentHostPort&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;jaeger:6831&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-traefik-动态配置-1&quot;&gt;Traefik 动态配置&lt;/h4&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# traefik/dynamic/config.yml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;http:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  # 全局中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  middlewares:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 限流中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    rate-limit:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      rateLimit:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        average: 10&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        burst: 20&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        sourceCriterion:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          ipStrategy: {}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 熔断中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    circuit-breaker:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      circuitBreaker:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        expression: &quot;LatencyAtQuantileMS(50.0) &amp;gt; 100&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 添加安全头&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    security-headers:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      headers:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        frameDeny: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        sslRedirect: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        browserXssFilter: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        contentTypeNosniff: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        forceSTSHeader: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        stsIncludeSubdomains: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        stsPreload: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        stsSeconds: 31536000&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  # 路由配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  routers:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 用户登录路由&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    user-login:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      rule: &quot;Host(`api.yourdomain.com`) &amp;amp;&amp;amp; PathPrefix(`/user/login`)&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      entryPoints:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - websecure&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      middlewares:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - rate-limit&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - compress&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - security-headers&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      service: hertz-service&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      tls:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        certResolver: letsencrypt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        options: default&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      priority: 100&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 用户注册路由&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    user-register:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      rule: &quot;Host(`api.yourdomain.com`) &amp;amp;&amp;amp; PathPrefix(`/user/register`)&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      entryPoints:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - websecure&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      middlewares:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - rate-limit&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - compress&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - security-headers&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      service: hertz-service&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      tls:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        certResolver: letsencrypt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      priority: 100&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # Dashboard路由（受保护）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    traefik-dashboard:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      rule: &quot;Host(`traefik.yourdomain.com`)&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      entryPoints:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - websecure&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      middlewares:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - basic-auth&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        - ip-whitelist&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      service: api@internal&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      tls:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        certResolver: letsencrypt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  # 服务配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;  services:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    hertz-service:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      loadBalancer:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        healthCheck:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          path: /health&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          interval: 10s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          timeout: 3s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        servers:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          - url: &quot;http://hertz-service:8080&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        passHostHeader: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        stickiness:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;          cookie:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            name: _stickiness&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            httpOnly: true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            secure: true&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-使用-1&quot;&gt;使用&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 创建项目目录&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;mkdir&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; traefik-project/{traefik/dynamic,hertz-service}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;cd&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; traefik-project&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 创建配置文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 创建上面提到的各个配置文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 启动服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker-compose&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; up&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -d&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 查看日志&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker-compose&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; logs&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -f&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; hertz-service&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 测试&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;curl&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -X&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; POST&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; https://api.yourdomain.com/user/register&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -H&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;Content-Type: application/json&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &apos;{&quot;username&quot;:&quot;test&quot;,&quot;password&quot;:&quot;123456&quot;,&quot;email&quot;:&quot;test@example.com&quot;}&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 查看Traefik Dashboard&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 访问 https://traefik.yourdomain.com&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-nginx-1&quot;&gt;Nginx&lt;/h3&gt;&lt;p&gt;实现注册用户注册登录接口的简单示例&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;客户端 → [Traefik/Nginx] → [api-gateway] → Kitex RPC服务&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-基础配置-nginx-conf-1&quot;&gt;基础配置（nginx.conf）&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;conf&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# /etc/nginx/nginx.conf&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;user nginx;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;worker_processes auto;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;error_log /var/log/nginx/error.log warn;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;pid /var/run/nginx.pid;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;events {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    worker_connections 1024;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    use epoll;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    multi_accept on;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;http {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    include /etc/nginx/mime.types;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    default_type application/octet-stream;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 日志格式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    log_format main &apos;$remote_addr - $remote_user [$time_local] &quot;$request&quot; &apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                    &apos;$status $body_bytes_sent &quot;$http_referer&quot; &quot;$http_user_agent&quot; &apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;                    &apos;&quot;$http_x_forwarded_for&quot; $request_time $upstream_response_time&apos;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    access_log /var/log/nginx/access.log main;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 基础优化&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    sendfile on;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    tcp_nopush on;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    tcp_nodelay on;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    keepalive_timeout 65;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    types_hash_max_size 2048;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # Gzip压缩&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    gzip on;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    gzip_min_length 1k;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    gzip_comp_level 5;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    gzip_types text/plain text/css application/json application/javascript text/xml;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 包含微服务配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    include /etc/nginx/conf.d/*.conf;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-微服务路由配置-1&quot;&gt;微服务路由配置&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;conf&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;# /etc/nginx/conf.d/microservice.conf&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# 用户服务上游&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;upstream user-service {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 如果你的Hertz服务是多实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    server 127.0.0.1:8080 weight=3;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    server 127.0.0.1:8081 weight=2;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    server 127.0.0.1:8082 weight=1;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 健康检查&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 注：基础版Nginx需要手动配置，或使用nginx-plus/第三方模块&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# 全局限流设置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;limit_req_zone $server_name zone=global_limit:10m rate=100r/s;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;server {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    listen 80;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    server_name api.yourdomain.com;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 全局限流&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    limit_req zone=global_limit burst=200 nodelay;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 用户登录接口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    location = /user/login {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        # 针对登录接口的特殊限流（防止暴力破解）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        limit_req zone=api_limit burst=5 nodelay;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        limit_req_status 429;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        # 转发到Hertz服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_pass http://user-service/user/login;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        # 代理头设置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_set_header Host $host;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_set_header X-Real-IP $remote_addr;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_set_header X-Forwarded-Proto $scheme;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        # 超时设置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_connect_timeout 5s;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_send_timeout 10s;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_read_timeout 30s;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        # 缓冲设置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_buffer_size 4k;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_buffers 8 4k;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_busy_buffers_size 8k;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        # 允许跨域&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        add_header &apos;Access-Control-Allow-Origin&apos; &apos;*&apos; always;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        add_header &apos;Access-Control-Allow-Methods&apos; &apos;GET, POST, OPTIONS&apos; always;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        add_header &apos;Access-Control-Allow-Headers&apos; &apos;DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization&apos; always;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 用户注册接口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    location = /user/register {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        limit_req zone=api_limit burst=3 nodelay;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        limit_req_status 429;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_pass http://user-service/user/register;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_set_header Host $host;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_set_header X-Real-IP $remote_addr;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        # 更大的body&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        client_max_body_size 10m;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_connect_timeout 5s;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_read_timeout 30s;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 健康检查端点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    location = /health {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        access_log off;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_pass http://user-service/health;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_set_header Host $host;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 默认路由&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    location /api/v1/ {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        # 匹配 /api/v1/user/login 等&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        rewrite ^/api/v1/(.*)$ /$1 break;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_pass http://user-service;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_set_header Host $host;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_set_header X-Real-IP $remote_addr;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        # 添加API版本头&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        proxy_set_header X-API-Version v1;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 静态文件服务（如有）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    location /static/ {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        root /var/www/static;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        expires 1y;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        add_header Cache-Control &quot;public, immutable&quot;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        # 防盗链&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        valid_referers none blocked server_names ~\.yourdomain\.com;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        if ($invalid_referer) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;            return 403;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # SSL重定向（如果启用HTTPS）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # location / {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    #     return 301 https://$server_name$request_uri;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;# HTTPS配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;server {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    listen 443 ssl http2;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    server_name api.yourdomain.com;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ssl_certificate /etc/nginx/ssl/yourdomain.com.crt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ssl_certificate_key /etc/nginx/ssl/yourdomain.com.key;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ssl_protocols TLSv1.2 TLSv1.3;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ssl_prefer_server_ciphers off;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # SSL会话缓存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ssl_session_cache shared:SSL:10m;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ssl_session_timeout 10m;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # HSTS&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    add_header Strict-Transport-Security &quot;max-age=31536000; includeSubDomains&quot; always;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    # 复用HTTP配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    include /etc/nginx/conf.d/microservice_http.conf;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-使用-2&quot;&gt;使用&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 安装Nginx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sudo&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; apt-get&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; nginx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 备份默认配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sudo&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; mv&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; /etc/nginx/sites-available/default&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; /etc/nginx/sites-available/default.bak&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 创建配置文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sudo&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; vim&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; /etc/nginx/conf.d/microservice.conf&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 粘贴上面的Nginx配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 测试配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sudo&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; nginx&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -t&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 重载Nginx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sudo&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; systemctl&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; reload&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; nginx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 启动你的Hertz服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;cd&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; hertz-service&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; main.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 测试&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;curl&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -X&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; POST&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; http://localhost/user/login&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;-H &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Content-Type: application/json&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;-d &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;{&quot;username&quot;:&quot;test&quot;,&quot;password&quot;:&quot;123456&quot;}&apos;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-APIgateway/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>微服务</category><category>分布式</category></item><item><title>消息队列：从理论到Kafka实践</title><link>https://www.claran-blog.work/posts/go-MQ/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-MQ/</guid><description>消息队列概念解析和实践.</description><pubDate>Mon, 09 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;blockquote&gt;
&lt;p&gt;首先祝我生日快乐（）&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2 id=&quot;article-消息队列-1&quot;&gt;消息队列&lt;/h2&gt;&lt;p&gt;紧跟之前的内容，这次我们学习&lt;strong&gt;消息队列&lt;/strong&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-概念解析-1&quot;&gt;概念解析&lt;/h3&gt;&lt;p&gt;消息队列是一种&lt;strong&gt;异步通信&lt;/strong&gt;机制，用于在&lt;strong&gt;分布式系统&lt;/strong&gt;中&lt;strong&gt;解耦&lt;/strong&gt;发送方和接收方之间的通信。&lt;br /&gt;它通过在消息生产者和消费者之间引入一个中间缓冲区（常见为 broker），将消息存储在 broker 中，然后由消费者从 broker 中读取和处理消息。&lt;/p&gt;

&lt;h4 id=&quot;article-用法解析-1&quot;&gt;用法解析&lt;/h4&gt;&lt;p&gt;消息队列通常有三大用处：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;异步通信&lt;/strong&gt;：发送消息-处理消息-返回响应 不再是单一的线性结构&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;限流削峰&lt;/strong&gt;： 高流量是把任务消息缓冲在消息队列中，而不是立即处理&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;服务解耦&lt;/strong&gt;：生产者和消费者不再互相影响，彻底解耦，可各自独立拓展&lt;/li&gt;
&lt;/ul&gt;
&lt;blockquote&gt;
&lt;p&gt;当不需要立即获得结果，但是并发量又需要进行控制的时候，大概就是需要使用消息队列的时候&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h5 id=&quot;article-异步通信-1&quot;&gt;异步通信&lt;/h5&gt;&lt;p&gt;在常规的微服务中，存在两种通信方式：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;同步通信&lt;/strong&gt;：即一个任务流程为固定的线性消息传递，并在最后一个任务完成后依次向上传递消息给客户端&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/mq1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;这样的信息传递方式较慢，假设每个服务需要200ms处理时间，那么这次请求一共会占用（200*n）ms的处理时间&lt;br /&gt;。并且要在到达最底层才能原路返回信息&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;消息队列(异步通信)&lt;/strong&gt;：当需要派发任务时，把派发信息传入消息队列中，然后消息队列异步分发任务并收集信息，被封发的任务会异步处理&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/mq2.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;这种方式使用更少的处理时间（变为木桶效应），并在写入消息队列后立即返回成功给客户端，则总的响应时间依赖于写入消息队列的时间&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;blockquote&gt;
&lt;p&gt;严谨地说，是消息队列采用了异步通信的机制，并在异步通信的基础上使用消息队列缓冲处理，总的处理时间相比串行提高了2倍，相比并行提高了一倍&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h5 id=&quot;article-限流削峰-1&quot;&gt;限流削峰&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;消息队列可以做服务通信的缓冲&lt;/strong&gt;，广泛应用于秒杀或抢购活动中，避免流量过大导致应用系统挂掉的情况；&lt;/p&gt;
&lt;p&gt;具体场景：购物网站开展秒杀活动，一般由于瞬时访问量过大，服务器接收过大，会导致流量暴增，相关系统无法处理请求甚至崩溃。而加入消息队列后，系统可以从消息队列中取数据，相当于消息队列做了一次缓冲。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/mq5.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;该方法有如下优点：&lt;/p&gt;
&lt;p&gt;请求先入消息队列，而不是由业务处理系统直接处理，做了一次缓冲,极大地减少了业务处理系统的压力；&lt;br /&gt;队列长度可以做限制，事实上，秒杀时，后入队列的用户无法秒杀到商品，这些请求可以直接被抛弃，返回活动已结束或商品已售完信息；&lt;/p&gt;

&lt;h5 id=&quot;article-服务解耦-1&quot;&gt;服务解耦&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;消息队列将服务发送方和接收方解耦&lt;/strong&gt;，也就是说，&lt;br /&gt;如果需要加新业务，只需要订阅消息队列的消息，不用去修改其他模块的代码，多应用间通过消息队列对同一消息进行处理，避免调用接口失败导致整个过程失败&lt;/p&gt;
&lt;p&gt;如图所示：&lt;/p&gt;
&lt;p&gt;不使用消息队列&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/mq3.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;使用消息队列&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/mq4.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;此时图片上传系统并不需要关心人脸识别系统是否对这些图片信息的处理、以及何时对这些图片信息进行处理。事实上，由于用户并不需要立即知道人脸识别结果，人脸识别系统可以选择不同的调度策略，按照闲时、忙时、正常时间，对队列中的图片信息进行处理&lt;/p&gt;

&lt;h4 id=&quot;article-消息队列的系统-1&quot;&gt;消息队列的系统&lt;/h4&gt;&lt;p&gt;消息队列的系统将不同服务分为消息队列、消息生产者、消息消费者（与协程池类似）&lt;/p&gt;
&lt;p&gt;该方法有如下优点：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;避免了直接调用下一个系统导致当前系统失败；&lt;/li&gt;
&lt;li&gt;每个子系统对于消息的处理方式可以更为灵活，可以选择收到消息时就处理，可以选择定时处理，也可以划分时间段按不同处理速度处理；&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-消息队列模型分类-1&quot;&gt;消息队列模型分类&lt;/h4&gt;&lt;p&gt;消息队列分为两种模型：Queue与Topic&lt;/p&gt;

&lt;h5 id=&quot;article-queue-peer-to-peer-1&quot;&gt;Queue（Peer-to-Peer）&lt;/h5&gt;&lt;p&gt;简称&lt;strong&gt;PTP队列模式&lt;/strong&gt;，在该模式下，&lt;strong&gt;一条消息只能有一位生产者和一位消费者&lt;/strong&gt;，即消息在注册时只能由特定的消费者消费&lt;/p&gt;
&lt;p&gt;在该模式下，工作流程/原理如下：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;消息生产者&lt;code&gt;Producer1&lt;/code&gt;生产消息到&lt;code&gt;Queue&lt;/code&gt;，然后&lt;code&gt;Consumer1&lt;/code&gt;从&lt;code&gt;Queue&lt;/code&gt;中取出并且消费消息。&lt;/li&gt;
&lt;li&gt;消息被消费后，&lt;code&gt;Queue&lt;/code&gt;将不再存储消息，其它所有&lt;code&gt;Consumer&lt;/code&gt;不可能消费到已经被其它&lt;code&gt;Consumer&lt;/code&gt;消费过的消息。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Queue&lt;/code&gt;支持存在多个&lt;code&gt;Producer&lt;/code&gt;，但是对一条消息而言，只会有一个&lt;code&gt;Consumer&lt;/code&gt;可以消费，其它&lt;code&gt;Consumer&lt;/code&gt;则不能再次消费。&lt;/li&gt;
&lt;li&gt;但&lt;code&gt;Consumer&lt;/code&gt;不存在时，消息则由&lt;code&gt;Queue&lt;/code&gt;一直保存，直到有&lt;code&gt;Consumer&lt;/code&gt;把它消费。&lt;/li&gt;
&lt;/ol&gt;

&lt;h5 id=&quot;article-topic-publish-subscribe-1&quot;&gt;Topic（Publish/Subscribe）&lt;/h5&gt;&lt;p&gt;简称&lt;strong&gt;发布/订阅模式&lt;/strong&gt;，在该模式下，&lt;strong&gt;消息会携带主题（Topic），而所有订阅了该主题的消费者都可以接受到该消息并消费&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;在该模式下，工作流程/原理如下： &lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;消息发布者&lt;code&gt;Publisher&lt;/code&gt;将消息发布到主题&lt;code&gt;Topic&lt;/code&gt;中，同时有多个消息消费者&lt;code&gt;Subscriber&lt;/code&gt;消费该消息。&lt;/li&gt;
&lt;li&gt;和PTP方式不同，发布到&lt;code&gt;Topic&lt;/code&gt;的消息会被所有订阅者消费。&lt;/li&gt;
&lt;li&gt;当发布者发布消息，不管是否有订阅者，都不会报错信息。&lt;/li&gt;
&lt;li&gt;一定要先有消息发布者，后有消息订阅者。&lt;/li&gt;
&lt;/ol&gt;
&lt;blockquote&gt;
&lt;p&gt;Kafka所采用的就是发布/订阅模式，被称为一种高吞吐量、持久性、分布式的发布订阅的消息队列系统&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2 id=&quot;article-消息队列常见问题与应对-1&quot;&gt;消息队列常见问题与应对&lt;/h2&gt;
&lt;h3 id=&quot;article-消息丢失-1&quot;&gt;消息丢失&lt;/h3&gt;&lt;p&gt;要保证在完整的消息队列流程中做到消息不丢失，我们需要保证生产者，消费者和broker三方配合：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;producer&lt;/code&gt;需要处理好&lt;code&gt;Broker&lt;/code&gt;的响应，出错情况下利用重试、报警等手段&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Broker&lt;/code&gt;需要控制响应的时机，单机情况下是消息刷盘后返回响应，集群多副本情况下，即发送至两个副本及以上的情况下再返回响应&lt;/li&gt;
&lt;li&gt;&lt;code&gt;consumer&lt;/code&gt;需要在执行完真正的业务逻辑之后再返回响应给&lt;code&gt;Broker&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;但是&lt;strong&gt;消息可靠性的增强伴随着性能的下降&lt;/strong&gt;，等待消息刷盘、多副本同步后返回都会影响性能。因此具体情况由具体业务分析，例如日志的传输可能丢那么一两条关系不大，因此没必要等消息刷盘再响应&lt;/p&gt;

&lt;h3 id=&quot;article-重复消息-1&quot;&gt;重复消息&lt;/h3&gt;&lt;p&gt;在使用消息队列中难免会遇到消息重复的现象：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;当消息发到&lt;code&gt;Broker&lt;/code&gt;上，等待&lt;code&gt;Broker&lt;/code&gt;响应的过程中，可能存在&lt;code&gt;Broker&lt;/code&gt;已经写入，但由于网络原因生产者没有即使收到响应，使得生产者又重发了一次，此时就产生了重复消息&lt;/li&gt;
&lt;li&gt;当消费者消费消息后更新&lt;code&gt;Consumer offset&lt;/code&gt;时挂了，并另一个消费者顶上时，&lt;code&gt;Consumer offset&lt;/code&gt;还没更新，于是新消费者又拿到刚才那条消息，业务又被执行了一遍。又产生了信息重复&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;因此正常业务的消息重复是不可避免的，因此我们只能从另一个角度来解决重复消息的问题：&lt;strong&gt;保证业务流程的幂等性&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;早在学习数据库时我们便已经了解了幂等性这一概念，即同样的参数多次调用同一个接口和调用一次产生的结果一致&lt;/p&gt;
&lt;p&gt;具体如何保证幂等或者使用其他方式处理重复消息，还是需要根据具体业务需求灵活对策&lt;/p&gt;

&lt;h3 id=&quot;article-消息的有序性-1&quot;&gt;消息的有序性&lt;/h3&gt;
&lt;h4 id=&quot;article-什么是消息有序性-1&quot;&gt;什么是消息有序性？&lt;/h4&gt;&lt;p&gt;消息有序性指的是&lt;strong&gt;消息被消费的顺序与它们被发送的顺序保持一致&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;假设有一个订单状态变更的场景：&lt;code&gt;订单创建 → 支付成功 → 发货 → 确认收货 → 订单完成&lt;/code&gt;,&lt;br /&gt;如果消息乱序到达，比如先收到&quot;发货&quot;，后收到&quot;支付成功&quot;，这就会导致业务逻辑错误&lt;/p&gt;

&lt;h4 id=&quot;article-为什么会产生消息有序性错误-1&quot;&gt;为什么会产生消息有序性错误？&lt;/h4&gt;&lt;p&gt;消息队列为了提高并发性能，通常会采用以下设计：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;多生产者/消费者&lt;/li&gt;
&lt;li&gt;多分区/队列&lt;/li&gt;
&lt;li&gt;异步处理&lt;/li&gt;
&lt;li&gt;重试机制&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;这些设计导致消息可能不按顺序被处理&lt;/p&gt;

&lt;h4 id=&quot;article-如何保证消息有序性-1&quot;&gt;如何保证消息有序性？&lt;/h4&gt;&lt;p&gt;我们通常使用&lt;strong&gt;部分有序&lt;/strong&gt;来保证消息有序需求&lt;/p&gt;
&lt;p&gt;即只保证同一&quot;组&quot;内的消息有序，不同组之间可以并行&lt;/p&gt;
&lt;p&gt;实现思路：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;将需要顺序的消息分组（如按订单ID、用户ID等）&lt;/li&gt;
&lt;li&gt;同组消息发送到同一个队列&lt;/li&gt;
&lt;li&gt;每个队列有且只有一个消费者单线程处理&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;这样就能在一定程度上保证消息只能以一定的顺序被接收&lt;/p&gt;

&lt;h3 id=&quot;article-消息堆积-1&quot;&gt;消息堆积&lt;/h3&gt;&lt;p&gt;消息的堆积往往是因为生产者的生产速度与消费者的消费速度不匹配。&lt;br /&gt;或者因为消息消费失败反复重试造成，也有可能就是消费者消费能力弱，渐渐地消息就积压了&lt;/p&gt;
&lt;p&gt;因此我们需要先定位消费慢的原因，如果是bug则处理 bug ，如果是因为本身消费能力较弱，我们可以优化下消费逻辑，比如之前是一条一条消息消费处理的，这次我们批量处理，比如数据库的插入，一条一条插和批量插效率是不一样的。&lt;/p&gt;
&lt;p&gt;假如逻辑我们已经都优化了，但还是慢，那就得考虑水平扩容了，增加Topic的队列数和消费者数量，注意队列数一定要增加，不然新增加的消费者是没东西消费的。一个Topic中，一个队列只会分配给一个消费者&lt;/p&gt;

&lt;h2 id=&quot;article-选型-实践-1&quot;&gt;选型&amp;amp;实践&lt;/h2&gt;&lt;p&gt;常见消息队列：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/mq6.png&quot; alt=&quot;mq6.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;接下来我们以Kafka为例进行项目中集成消息队列的实战&lt;/p&gt;

&lt;h3 id=&quot;article-概述-1&quot;&gt;概述&lt;/h3&gt;&lt;p&gt;&lt;code&gt;Kafka&lt;/code&gt;是&lt;code&gt;Apache&lt;/code&gt;旗下的一款分布式流媒体平台，&lt;code&gt;Kafka&lt;/code&gt;是一种高吞吐量、持久性、分布式的发布订阅的消息队列系统。 它最初由&lt;code&gt;LinkedIn&lt;/code&gt;(领英)公司发布，使用&lt;code&gt;Scala&lt;/code&gt;语言编写，与2010年12月份开源，成为&lt;code&gt;Apache&lt;/code&gt;的顶级子项目&lt;/p&gt;
&lt;p&gt;&lt;code&gt;Kafka&lt;/code&gt;三大特点:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;高吞吐量：可以满足每秒百万级别消息的生产和消费&lt;/li&gt;
&lt;li&gt;持久性：有一套完善的消息存储机制，确保数据高效安全且持久化&lt;/li&gt;
&lt;li&gt;分布式：基于分布式的扩展；&lt;code&gt;Kafka&lt;/code&gt;的数据都会复制到几台服务器上，当某台故障失效时，生产者和消费者转而使用其它的&lt;code&gt;Kafka&lt;/code&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;概念介绍&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Producer&lt;/strong&gt;：消息和数据的生产者，主要负责生产Push消息到指定的Topic中。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Consumer&lt;/strong&gt;：消息和数据的消费者，主要负责主动到已订阅的Topic中拉取消息并消费。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Broker&lt;/strong&gt;：Kafka节点就是被称为Broker，Broker主要负责创建Topic，存储Producer所发布的消息，记录消息处理的过程，现是将消息保存到内存中，然后持久化到磁盘。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Topic&lt;/strong&gt;：同一个Topic的消息可以分布在一个或多个Broker上，一个Topic包含一个或者多个Partition分区，数据被存储在多个Partition中。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Partition&lt;/strong&gt;：分区，在这里被称为Topic物理上的分组，一个Topic在Broker中被分为1个或者多个Partition，也可以说为每个Topic包含一个或多个Partition，分区在创建Topic的时候可以指定。分区才是真正存储数据的单元。&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-连接kafka集群-1&quot;&gt;连接Kafka集群&lt;/h3&gt;&lt;p&gt;一个Kafka集群是由下列几种类型的节点构成的，它们充当着不同的作用：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Broker节点：即代理节点，是Kafka中的工作节点，充当消息队列的角色，负责储存和处理消息，每个Broker都是一个独立的Kafka服务器，可以在不同的机器上运行，除此之外Broker还负责分区（partition）的管理，将主题（topic）划分为多个分区，并分布在集群的不同Broker上&lt;/li&gt;
&lt;li&gt;Controller节点：即控制器节点，是集群中的特殊节点，负责储存和管理整个集群元数据和状态，它能够监控整个集群中的Broker，在需要时还能够进行平衡操作&lt;/li&gt;
&lt;li&gt;混合节点：即同时担任Broker和Controller节点角色的节点&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;部署Kafka集群可用两种模式：Zookeeper模式或KRaft模式集群&lt;/p&gt;

&lt;h4 id=&quot;article-zookeeper模式集群-1&quot;&gt;Zookeeper模式集群&lt;/h4&gt;&lt;p&gt;Zookeeper是简单、传统的集群搭建方式，在这种模式下，每个Kafka节点都是依赖于Zookeeper的，使用Zookeeper存储集群中所有节点的元数据&lt;/p&gt;
&lt;p&gt;但该模式增加了运维成本（需要额外保护Zookeeper），且Zookeeper是强一致性的组件（符合CP理论），如果集群中数据发生变化，那么必须要等到其它节点都同步，至少超过一半同步完成，这样节点数多性能差&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;社区趋势：Kafka 4.0 后将完全移除 ZooKeeper 依赖&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-kraft模式集群-1&quot;&gt;KRaft模式集群&lt;/h4&gt;&lt;p&gt;KRaft模式是新版本Kafka中推出的集群模式，只需要数个Kafka节点就可以直接构成集群&lt;/p&gt;
&lt;p&gt;在这时集群中的Kafka节点既有可能是Controller节点也可能是Broker节点，在这个模式中，我们不仅可以手动配置某个节点的角色（是Controller还是Broker），还可以使其同时担任Broker和Controller角色（混合节点）&lt;/p&gt;

&lt;h3 id=&quot;article-实践-1&quot;&gt;实践&lt;/h3&gt;
&lt;h4 id=&quot;article-部署-1&quot;&gt;部署&lt;/h4&gt;&lt;p&gt;Kafka在2.8版本正式移除了对Zookeeper的依赖,此处我们部署单节点kafka&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;需要注意的是，Bitnami官方近期调整了镜像分发策略。自2026年2月起，Bitnami核心安全镜像（包括Kafka、Redis、MySQL等）已全面取消Docker Hub的免费下载服务，需要商业订阅才能获取，不过轩辕镜像仓库提供了Bitnami Legacy全品类旧版遗留镜像的免费拉取服务，所以此处我们使用轩辕仓库的镜像&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;创建&lt;code&gt;docker-compose.yaml&lt;/code&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;YAML&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;version&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;3.5&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;services&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  kafka1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    image&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;docker.xuanyuan.run/bitnamilegacy/kafka:3.3.2-debian-11-r11&apos;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    container_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;kafka1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;root&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    ports&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;9092:9092&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;9093:9093&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    environment&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      KAFKA_ENABLE_KRAFT&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;yes&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 允许使用kraft，即Kafka替代Zookeeper&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      KAFKA_CFG_PROCESS_ROLES&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;broker,controller&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # kafka角色，做broker，也要做controller&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      KAFKA_CFG_CONTROLLER_LISTENER_NAMES&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;CONTROLLER&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 指定供外部使用的控制类请求信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      KAFKA_CFG_LISTENERS&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;PLAINTEXT://:9092,CONTROLLER://:9093&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 定义kafka服务端socket监听端口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      KAFKA_CFG_LISTENER_SECURITY_PROTOCOL_MAP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;CONTROLLER:PLAINTEXT,PLAINTEXT:PLAINTEXT&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 定义安全协议&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      KAFKA_KRAFT_CLUSTER_ID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;LelM2dIFQkiUFvXCEcqRWA&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 使用Kafka时的集群id，集群内的Kafka都要用这个id做初始化，生成一个UUID即可&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      KAFKA_CFG_CONTROLLER_QUORUM_VOTERS&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;1@kafka1:9093&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 集群地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      ALLOW_PLAINTEXT_LISTENER&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;yes&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 允许使用PLAINTEXT监听器，默认false，不建议在生产环境使用&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      KAFKA_HEAP_OPTS&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;-Xmx512M -Xms256M&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 设置broker最大内存，和初始内存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      KAFKA_CFG_AUTO_CREATE_TOPICS_ENABLE&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 禁止自动创建主题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      KAFKA_CFG_ADVERTISED_LISTENERS&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;PLAINTEXT://localhost:9092&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 定义外网访问地址（宿主机ip地址和端口）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      KAFKA_BROKER_ID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # broker.id，必须唯一&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;      KAFKA_CFG_NODE_ID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;1&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    volumes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      - &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;kafka1_data:/bitnami/kafka&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;#      extra_hosts:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;#          - &quot;kafka1:云服务器IP&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;#          - &quot;kafka2:云服务器IP&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;#          - &quot;kafka3:云服务器IP&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;volumes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  kafka1_data&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;然后启动&lt;code&gt;docker-compose&lt;/code&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker-compose&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; up&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -d&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这样Kafka就会运行在docker中了&lt;/p&gt;

&lt;h4 id=&quot;article-在项目中集成-1&quot;&gt;在项目中集成&lt;/h4&gt;&lt;p&gt;有很多可以操作kafka的第三方库，比如&lt;code&gt;sarama&lt;/code&gt;和&lt;code&gt;kafka-go&lt;/code&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-消息队列使用指南-1&quot;&gt;消息队列使用指南&lt;/h5&gt;&lt;p&gt;在集成消息队列之前，我们先要知道：有那些部件需要集成消息队列？在某个地方集成消息队列的意义是什么？集成消息队列时要注意什么？特别&lt;strong&gt;不能为了用消息队列而用消息队列&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;我们已经知道，消息队列的作用是削峰限流、异步通信和服务间解耦，那么我们在集成消息队列时也应该围绕这几方面进行集成&lt;/p&gt;
&lt;p&gt;下面我们以一个最简单的微服务举例，该微服务项目只包含用户模块、帖子模块和互动模块，且只有用户登录、注册、获取/更新信息 | 帖子发布、删除、获取/更新信息 | 互动的点赞帖子、关注用户等api，具体无关的业务细节我们省略掉&lt;/p&gt;
&lt;p&gt;那么我们就要设计消息路径：当发生用户注册等事件时，封装事件消息到消息队列，帖子服务接收该消息并创建欢迎帖子。当发生点赞事件时，封装事件消息到消息队列，帖子服务和用户服务接收消息并更新帖子/用户信息...&lt;/p&gt;
&lt;p&gt;为了让消费者知道消息具体指向的方法，我们需要在消息中封装&lt;code&gt;Event&lt;/code&gt;，并把不同的方法逻辑封装为不同的&lt;code&gt;Event&lt;/code&gt;关键字，通俗的说，我们需要让消费者听懂消息内容&lt;/p&gt;
&lt;p&gt;例如，我们想让&lt;code&gt;post-service&lt;/code&gt;接收到来自&lt;code&gt;user-service&lt;/code&gt;的注册消息，就创建&lt;code&gt;event&lt;/code&gt;字段&lt;code&gt;USER_REGISTERED&lt;/code&gt;，当&lt;code&gt;post-service&lt;/code&gt;监听到主题为&lt;code&gt;user&lt;/code&gt;的消息并解析到&lt;code&gt;event&lt;/code&gt;为&lt;code&gt;USER_REGISTERED&lt;/code&gt;时，实现对应方法&lt;/p&gt;
&lt;p&gt;在这样的一个微服务项目里集成消息队列，我们可以先写一个消息队列公共方法包：&lt;/p&gt;

&lt;h5 id=&quot;article-公共方法包-1&quot;&gt;公共方法包&lt;/h5&gt;&lt;p&gt;这里我们使用&lt;code&gt;kafka-go&lt;/code&gt;，并学习DaWeSen大佬的pkg写法&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; mq&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/segmentio/kafka-go&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/segmentio/kafka-go/compress&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 生产者结构体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Producer&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	writer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Writer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	topics &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	mu     &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RWMutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 消费者结构体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Consumer&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	reader &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Reader&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	topic  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 记录消费的主题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	group  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 记录消费者组&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 消息结构体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Message&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Topic     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `json:&quot;topic&quot;`&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;     // 主题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Key       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `json:&quot;key&quot;`&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;       // 消息键&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Value     []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `json:&quot;value&quot;`&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;     // 消息体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Partition &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;       `json:&quot;partition&quot;`&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 分区&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Offset    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;     `json:&quot;offset&quot;`&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 偏移量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Time      &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;time&quot;`&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;      // 时间戳&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Headers   []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  `json:&quot;headers&quot;`&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;   // 消息头&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 消息头结构&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Header&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Key   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;key&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Value &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;value&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 生产者单例实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	producerInstance &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	producerOnce     &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Once&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	initErr          &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 记录初始化错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; KafkaCfg&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Brokers []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Topics   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Topic&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Version &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Topic&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	post &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 获取生产者单例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewProducer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	producerOnce.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Do&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		kafkaConfig &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;KafkaCfg&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Brokers: []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:9092&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Topics:   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Topic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{user: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-events&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, post: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;post-events&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Version: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;2.8.0&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 验证配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(kafkaConfig.Brokers) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			initErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;KafkaCfg brokers配置为空&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 初始化生产者&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		producerInstance, initErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; initProducer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(kafkaConfig.Brokers, kafkaConfig.Version)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; initErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;初始化Kafka生产者失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, initErr)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 缓存主题映射&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		producerInstance.topics &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;user&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:        kafkaConfig.Topics.user,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;post&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:        kafkaConfig.Topics.post,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 异步创建主题（不阻塞启动）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			ctx, cancel &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithTimeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;30&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			defer&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; cancel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; createTopics&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;kafkaConfig); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;异步创建Kafka主题失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			} &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Kafka主题创建/验证完成&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; producerInstance, initErr&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始化生产者&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; initProducer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;brokers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;version&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建Kafka Writer配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	writer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Writer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Addr:         kafka.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TCP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(brokers&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 连接地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Balancer:     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Hash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{},          &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 使用哈希分区，确保不同消费者获取自己的消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		RequiredAcks: kafka.RequireAll,       &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 需要所有副本确认&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MaxAttempts:  &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,                      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 最大重试次数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		WriteTimeout: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second,       &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 写超时&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ReadTimeout:  &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second,       &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 读超时&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Async:        &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,                  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 同步发送（保证顺序）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Compression:  compress.Snappy,        &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 压缩，减少网络流量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		BatchSize:    &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,                    &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 批量大小&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		BatchBytes:   &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1048576&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,                &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 1MB，控制内存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		BatchTimeout: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Millisecond, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 批次超时&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		writer: writer,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		topics: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建消费者&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewConsumer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;topic&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;groupID&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Consumer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	kafkaConfig &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;KafkaCfg&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Brokers: []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:9092&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Topics:   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Topic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{user: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-events&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, post: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;post-events&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Version: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;2.8.0&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 验证配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(kafkaConfig.Brokers) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;KafkaCfg brokers配置为空&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 消费者组名处理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; groupID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		groupID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;consumer-group-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UnixNano&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建Kafka Reader配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	reader &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; kafka.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReaderConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Brokers:         kafkaConfig.Brokers,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Topic:           topic,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		GroupID:         groupID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MinBytes:        &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;e&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,              &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 10KB，减少小消息的网络开销&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MaxBytes:        &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;e&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;6&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,              &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 10MB，避免大消息内存溢出&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MaxWait:         &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second,   &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 调整：减少等待时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ReadLagInterval: &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,                &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 不检查消费延迟&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		StartOffset:     kafka.FirstOffset, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 从最早开始消费&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		CommitInterval:  &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second,   &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 提交偏移量间隔&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		QueueCapacity:   &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,               &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 内部队列容量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Consumer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		reader: reader,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		topic:  topic,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		group:  groupID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 发送消息到指定主题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Send&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;topic&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;key&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;value&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;headers&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 验证参数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; topic &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;主题不能为空&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 转换消息头格式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	kafkaHeaders &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(headers))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; headers {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		kafkaHeaders &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(kafkaHeaders, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Key:   h.Key,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Value: []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(h.Value),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 构建Kafka消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	msg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Topic:   topic,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Key:     []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(key),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Value:   value,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Headers: kafkaHeaders,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Time:    time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 设置消息时间戳&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 发送消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.writer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteMessages&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, msg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送消息到主题[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;]失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, topic, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 记录日志&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;消息发送成功: topic=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, key=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, size=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; bytes&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		topic, key, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(value))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 发送带重试的消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SendWithRetry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;topic&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;key&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;value&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;maxRetries&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;headers&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; lastErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; maxRetries; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Send&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, topic, key, value, headers&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		lastErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送消息重试 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, maxRetries, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 指数退避策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		waitTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;i) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 100&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Millisecond&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; waitTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 5&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.Second {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			waitTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 5&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;After&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(waitTime):&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Done&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;():&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Err&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送消息失败，重试&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;次后放弃: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, maxRetries, lastErr)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 获取主题名称（带缓存）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;getTopic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;topicType&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	p.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RLock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	topic, exists &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.topics[topicType]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	p.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RUnlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; exists {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; topic, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 从配置重新加载&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	kafkaConfig &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;KafkaCfg&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Brokers: []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:9092&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Topics:   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Topic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{user: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-events&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, post: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;post-events&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Version: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;2.8.0&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	p.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 重新检查（双重检查锁模式）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; topic, exists &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.topics[topicType]; exists {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; topic, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 从配置映射获取&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; topicType {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;user&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		topic &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; kafkaConfig.Topics.user&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;post&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		topic &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; kafkaConfig.Topics.post&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;未知的主题类型: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, topicType)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	p.topics[topicType] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; topic&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; topic, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 以下是各种事件类型的便捷发送方法&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SendUserEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;key&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;value&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;headers&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	topic, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;getTopic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Send&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, topic, key, value, headers&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SendPostEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;key&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;value&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;headers&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	topic, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;getTopic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;post&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Send&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, topic, key, value, headers&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 批量发送消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SendBatch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;topic&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;messages&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(messages) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	kafkaMessages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(messages))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, msg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; messages {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		kafkaHeaders &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg.Headers))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Headers {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			kafkaHeaders &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(kafkaHeaders, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				Key:   h.Key,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				Value: []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(h.Value),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		kafkaMessages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(kafkaMessages, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Topic:   topic,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Key:     []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg.Key),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Value:   msg.Value,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Headers: kafkaHeaders,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Time:    msg.Time,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.writer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteMessages&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, kafkaMessages&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;批量发送消息失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;批量消息发送成功: topic=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, count=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, topic, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(messages))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 接收消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Consumer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Receive&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 设置读取超时&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	readCtx, cancel &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithTimeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; cancel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	msg, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.reader.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadMessage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(readCtx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; context.DeadlineExceeded {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 读取超时，不是错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;读取消息失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 转换消息头&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	headers &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg.Headers))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.Headers {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		headers &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(headers, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Key:   h.Key,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Value: &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(h.Value),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Topic:     msg.Topic,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Key:       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg.Key),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Value:     msg.Value,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Partition: msg.Partition,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Offset:    msg.Offset,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Time:      msg.Time,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Headers:   headers,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 批量接收消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Consumer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReceiveBatch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;maxMessages&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) ([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; maxMessages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		maxMessages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 100&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	messages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, maxMessages)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; maxMessages; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		msg, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Receive&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; messages, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			break&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 没有消息了&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		messages &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(messages, msg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; messages, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 手动提交偏移量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Consumer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CommitOffset&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.reader.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CommitMessages&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 获取消费者状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Consumer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetStatus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	stats &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.reader.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Stats&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;topic&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:     c.topic,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;group&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:     c.group,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;dials&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:     stats.Dials,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;messages&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  stats.Messages,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;bytes&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:     stats.Bytes,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;errors&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    stats.Errors,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;timeouts&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  stats.Timeouts,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;lag&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:       stats.Lag,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;partition&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: stats.Partition,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;offset&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    stats.Offset,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 关闭生产者&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.writer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.writer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 关闭消费者&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Consumer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.reader &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.reader.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建主题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; createTopics&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;kafkaConfig&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; KafkaCfg&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;开始创建Kafka主题，brokers: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, kafkaConfig.Brokers)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 连接到Kafka&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	conn, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; kafka.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Dial&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;tcp&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, kafkaConfig.Brokers[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;])&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;连接Kafka失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; conn.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 获取集群控制器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	controller, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; conn.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Controller&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取Kafka控制器失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 连接到控制器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	controllerConn, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; kafka.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Dial&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;tcp&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, controller.Host, controller.Port))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;连接Kafka控制器失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; controllerConn.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 主题配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	topicConfigs &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kafka&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TopicConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Topic:             kafkaConfig.Topics.user,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			NumPartitions:     &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 增加分区数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			ReplicationFactor: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Topic:             kafkaConfig.Topics.post,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			NumPartitions:     &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;6&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 分区更多&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			ReplicationFactor: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建主题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	createdCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, tc &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; topicConfigs {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 检查主题是否已存在&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		partitions, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; controllerConn.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadPartitions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tc.Topic)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(partitions) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;主题已存在: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; (分区数: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;)&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, tc.Topic, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(partitions))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 创建主题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; controllerConn.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CreateTopics&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tc)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建主题 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, tc.Topic, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 继续创建其他主题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;主题创建成功: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; (分区数: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, 副本数: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;)&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			tc.Topic, tc.NumPartitions, tc.ReplicationFactor)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		createdCount&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;主题创建完成: 总数=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, 成功=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(topicConfigs), createdCount)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;以上的公共包包含一键创建主题、并封装了生产者的消费者，还分别为生产者和消费者封装了创建单例、（单次/批量）发送/接受消息、获取主题等方法&lt;/p&gt;
&lt;p&gt;这样，在&lt;code&gt;api-gateway/main&lt;/code&gt;中一键创建主题后，只需要在各服务中注入&lt;code&gt;kafkaProducer *mq.Producer&lt;/code&gt;或&lt;code&gt;kafkaConsumer *mq.Consumer&lt;/code&gt;依赖并序列化包装&lt;code&gt;eventData&lt;/code&gt;并调用&lt;code&gt;SendUserEvent&lt;/code&gt;等方法即可实现消息队列各功能的使用&lt;/p&gt;

&lt;h5 id=&quot;article-业务示例-1&quot;&gt;业务示例&lt;/h5&gt;&lt;p&gt;在生成/消费消息前，我们需要分析/构建各模块的消息作用关系&lt;/p&gt;
&lt;p&gt;以上面所说的用户&amp;amp;帖子微服务为例，我们在用户注册后应该为用户创建示例帖子/欢迎帖子，或者在用户点赞他人帖子后更新帖子信息和被点赞用户的信息，我们就可以在用户注册后发送&lt;code&gt;user&lt;/code&gt;主题的消息并封装相应信息，让&lt;code&gt;post-service&lt;/code&gt;接受该消息并创建欢迎文章，或在点赞后发送&lt;code&gt;interaction&lt;/code&gt;主题的消息并封装相应信息，让&lt;code&gt;post-service&lt;/code&gt;和&lt;code&gt;user-service&lt;/code&gt;接收消息并更新帖子/用户信息&lt;/p&gt;

&lt;h6 id=&quot;article-生产者-1&quot;&gt;生产者&lt;/h6&gt;&lt;p&gt;需要注意的是，我们一般在service层发送消息&lt;/p&gt;
&lt;p&gt;以&lt;code&gt;user-service&lt;/code&gt;为例，在service层发送消息：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 注册新用户&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;userServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;username&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;password&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;avatar&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;about&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户注册请求&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StringField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, username),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StringField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;about&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, about))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	existingUser, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.repo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByUsername&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, username)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;查询用户失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ErrorField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StringField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, username))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, ErrInternalServer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; existingUser &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户名已存在&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StringField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, username))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, ErrUsernameExists&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	hashedPassword, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bcrypt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GenerateFromPassword&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(password), bcrypt.DefaultCost)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;密码加密失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ErrorField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StringField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, username))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, ErrInternalServer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Username: username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Password: &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(hashedPassword),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Avatar:   avatar,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		About:    about,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.repo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Create&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, user); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建用户失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ErrorField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StringField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, username))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, ErrInternalServer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	token, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.jwtManager.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GenerateToken&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user.ID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;生成令牌失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ErrorField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Int64Field&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, user.ID))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, ErrInternalServer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 生产者发送消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.kafkaProducer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		eventData, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Marshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;event_type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;USER_REGISTERED&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 明确的事件类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:       user.ID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:      user.Username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;registered_at&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;avatar&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:        user.Avatar,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;about&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:         user.About,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		s.kafkaProducer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SendUserEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, user.ID), eventData)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送用户注册事件&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Int64Field&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, user.ID))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户注册成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Int64Field&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, user.ID),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StringField&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, username))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user, token, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h6 id=&quot;article-消费者-1&quot;&gt;消费者&lt;/h6&gt;&lt;p&gt;在存在消费者的service中注入消费者依赖，并创建启动消费者方法，异步监听消息。在监听到消息是判别消息事件类型并根据具体类型实现具体消费方法&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; service&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;encoding/json&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;shortvideo/user-service/internal/repository&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;shortvideo/user-service/pkg/mq&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserService&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    repo     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;repository&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepository&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    producer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;mq&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    consumer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;mq&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Consumer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    stopChan &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 控制消费者停止&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewUserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;repo&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;repository&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserRepository&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;producer&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;mq&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Producer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        repo:     repo,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        producer: producer,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        stopChan: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 启动消费者（在main中调用）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StartConsumer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;topic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;groupID&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建消费者&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    consumer, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; mq.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewConsumer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(topic, groupID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建消费者失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    s.consumer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; consumer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动goroutine消费&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;consumeLoop&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;消费者启动: topic=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, group=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, topic, groupID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 消费者主循环&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;consumeLoop&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;s.stopChan:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;消费者停止&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx, cancel &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithTimeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 接收消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            msg, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.consumer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Receive&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;            cancel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; context.DeadlineExceeded {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                    // 读取超时，继续循环&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                    continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;接收消息失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Millisecond)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 处理消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            go&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;processMessage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 处理消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;processMessage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;msg&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;mq&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Message&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 解析消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; data &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unmarshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(msg.Value, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;data); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;解析消息失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 获取事件类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    eventType, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; data[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;event_type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;].(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;消息格式错误: 缺少event_type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 根据事件类型调用已有的Service方法&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ctx &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; eventType {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;POST_CREATED&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 调用具体业务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;POST_DELETED&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 调用具体业务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;POST_LIKED&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 调用具体业务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;未知事件类型: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, eventType)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 停止消费者&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StopConsumer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.consumer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.stopChan)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s.consumer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-进阶-1&quot;&gt;进阶&lt;/h4&gt;&lt;p&gt;以上，我们就完成了在项目中集成基础的消息队列的功能&lt;/p&gt;
&lt;p&gt;进一步来说，我们有多种方法进行消息队列的优化，比如死信队列、处理消息堆积等&lt;/p&gt;
&lt;p&gt;消息队列的进阶部分，之后会详细讲解，现在暂且按下不表&lt;/p&gt;

&lt;h2 id=&quot;article-学习文章-1&quot;&gt;学习文章&lt;/h2&gt;&lt;p&gt;&lt;a href=&quot;https://github.com/LanshanTeam/Courseware-Backend-Go-2024/blob/main/lesson13/README.md&quot;&gt;Lanshan-Go-2024-Lesson13 | 消息队列&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://github.com/LanshanTeam/Courseware-Backend-Go-2023/blob/main/lesson12/%E6%B6%88%E6%81%AF%E9%98%9F%E5%88%97.md&quot;&gt;Lanshan-Go-2023-Lesson12 | 消息队列&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://flxdu.cn/Notes/07-Docker/Kafka-in-Docker-%E5%8D%95%E8%8A%82%E7%82%B9-%E5%A4%9A%E8%8A%82%E7%82%B9.html&quot;&gt;Kafka in Docker 单节点/多节点 | 小木槌&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-MQ/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>微服务</category><category>分布式</category></item><item><title>分布式服务治理：负载均衡、熔断、限流、服务降级</title><link>https://www.claran-blog.work/posts/go-microservice-strategy/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-microservice-strategy/</guid><description>对微服务服务治理的详解.</description><pubDate>Thu, 05 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-引言-1&quot;&gt;引言&lt;/h2&gt;&lt;p&gt;紧接上回，&lt;strong&gt;服务治理&lt;/strong&gt;也是微服务中不可或缺的一环，能够保障有多个独立服务构成的复杂系统能&lt;strong&gt;稳定、可靠、高效且可控地运行&lt;/strong&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-服务治理-1&quot;&gt;服务治理&lt;/h2&gt;
&lt;h3 id=&quot;article-负载均衡-1&quot;&gt;负载均衡&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;均衡发展策略通常在服务发现时作为一种服务选择策略进行使用&lt;/strong&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-概念-1&quot;&gt;概念&lt;/h4&gt;&lt;p&gt;&lt;strong&gt;将外部请求或内部服务调用，智能地分发到多个服务实例上&lt;/strong&gt;。这能避免单个实例过载，充分利用集群资源，提高系统的整体吞吐量和响应速度，是实现水平扩展的基础&lt;/p&gt;

&lt;h4 id=&quot;article-实现-1&quot;&gt;实现&lt;/h4&gt;&lt;p&gt;负载均衡机制有多重基础策略算法选择&lt;/p&gt;

&lt;h5 id=&quot;article-加权随机-1&quot;&gt;加权随机&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;核心思想&lt;/strong&gt;：完全随机的选择，每个实例被选中的概率 = 权重 / 总权重&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;适用场景&lt;/strong&gt;：大部分无状态服务，最简单高效&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; RandomSelect&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;instances&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Instance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Instance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 计算总权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    totalWeight &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, instance &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instances {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        totalWeight &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instance.Weight&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 生成随机数 [0, totalWeight)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    random &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rand.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Intn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(totalWeight)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 按权重区间选择&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    current &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, instance &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instances {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        current &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instance.Weight&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; random &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; current {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instance&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instances[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 核心逻辑：权重越高，在数轴上的区间越长，被选中的概率越大&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 权重5：区间长度5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 权重3：区间长度3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 权重2：区间长度2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 随机数落在哪个区间，就选哪个实例&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-轮询-1&quot;&gt;轮询&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;核心思想&lt;/strong&gt;：轮流分配请求，保证绝对公平&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;适用场景&lt;/strong&gt;：需要流量均匀分配的服务&lt;/p&gt;

&lt;h6 id=&quot;article-普通加权轮询-1&quot;&gt;普通加权轮询&lt;/h6&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WeightedRoundRobin&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    servers []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WeightedServer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mu      &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Mutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WeightedServer&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Server   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Weight   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Current  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 已分配次数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;wrr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WeightedRoundRobin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    wrr.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wrr.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(wrr.servers) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 查找权重使用次数最少的服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; selected &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WeightedServer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    totalWeight &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, server &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wrr.servers {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        totalWeight &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server.Weight&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 如果这个服务器的已分配次数 &amp;lt; 权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server.Current &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server.Weight {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; selected &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server.Current &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; selected.Current {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                selected &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 如果找到了合适的服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; selected &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        selected.Current&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; selected.Server&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 如果所有服务器都达到了权重限制，重置计数器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, server &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wrr.servers {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        server.Current &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 重新选择&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wrr.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 示例运行（权重 A:3, B:2, C:1）：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始状态: A:0/3, B:0/2, C:0/1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第1次: 选A → A:1/3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第2次: 选B → B:1/2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第3次: 选A → A:2/3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第4次: 选C → C:1/1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第5次: 选A → A:3/3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第6次: 选B → B:2/2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第7次: 所有服务器达到权重，重置 → A:0/3, B:0/2, C:0/1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第8次: 重新开始循环&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h6 id=&quot;article-平滑加权轮询算法-nginx算法-1&quot;&gt;平滑加权轮询算法（Nginx算法）&lt;/h6&gt;&lt;p&gt;该算法也是&lt;strong&gt;Nginx&lt;/strong&gt;内部使用的默认负载均衡算法，保证了策略的平滑性，&lt;strong&gt;权重高的服务器不会连续收到大量请求&lt;/strong&gt;，时间复杂度为O(n)&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; loadbalancer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务器节点定义&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; SmoothWeightedServer&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Server    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Weight    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 固定权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Current   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 当前权重（动态变化）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Effective &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 有效权重（可用于健康检查降权）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 平滑加权轮询负载均衡器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; SmoothWeightedRoundRobin&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    servers []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SmoothWeightedServer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mu      &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RWMutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    total   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 总权重缓存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建新的负载均衡器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewSmoothWeightedRoundRobin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SmoothWeightedRoundRobin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SmoothWeightedRoundRobin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        servers: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SmoothWeightedServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 添加服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;swrr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SmoothWeightedRoundRobin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;server&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;weight&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    swrr.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; swrr.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    swrr.servers &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(swrr.servers, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SmoothWeightedServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Server:    server,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Weight:    weight,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Current:   &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Effective: weight,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 更新总权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    swrr.total &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; weight&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 核心算法实现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;swrr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SmoothWeightedRoundRobin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    swrr.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; swrr.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(swrr.servers) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 遍历所有服务器，增加当前权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    best &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; swrr.servers[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    bestIndex &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i, server &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; swrr.servers {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 增加当前权重（使用有效权重）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        server.Current &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server.Effective&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 选择当前权重最大的服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server.Current &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; best.Current {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            best &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            bestIndex &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 被选中的服务器减去总权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    best.Current &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; swrr.total&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; best.Server&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 假设有3个服务器：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务器A: 权重=3, 初始Current=0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务器B: 权重=2, 初始Current=0  &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务器C: 权重=1, 初始Current=0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 总权重 = 3+2+1 = 6&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第1次选择：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤1: 所有服务器增加权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   A: 0+3=3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   B: 0+2=2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   C: 0+1=1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤2: 选择当前权重最大的 → A(3)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤3: 被选中的A减去总权重 → A: 3-6 = -3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 结果: 选择A，状态: A=-3, B=2, C=1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第2次选择：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤1: 所有服务器增加权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   A: -3+3=0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   B: 2+2=4&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   C: 1+1=2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤2: 选择当前权重最大的 → B(4)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤3: 被选中的B减去总权重 → B: 4-6 = -2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 结果: 选择B，状态: A=0, B=-2, C=2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第3次选择：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤1: 所有服务器增加权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   A: 0+3=3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   B: -2+2=0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   C: 2+1=3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤2: 选择当前权重最大的 → A和C都是3，选第一个(A)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤3: 被选中的A减去总权重 → A: 3-6 = -3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 结果: 选择A，状态: A=-3, B=0, C=3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第4次选择：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤1: 所有服务器增加权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   A: -3+3=0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   B: 0+2=2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   C: 3+1=4&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤2: 选择当前权重最大的 → C(4)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤3: 被选中的C减去总权重 → C: 4-6 = -2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 结果: 选择C，状态: A=0, B=2, C=-2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第5次选择：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤1: 所有服务器增加权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   A: 0+3=3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   B: 2+2=4&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   C: -2+1=-1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤2: 选择当前权重最大的 → B(4)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤3: 被选中的B减去总权重 → B: 4-6 = -2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 结果: 选择B，状态: A=3, B=-2, C=-1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 第6次选择：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤1: 所有服务器增加权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   A: 3+3=6&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   B: -2+2=0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//   C: -1+1=0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤2: 选择当前权重最大的 → A(6)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 步骤3: 被选中的A减去总权重 → A: 6-6 = 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 结果: 选择A，状态: A=0, B=0, C=0 (回到初始状态)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 6次请求分配结果: A, B, A, C, B, A&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 符合权重比例: A:3次, B:2次, C:1次&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 而且分布很平滑: 没有连续3次A，而是穿插分配&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-最少链接策略-1&quot;&gt;最少链接策略&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;核心思想&lt;/strong&gt;：选择当前连接数最少的服务器&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;适用场景&lt;/strong&gt;：长连接服务，如数据库连接池、WebSocket&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 实现思路：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; LeastConnectionsSelect&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;instances&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Instance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Instance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; best &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Instance&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    minConnections &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; math.MaxInt32&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, instance &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instances {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 获取当前连接数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        conns &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instance.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetCurrentConnections&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 选择连接数最少的&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; conns &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; minConnections {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            minConnections &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; conns&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            best &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instance&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; best&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-ip哈希-1&quot;&gt;IP哈希&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;核心思想&lt;/strong&gt;：相同来源的请求总是路由到同一实例&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;适用场景&lt;/strong&gt;：需要会话保持的服务，如用户登录状态&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; iphash&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;crypto/sha1&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;encoding/binary&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; IPHashLoadBalancer&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    instances []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mu        &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RWMutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewIPHash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;instances&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IPHashLoadBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IPHashLoadBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        instances: instances,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 核心哈希函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;lb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IPHashLoadBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;hashIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ip&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint32&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sha1.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Write&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ip))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    hashBytes &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sum&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 取前4个字节作为32位整数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; binary.BigEndian.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Uint32&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(hashBytes[:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;])&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 选择实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;lb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IPHashLoadBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInstance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;clientIP&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    lb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RLock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; lb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RUnlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(lb.instances) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 核心逻辑：哈希取模&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    hash &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; lb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;hashIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(clientIP)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    index &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; hash &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;%&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; uint32&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(lb.instances))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; lb.instances[index]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-一致性哈希-1&quot;&gt;一致性哈希&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;核心思想&lt;/strong&gt;：构建哈希环，请求映射到环上最近的节点&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;适用场景&lt;/strong&gt;：缓存服务、分布式存储&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;内部由红黑平衡树实现，红黑树是一种自平衡的二叉查找树&lt;/p&gt;
&lt;p&gt;红黑树的特性：&lt;/p&gt;
&lt;p&gt;根节点必须是黑色， 红色节点不能有红色子节点（没有连续红色）， 从任意节点到其叶子节点的所有路径，黑色节点数必须相同， 每个叶子节点（NIL）都是黑色&lt;/p&gt;
&lt;p&gt;这种特性决定了红黑树总是平衡，且具有良好的查找效率&lt;/p&gt;
&lt;p&gt;在Go中可以用&lt;code&gt;github.com/emirpasic/gods/trees/redblacktree&lt;/code&gt;获取红黑树实例&lt;/p&gt;
&lt;p&gt;红黑树或其他数据结构与算法在后面单开模块讲解&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; consistenthash&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;hash/fnv&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strconv&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    rbt &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/emirpasic/gods/trees/redblacktree&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//  一致性哈希结构&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ConsistentHash&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    virtualNodes &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                  // 每个物理节点的虚拟节点数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    hashFunc     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint32&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 哈希函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ring         &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;rbt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Tree&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 红黑树，存储虚拟节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    nodeMap      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;     // 记录物理节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mu           &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RWMutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建一致性哈希实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewConsistentHash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;virtualNodes&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ConsistentHash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ConsistentHash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        virtualNodes: virtualNodes,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        hashFunc:     defaultHash,      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 默认哈希函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ring:         rbt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewWithIntComparator&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        nodeMap:      &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 默认哈希函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; defaultHash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;key&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint32&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fnv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New32a&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Write&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(key))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sum32&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 添加物理节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ConsistentHash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;node&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ch.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 如果节点已存在，直接返回&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.nodeMap[node] {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 添加虚拟节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.virtualNodes; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 创建虚拟节点key&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        virtualKey &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;#&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, node, i)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        hash &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;hashFunc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(virtualKey)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 将虚拟节点添加到红黑树&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ch.ring.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Put&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(hash), node)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 标记节点已添加&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ch.nodeMap[node] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 删除物理节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ConsistentHash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RemoveNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;node&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ch.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 如果节点不存在，直接返回&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch.nodeMap[node] {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 删除所有虚拟节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.virtualNodes; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        virtualKey &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;#&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, node, i)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        hash &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;hashFunc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(virtualKey)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ch.ring.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Remove&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(hash))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 从节点映射中删除&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    delete&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ch.nodeMap, node)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 查找节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ConsistentHash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetNode&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;key&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ch.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RLock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RUnlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 如果环为空，返回空&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.ring.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Size&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 计算key的哈希值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    hash &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;hashFunc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(key)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    hashInt &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(hash)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 在红黑树中查找 &amp;gt;= hash 的第一个节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    node, found &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.ring.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Ceiling&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(hashInt)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; found {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 如果找到了，返回对应的物理节点&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; node.Value.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    } &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 如果没找到，返回第一个节点（环状结构）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        firstNode &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.ring.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Left&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; firstNode &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; firstNode.Value.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 打印哈希环状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ConsistentHash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PrintRing&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ch.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RLock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RUnlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;=== 哈希环状态 ===&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;虚拟节点数量: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, ch.ring.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Size&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;物理节点数量: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ch.nodeMap))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;物理节点列表:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; node &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.nodeMap {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;  - &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, node)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;虚拟节点分布:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    it &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch.ring.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Iterator&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; it.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        hash &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; it.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Key&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        node &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; it.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Value&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;  哈希: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; -&amp;gt; 物理节点: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, hash, node)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-响应时间加权-1&quot;&gt;响应时间加权&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;核心思想&lt;/strong&gt;：选择响应时间最短的实例&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;适用场景&lt;/strong&gt;：对延迟敏感的服务&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 实现思路：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ResponseTimeSelect&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;instances&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Instance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Instance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; best &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Instance&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    minResponseTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(math.MaxInt64)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, instance &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instances {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 获取平均响应时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        avgTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instance.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetAverageResponseTime&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 考虑权重：响应时间/权重&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        weightedTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; avgTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(instance.Weight)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; weightedTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; minResponseTime {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            minResponseTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; weightedTime&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            best &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instance&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; best&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 核心逻辑：动态感知实例性能&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 实例A：响应时间10ms，权重1 → 10/1=10&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 实例B：响应时间20ms，权重2 → 20/2=10&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 实例C：响应时间15ms，权重3 → 15/3=5 ← 最优&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-在kitex框架下的使用-1&quot;&gt;在kitex框架下的使用&lt;/h4&gt;&lt;p&gt;与etcd一样，&lt;strong&gt;kitex框架自带了多重均衡负载策略&lt;/strong&gt;：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;加权随机（默认方法）&lt;/li&gt;
&lt;li&gt;加权轮询&lt;/li&gt;
&lt;li&gt;一致性哈希&lt;/li&gt;
&lt;li&gt;最少连接&lt;/li&gt;
&lt;li&gt;标签匹配&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;在不指定均衡负载的情况下，&lt;strong&gt;kitex会自动使用加权随机策略&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;在kitex中指定并配置均衡负载策略的示例如下：&lt;/p&gt;

&lt;h5 id=&quot;article-加权随机-2&quot;&gt;加权随机&lt;/h5&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 不指定，默认使用默认负载均衡（加权随机）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    defaultClient, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; echo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;echo-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithHostPorts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:8888&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:8889&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; defaultClient&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-加权轮询-1&quot;&gt;加权轮询&lt;/h5&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 指定加权轮询&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    wrrClient, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; echo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;echo-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithHostPorts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:8888&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:8889&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithLoadBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(loadbalance.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewWeightedRoundRobinBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wrrClient&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-一致性哈希-ip哈希-用户哈希-1&quot;&gt;一致性哈希/IP哈希/用户哈希&lt;/h5&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 指定一致性哈希&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    hashClient, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; echo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;echo-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithHostPorts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:8888&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:8889&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithLoadBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(loadbalance.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewConsistentHashBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; hashClient&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;可以通过自定义哈希键的方式把获得的哈希键设置为客户端IP或用户ID&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 自定义一致性哈希策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    cli, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; echo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;echo-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithHostPorts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:8888&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:8889&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithLoadBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(loadbalance.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewConsistentHashBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;opt&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;loadbalance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ConsistentHashOption&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // 自定义哈希键提取&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                opt.GetKey &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;request&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                    // 从上下文中获取用户ID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; uid, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Value&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; uid&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                    // 从请求中获取&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; req, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; request.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;echo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EchoRequest&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; req.UserID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                            return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; req.UserID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; req.Message&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                    // 默认使用请求的字符串表示&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, request)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // 虚拟节点数（默认 100，推荐 100-200）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                opt.VirtualFactor &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 160&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // 哈希函数（默认 crc32）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // opt.HashFunc = func(data []byte) uint32 {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                //     // 自定义哈希函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                //     return myHashFunc(data)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // 副本数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                opt.Replica &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        )),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-最少链接-1&quot;&gt;最少链接&lt;/h5&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 方法4：指定最少连接&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    lcClient, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; echo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;echo-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithHostPorts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:8888&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:8889&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithLoadBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(loadbalance.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewLeastConnBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; lcClient&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-标签匹配-1&quot;&gt;标签匹配&lt;/h5&gt;&lt;p&gt;在设置rpc服务端时&lt;strong&gt;设置标签&lt;/strong&gt;，可以在&lt;strong&gt;指定标签进行匹配&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 使用标签进行路由&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    cli, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; echo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;echo-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithLoadBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(loadbalance.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewTagBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 标签匹配规则&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithTag&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;zone&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;shanghai&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 选择上海区域&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithTag&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;env&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;prod&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),       &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 选择生产环境&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithTag&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;version&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;v1.2.0&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 选择特定版本&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 负载均衡器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithLoadBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(loadbalance.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewWeightedRandomBalancer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-限流-1&quot;&gt;限流&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;限流通常在网关层作为狭义中间件使用&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;需要注意的是，限流通常不采用某种特定方法，而是根据业务需求结合不同限流方法&lt;/p&gt;

&lt;h4 id=&quot;article-概念-2&quot;&gt;概念&lt;/h4&gt;&lt;p&gt;控制单位时间内进入系统或某个服务的请求数量。当遇到突发流量（如秒杀活动）时，&lt;strong&gt;通过限流保护系统不被瞬间压垮&lt;/strong&gt;，&lt;br /&gt;确保在最大承受能力内平稳运行，超出的请求会被友好地拒绝或排队，保障系统不会崩溃&lt;/p&gt;

&lt;h4 id=&quot;article-实现-2&quot;&gt;实现&lt;/h4&gt;
&lt;h5 id=&quot;article-令牌桶算法-1&quot;&gt;令牌桶算法&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;创建一个bucket存放令牌，请求流入时尝试获取桶内令牌，请求需要成功获取令牌才能流过，桶内令牌会以设定的速率进行补充&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;该算法适合应对突发流量情况&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// TokenBucketLimiter 令牌桶限流器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; TokenBucketLimiter&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    capacity     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 桶容量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    tokens       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 当前令牌数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fillRate     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 填充速率（每秒）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    lastRefill   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;     // 上次填充时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mu           &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Mutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewTokenBucket&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;capacity&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;fillRate&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TokenBucketLimiter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TokenBucketLimiter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        capacity:   capacity,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        tokens:     capacity,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fillRate:   fillRate,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        lastRefill: time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;tb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TokenBucketLimiter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Allow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    tb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 1. 补充令牌&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    now &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    elapsed &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sub&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tb.lastRefill)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    tokensToAdd &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(elapsed.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Seconds&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; float64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tb.fillRate))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tokensToAdd &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        tb.tokens &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; min&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tb.capacity, tb.tokens&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;tokensToAdd)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        tb.lastRefill &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 2. 尝试获取令牌&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tb.tokens &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        tb.tokens&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;--&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 核心思想：固定速率放入令牌，请求消耗令牌&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 优点：允许一定突发流量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 场景：API限流、接口保护&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-漏铜算法-1&quot;&gt;漏铜算法&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;将所有流入的请求放入桶内，并让桶以一定速率流出请求（由chan实现）&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;该算法允许请求平滑通过&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// LeakyBucketLimiter 漏桶限流器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; LeakyBucketLimiter&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    capacity     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 桶容量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    queue        &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 请求队列&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    leakRate     &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 漏出速率&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    stopCh       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewLeakyBucket&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;capacity&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ratePerSecond&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LeakyBucketLimiter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    lb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LeakyBucketLimiter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        capacity: capacity,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        queue:    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, capacity),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        leakRate: time.Second &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ratePerSecond),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        stopCh:   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动漏水协程&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; lb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;leak&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; lb&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;lb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LeakyBucketLimiter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Allow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; lb.queue &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}{}:  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 水流入桶&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 桶已满，拒绝&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;lb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LeakyBucketLimiter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;leak&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ticker &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewTicker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(lb.leakRate)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ticker.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Stop&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ticker.C:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;lb.queue:  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 漏出一滴水（处理一个请求）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;lb.stopCh:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;lb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LeakyBucketLimiter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Stop&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(lb.stopCh)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 核心思想：以恒定速率处理请求，突发流量会排队&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 优点：平滑输出，防止突发流量冲击下游&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 场景：消息队列、数据库连接池&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-滑动窗口算法-1&quot;&gt;滑动窗口算法&lt;/h5&gt;&lt;p&gt;滑动窗口算法是固定窗口算法的优化版&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;固定窗口算法允许请求在固定时间段流过一定数量的请求&lt;/strong&gt;，如0&lt;del&gt;1秒10个，1&lt;/del&gt;2秒十个。但是该算法的缺陷在于，当请求在0.9秒与1.1秒分别流入10个请求，就会出现在短时间内超过规定请求数的情况（0.2秒20个请求）&lt;/p&gt;
&lt;p&gt;相比固定窗口，滑动窗口的处理更加平滑，&lt;strong&gt;该算法将固定的窗口分割为n个时间槽，时间槽根据当前的时间删除窗口左边缘对应的时间槽、计算当前时间的对应时间槽，并统计所有时间的槽请求次数，当所有时间槽总计的请求次数超过规定的请求数时拒绝请求流过，若请求成功流过则增加对应的时间槽的计数&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;工作流程图&lt;/strong&gt;&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;时间轴：0.0  0.1  0.2  0.3  0.4  0.5  0.6  0.7  0.8  0.9  1.0  1.1  1.2 (秒)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;槽位：  [0]  [1]  [2]  [3]  [4]  [5]  [6]  [7]  [8]  [9]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;假设当前时间是1.2秒，窗口大小1秒：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;滑动窗口包含：[0.2, 1.2]秒&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;对应槽位：[2]到[1]（因为是环形的）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;计算窗口内总请求数 = 槽2+槽3+槽4+...+槽9+槽0+槽1&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;代码实现：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// SlidingWindowLimiter 滑动窗口限流器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; SlidingWindowLimiter&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    limit        &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 窗口内最大请求数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    window       &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 窗口大小&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    slots        []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;slot&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;       // 时间槽&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    slotCount    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;          // 槽数量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mu           &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RWMutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; slot&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    timestamp &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 毫秒时间戳&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    count     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 该槽的请求数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewSlidingWindow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;limit&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;window&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;slotCount&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SlidingWindowLimiter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; slotCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        slotCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 10&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SlidingWindowLimiter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        limit:     limit,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        window:    window,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        slots:     &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;slot&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, slotCount),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        slotCount: slotCount,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;sw &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SlidingWindowLimiter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Allow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    sw.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sw.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    now &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UnixMilli&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    slotSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(sw.window.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Milliseconds&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(sw.slotCount)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 清理过期槽位&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    currentIdx &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;((now &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; slotSize) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;%&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(sw.slotCount))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    expiredTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(sw.window.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Milliseconds&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sw.slotCount; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sw.slots[i].timestamp &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; expiredTime {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            sw.slots[i] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; slot&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 清空过期槽&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 计算当前窗口内的总请求数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    total &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sw.slotCount; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sw.slots[i].timestamp &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; expiredTime {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            total &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sw.slots[i].count&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; total &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sw.limit {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 记录当前请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sw.slots[currentIdx].timestamp &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;slotSize&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;slotSize {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        sw.slots[currentIdx].count&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    } &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        sw.slots[currentIdx] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; slot&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            timestamp: now &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; slotSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; slotSize,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            count:     &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 核心思想：将固定窗口切分为多个小窗口，只统计最近N个窗口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 优点：解决边界问题，更加精确&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 场景：API网关、微服务限流&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-分布式限流-redis-1&quot;&gt;分布式限流（Redis）&lt;/h5&gt;&lt;p&gt;原理是在单机限流的基础上，利用redis的原子性，在分布式环境下维护一个进程共享的计数器&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;分布式限流并不是某种固定的算法，而是让redis与其他限流算法结合实现分布式系统的统一限流，并使用lua脚本保证代码流程原子性&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;以令牌桶算法为例：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;rl &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RedisLimiter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AllowTokenBucket&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;key&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    capacity&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;rate&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; float64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;tokens&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    now &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UnixNano&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    script &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        local key = KEYS[1]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        local capacity = tonumber(ARGV[1])&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        local rate = tonumber(ARGV[2])&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        local now = tonumber(ARGV[3])&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        local requested = tonumber(ARGV[4])&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        local bucket = redis.call(&apos;HMGET&apos;, key, &apos;tokens&apos;, &apos;last_refill&apos;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        local tokens = tonumber(bucket[1]) or capacity&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        local last_refill = tonumber(bucket[2]) or now&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        -- 计算时间差（纳秒）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        local elapsed = (now - last_refill) / 1000000000  -- 转换为秒&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        local refill = math.floor(elapsed * rate)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        -- 补充令牌&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        tokens = math.min(capacity, tokens + refill)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        -- 更新最后补充时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        if refill &amp;gt; 0 then&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            last_refill = now&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        end&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        local allowed = 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        if tokens &amp;gt;= requested then&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            tokens = tokens - requested&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            allowed = 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        end&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        -- 保存状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        redis.call(&apos;HMSET&apos;, key, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &apos;tokens&apos;, tokens,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &apos;last_refill&apos;, last_refill&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        -- 设置过期时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        local ttl = math.ceil(capacity / rate) * 2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        redis.call(&apos;EXPIRE&apos;, key, ttl)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        return {allowed, tokens}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    result, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rl.client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Eval&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, script, []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{rl.prefix &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; key},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        capacity, rate, now, tokens).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    res &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; res[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;].(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-在kitex框架下的使用-2&quot;&gt;在kitex框架下的使用&lt;/h4&gt;&lt;p&gt;&lt;strong&gt;特别地，kitex虽然内置了以令牌桶算法实现的限流功能，但是该限流功能只作用于服务端用于保护服务提供方，客户端限流或其他限流方法需要自行实现或使用中间件&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;服务端限流示例代码：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/pkg/limit&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/server&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your_service/kitex_gen/your/service&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 替换为你的服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建监听地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    addr, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; net.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ResolveTCPAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;tcp&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:8888&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    svr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 设置服务地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithServiceAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(addr),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 开启限流&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithLimit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;limit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Option&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 连接数限制&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            MaxConnections: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1000&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,       &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 最大连接数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            MaxQPS:         &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1000&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,       &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 最大QPS（每秒请求数）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 限流算法&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 内置：令牌桶算法&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 监控和统计&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithStatsLevel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(stats.LevelDetailed),  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 开启详细统计&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; svr.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Run&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        panic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-熔断-1&quot;&gt;熔断&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;熔断器通常在业务调用或作为依赖的一部分注入发挥作用&lt;/strong&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-概念-3&quot;&gt;概念&lt;/h4&gt;&lt;p&gt;当某个下游服务调用失败率过高时（如超时、报错），主动熔断对该服务的调用，快速失败并进入降级逻辑。&lt;br /&gt;这可以防止故障向上游扩散，避免因一个服务的瘫痪导致整个系统雪崩，给故障服务恢复的时间&lt;/p&gt;

&lt;h4 id=&quot;article-原理解析与代码实现-1&quot;&gt;原理解析与代码实现&lt;/h4&gt;
&lt;h5 id=&quot;article-熔断器状态机-1&quot;&gt;熔断器状态机&lt;/h5&gt;&lt;p&gt;熔断器的实现以状态机和状态转换为核心：&lt;/p&gt;
&lt;p&gt;状态机的三种状态：Close，Open，HalfOpen&lt;/p&gt;
&lt;p&gt;当熔断器处于不同状态时，会有不同的方法策略&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;关闭（Close）：&lt;ul&gt;
&lt;li&gt;通过流入的请求&lt;/li&gt;
&lt;li&gt;记录请求失败的次数&lt;/li&gt;
&lt;li&gt;当累计的请求失败次数大于设定的熔断阈值时，将熔断器设为开启状态（Open）&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;开启（Open）：&lt;ul&gt;
&lt;li&gt;拒绝流入的请求&lt;/li&gt;
&lt;li&gt;记录熔断器开启的时间&lt;/li&gt;
&lt;li&gt;检查状态持续时间是否超过设定的最大熔断时间，若超过，将熔断器设为半开状态（HalfOpen）&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;半开（HalfOpen）：&lt;ul&gt;
&lt;li&gt;设置规定的请求尝试数量&lt;/li&gt;
&lt;li&gt;记录请求成功的次数&lt;/li&gt;
&lt;li&gt;在请求数达到规定的请求尝试数量时，检查累计的请求成功次数是否达到规定的成功阈值，若达到，将熔断器设置为关闭状态（Close），若未达到则将熔断器设置为开启状态（Open）&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 1. Closed 状态（正常）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ClosedState&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    failureCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 失败计数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    successCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 成功计数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    windowStart  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;     // 窗口开始时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    threshold    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 失败阈值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    windowSize   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 时间窗口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 逻辑：统计失败率，超过阈值转为Open&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 2. Open 状态（熔断）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; OpenState&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    openedAt     &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;     // 熔断开始时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    timeout      &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 熔断持续时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 逻辑：所有请求立即失败，不调用下游&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 3. HalfOpen 状态（试探）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; HalfOpenState&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    allowedRequests &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 允许的试探请求数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    successCount    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 成功计数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    threshold       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 成功阈值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 逻辑：允许少量请求试探，成功达到阈值转Closed&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/circuitbreaker.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;当然，一般情况下熔断器模型对状态和请求的记录是解耦的：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 熔断器状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; State&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;	StateClosed&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; State&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; iota&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 关闭状态：正常处理请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;	StateOpen&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                   // 开启状态：快速失败&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;	StateHalfOpen&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;               // 半开状态：试探请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 熔断器配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Config&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Name              &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	FailureThreshold  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 失败次数阈值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	SuccessThreshold  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 恢复成功阈值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	HalfOpenMaxCalls  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 半开状态最大试探请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	OpenTimeout       &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 熔断持续时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ResetTimeout      &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 统计重置时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 统计信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Stats&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	TotalRequests   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	SuccessCount    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	FailureCount    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	RejectedCount   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	LastFailureTime &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	LastSuccessTime &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	State           &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;State&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	StateChangeTime &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 精简熔断器实现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; CircuitBreaker&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	state     &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;State&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	config    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	stats     &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Stats&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	mu             &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RWMutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	openTime       &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	halfOpenCalls  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	halfOpenSuccess &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 失败计数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	failureCount   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	successCount   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	lastResetTime  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-熔断器核心方法-1&quot;&gt;熔断器核心方法&lt;/h5&gt;&lt;p&gt;熔断器有两个核心方法：&lt;code&gt;Allow&lt;/code&gt;和&lt;code&gt;Record&lt;/code&gt;&lt;/p&gt;

&lt;h6 id=&quot;article-allow-1&quot;&gt;Allow&lt;/h6&gt;&lt;p&gt;设置了熔断器状态机后，所有请求会流过&lt;code&gt;Allow&lt;/code&gt;方法：&lt;/p&gt;
&lt;p&gt;&lt;code&gt;Allow&lt;/code&gt;方法会检查当前熔断器状态机状态，根据不同的状态选择允许请求流过、拒绝请求流过或尝试半开等熔断器逻辑方法&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Allow - 检查是否允许请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CircuitBreaker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Allow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	cb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RLock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RUnlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	now &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.state {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateClosed:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 检查是否需要重置统计&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sub&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cb.lastResetTime) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.config.ResetTimeout {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 异步重置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			go&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;resetStats&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateOpen:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 检查是否超时，可以切换到半开状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sub&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cb.openTime) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.config.OpenTimeout {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 异步切换到半开&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			go&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tryHalfOpen&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;recordRejected&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateHalfOpen:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 半开状态允许有限的试探请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.halfOpenCalls &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.config.HalfOpenMaxCalls {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;recordRejected&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 尝试切换到半开状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CircuitBreaker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;tryHalfOpen&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	cb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 确保还在Open状态并且超时了&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.state &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateOpen &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Since&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cb.openTime) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.config.OpenTimeout {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.state &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateHalfOpen&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.stats.State &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateHalfOpen&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.stats.StateChangeTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.halfOpenCalls &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.halfOpenSuccess &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 重置统计&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CircuitBreaker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;resetStats&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	cb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	now &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sub&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cb.lastResetTime) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.config.ResetTimeout {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.failureCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.successCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.lastResetTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 记录拒绝的请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CircuitBreaker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;recordRejected&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	cb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	cb.stats.RejectedCount&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h6 id=&quot;article-record-1&quot;&gt;Record&lt;/h6&gt;&lt;p&gt;&lt;code&gt;Record&lt;/code&gt;方法负责记录请求的成功与否，并根据请求记录对熔断器的状态进行切换&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Record - 记录请求结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CircuitBreaker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Record&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;success&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	cb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	now &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	cb.stats.TotalRequests&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; success {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.successCount&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.failureCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 成功时重置失败计数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.stats.SuccessCount&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.stats.LastSuccessTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.state {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateClosed:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 正常状态，成功请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateHalfOpen:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			cb.halfOpenCalls&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			cb.halfOpenSuccess&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;						// 半开状态连续成功达到阈值，恢复关闭状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.halfOpenSuccess &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.config.SuccessThreshold {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				cb.state &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateClosed&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				cb.stats.State &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateClosed&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				cb.stats.StateChangeTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 重置半开统计&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				cb.halfOpenCalls &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				cb.halfOpenSuccess &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 重置失败计数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				cb.failureCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	} &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.failureCount&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.successCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 失败时重置成功计数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.stats.FailureCount&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		cb.stats.LastFailureTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.state {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateClosed:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 检查是否达到熔断条件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.failureCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cb.config.FailureThreshold {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				cb.state &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateOpen&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				cb.stats.State &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateOpen&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				cb.openTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				cb.stats.StateChangeTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateHalfOpen:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 半开状态下任何失败都重新熔断&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			cb.state &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateOpen&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			cb.stats.State &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; StateOpen&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			cb.openTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			cb.stats.StateChangeTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 重置半开统计&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			cb.halfOpenCalls &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			cb.halfOpenSuccess &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h6 id=&quot;article-excute-1&quot;&gt;Excute&lt;/h6&gt;&lt;p&gt;&lt;code&gt;Excute&lt;/code&gt;虽然并非熔断器核心逻辑方法，但是一般会使用&lt;code&gt;Excute&lt;/code&gt;方法对&lt;code&gt;Allow&lt;/code&gt;和&lt;code&gt;Record&lt;/code&gt;进行封装，使熔断器在其他方法中更容易被调用&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cb &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CircuitBreaker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Execute&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;T&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; any&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;](&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;fn&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;T&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;T&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zero &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;T&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 检查熔断器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;cb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Allow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        cb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;recordRejected&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zero, ErrCircuitOpen&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 执行业务函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    result, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; fn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 记录结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    cb.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Record&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 返回结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这样的&lt;code&gt;Excute&lt;/code&gt;方法可以在其他业务代码中被调用，并返回原函数的返回值和错误&lt;/p&gt;
&lt;p&gt;若不需要返回值或需要多个返回值，可将&lt;code&gt;Excute&lt;/code&gt;方法修改为无泛型返回值会多返回值，或者在调用该方法时进行结构体封装或序列化数据&lt;/p&gt;

&lt;h5 id=&quot;article-在业务代码中的使用-1&quot;&gt;在业务代码中的使用&lt;/h5&gt;&lt;p&gt;以用户服务的dao层为例&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// internal/dao/user_dao_simple.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; dao&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gorm.io/gorm&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kitex-user-service/pkg/circuitbreaker&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserDAO&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	db &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gorm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DB&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	breaker &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;circuitbreaker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CircuitBreaker&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewUserDAO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;db&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gorm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DB&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserDAO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserDAO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		db: db,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		breaker: circuitbreaker.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewCircuitBreaker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;circuitbreaker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Name:             &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_dao&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			FailureThreshold: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			SuccessThreshold: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			HalfOpenMaxCalls: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			OpenTimeout:      &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			ResetTimeout:     &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// CreateUser 创建用户&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;dao &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserDAO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CreateUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 使用熔断器保护&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	result, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dao.breaker.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Execute&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 直接创建用户&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dao.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Create&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user).Error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 检查是否是唯一键冲突&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Is&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err, gorm.ErrDuplicatedKey) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户名或邮箱已存在&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建用户失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;正常情况下，熔断器还需要滑动窗口等算法进行性能优化，此处省略&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-在kitex框架下的应用-1&quot;&gt;在kitex框架下的应用&lt;/h4&gt;&lt;p&gt;与etcd一样，kitex框架也内置了熔断器，并且使用同样非常简单&lt;/p&gt;
&lt;p&gt;kitex中的熔断器有两种颗粒度：&lt;br /&gt;&lt;code&gt;client-server&lt;/code&gt;和&lt;code&gt;client-server/method&lt;/code&gt;，分别对相应&lt;code&gt;client与server&lt;/code&gt;和&lt;code&gt;client与server及其所有方法&lt;/code&gt;生效&lt;/p&gt;
&lt;p&gt;kitex内置的熔断器实例使用&lt;code&gt;NewCBSuite（KeyFunc）&lt;/code&gt;来获取，参数&lt;code&gt;KeyFunc&lt;/code&gt;为获取熔断器级别标签的方法，级别标签的命名规则为&lt;code&gt;fromServiceName/toServiceName/method&lt;/code&gt;，使用&lt;code&gt;circuitbreaker.RPCInfo2Key&lt;/code&gt;方法可以快速获取&lt;code&gt;client-server/method&lt;/code&gt;的级别标签：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 默认配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;cbs &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; circuitbreak.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewCBSuite&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(circuitbreak.RPCInfo2Key)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;也可以自定义标签生成方法，使用&lt;code&gt;From()/To()/ServiceName()/Method()&lt;/code&gt;获取服务名/方法名：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 自定义Key生成函数示例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; CustomCBKeyFunc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ri&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; rpcinfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RPCInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 获取调用信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    from &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ri.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;From&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    to &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ri.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;To&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    method &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ri.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;To&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Method&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 自定义格式：服务名+方法名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;_&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;_&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, from, to, method)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 使用自定义Key函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;cbs &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; circuitbreak.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewCBSuite&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(CustomCBKeyFunc)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;以&lt;code&gt;api-gateway&lt;/code&gt;和&lt;code&gt;user-service&lt;/code&gt;为例：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// cmd/api-gateway/main.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 全局user-service客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userClient &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;userservice&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始化熔断器和客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; initCircuitBreaker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建熔断器 - 使用默认的RPCInfo2Key（method粒度）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	cbs &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; circuitbreak.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewCBSuite&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(circuitbreak.RPCInfo2Key)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建etcd服务发现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	r, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; etcd.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewEtcdRegistry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:2379&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建etcd注册中心失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建user-service客户端，启用熔断器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	cli, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userservice.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;user-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithResolver&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(r),                      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务发现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithCircuitBreaker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cbs),              &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 启用熔断器	client.WithRPCTimeout(3*time.Second),        // RPC超时	client.WithConnectTimeout(100*time.Millisecond), // 连接超时	client.WithClientBasicInfo(&amp;amp;rpcinfo.EndpointBasicInfo{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			ServiceName: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;api-gateway&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,               &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 当前服务名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//后续业务...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-服务降级-1&quot;&gt;服务降级&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;服务降级在各个层级都能发挥作用&lt;/strong&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-概念-4&quot;&gt;概念&lt;/h4&gt;&lt;p&gt;一般来说，&lt;strong&gt;服务降级会监测服务器系统资源，即当监控到服务器资源不足时，将某些非主要业务降级或关闭&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;具体来说，在系统资源紧张或非核心服务故障时（如促销期间），主动关闭部分非核心功能（如商品评论、推荐），或返回兜底数据，&lt;br /&gt;以保证核心交易链路（如下单、支付）的可用性。这是一种“舍车保帅”的生存策略&lt;/p&gt;

&lt;h4 id=&quot;article-实现-3&quot;&gt;实现&lt;/h4&gt;&lt;p&gt;由于服务降级一般要&lt;strong&gt;结合可观测行组件&lt;/strong&gt;实现系统监控等功能，故此处&lt;strong&gt;只提及降级策略和方法，不进行资源监控&lt;/strong&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-降级策略-1&quot;&gt;降级策略&lt;/h5&gt;&lt;p&gt;当系统资源不足时，有多种降级策略可供选择：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;默认降级：返回空响应&lt;/li&gt;
&lt;li&gt;静默降级：不抛错，返回空值或默认值，用户无感知&lt;/li&gt;
&lt;li&gt;缓存降级：返回缓存数据，不查实时数据&lt;/li&gt;
&lt;li&gt;备用服务降级：切换到备用服务/简单逻辑&lt;/li&gt;
&lt;li&gt;快速失败：立即返回错误，不处理&lt;/li&gt;
&lt;li&gt;延迟处理：请求排队，异步处理&lt;/li&gt;
&lt;li&gt;功能开关：关闭非核心功能&lt;/li&gt;
&lt;li&gt;简化流程：跳过复杂计算/校验&lt;/li&gt;
&lt;li&gt;数据裁剪：返回部分字段，不返回完整数据&lt;/li&gt;
&lt;li&gt;限流降级：限制请求频率&lt;/li&gt;
&lt;li&gt;超时降级：缩短超时时间&lt;/li&gt;
&lt;li&gt;重试降级：减少重试次数&lt;/li&gt;
&lt;li&gt;熔断降级：依赖故障时快速失败&lt;/li&gt;
&lt;li&gt;异步降级：同步转异步&lt;/li&gt;
&lt;li&gt;降级读：主库故障时读从库&lt;/li&gt;
&lt;li&gt;降级写：写操作转为异步队列&lt;/li&gt;
&lt;li&gt;静态化：动态转静态 &lt;/li&gt;
&lt;li&gt;合并请求：多个请求合并为一个&lt;/li&gt;
&lt;/ol&gt;

&lt;h5 id=&quot;article-手动降级-1&quot;&gt;手动降级&lt;/h5&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; degrade&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync/atomic&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 降级开关管理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    switches &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;atomic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Bool&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mu       &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RWMutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 降级开关配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DegradeConfig&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Name        &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 开关名称&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Description &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 描述&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Default     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;          // 默认状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    AutoRecover &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;          // 是否自动恢复&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    RecoverTime &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 自动恢复时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 电商系统降级开关&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degradeSwitches &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;coupon_service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: {  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 优惠券服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Name:        &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;coupon_service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Description: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;优惠券计算服务&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Default:     &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 默认不降级&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        AutoRecover: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        RecoverTime: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Minute,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;point_service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: {  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 积分服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Name:        &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;point_service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Description: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户积分服务&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Default:     &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        AutoRecover: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        RecoverTime: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Minute,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;notification_service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: {  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 通知服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Name:        &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;notification_service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Description: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;短信/邮件通知服务&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Default:     &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        AutoRecover: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        RecoverTime: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;30&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Minute,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;recommend_service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: {  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 推荐服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Name:        &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;recommend_service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Description: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;商品推荐服务&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Default:     &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        AutoRecover: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        RecoverTime: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;15&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Minute,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-自动降级-基于指标-1&quot;&gt;自动降级 (基于指标)&lt;/h5&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; degrade&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 自动降级器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; AutoDegrader&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    metrics     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;float64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 监控指标&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    thresholds  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;float64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 降级阈值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    status      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;     // 降级状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mu          &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RWMutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 监控指标定义&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; MetricType&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    CPULoad&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;      MetricType&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;cpu_load&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;       // CPU负载&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    MemoryUsage&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;  MetricType&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;memory_usage&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;   // 内存使用率&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    ErrorRate&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    MetricType&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;error_rate&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;     // 错误率&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    LatencyP99&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;   MetricType&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;latency_p99&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // P99延迟&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    QPS&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;          MetricType&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;qps&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 请求量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    Dependency&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;   MetricType&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;dependency&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;     // 依赖服务状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 降级规则配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DegradeRule&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Name        &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;      // 规则名称&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Metric      &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MetricType&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 监控指标&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Threshold   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;float64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;     // 触发阈值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Service     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;      // 影响的服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Action      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;      // 降级动作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Duration    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 降级持续时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 电商系统降级规则&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degradeRules &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeRule&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Name:      &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;high_cpu_coupon&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Metric:    CPULoad,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Threshold: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.8&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// CPU负载超过80%&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Service:   &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;coupon_service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Action:    &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;disable&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 禁用优惠计算&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Duration:  &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Minute,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Name:      &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;high_error_notification&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Metric:    ErrorRate,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Threshold: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0.1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 错误率超过10%&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Service:   &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;notification_service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Action:    &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;fallback&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 降级到简单通知&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Duration:  &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Minute,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Name:      &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;slow_dependency&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Metric:    LatencyP99,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Threshold: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1000&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// P99延迟超过1秒&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Service:   &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;recommend_service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Action:    &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;cache_only&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 只返回缓存数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Duration:  &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Minute,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-kitex框架下的实现-1&quot;&gt;kitex框架下的实现&lt;/h4&gt;&lt;p&gt;可惜，&lt;strong&gt;kitex并没有内置的服务降级组件&lt;/strong&gt;，我们只能自己写相关逻辑代码，然后用kitex的中间件功能实现服务降级&lt;/p&gt;
&lt;p&gt;以下为在项目中实现服务降级的示例代码：&lt;/p&gt;

&lt;h5 id=&quot;article-核心降级管理器-1&quot;&gt;核心降级管理器&lt;/h5&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; degrade&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/pkg/klog&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/pkg/rpcinfo&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/server&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// DegradeManager 降级管理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 降级开关&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    switches &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Map&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // map[serviceKey]*DegradeSwitch&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 降级规则&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    rules []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeRule&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 监控指标&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    metrics &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;float64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mu &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RWMutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 降级开关&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DegradeSwitch&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Service     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Method      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Enabled     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Reason      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    StartTime   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Strategy    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeStrategy&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mu          &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RWMutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 降级策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DegradeStrategy&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Type       &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StrategyType&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Config     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Fallback   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 策略类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; StrategyType&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    StrategyFastFail&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; StrategyType&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; iota&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 快速失败&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    StrategySilent&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                        // 静默处理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    StrategyFallback&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                      // 备用方案&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    StrategyCache&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                         // 缓存降级&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    StrategyTimeout&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                       // 超时降级&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    StrategyRetry&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                         // 重试降级&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 降级规则&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DegradeRule&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ID          &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Service     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Method      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Condition   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeCondition&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Strategy    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeStrategy&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Duration    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Priority    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Enabled     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 降级条件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DegradeCondition&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Type       &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ConditionType&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Metric     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Operator   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Threshold  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;float64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Duration   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 条件类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ConditionType&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    ConditionManual&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ConditionType&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; iota&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 手动触发&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    ConditionCPU&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                          // CPU负载&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    ConditionMemory&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                       // 内存使用&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    ConditionErrorRate&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                    // 错误率&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    ConditionLatency&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                      // 延迟&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    ConditionQPS&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                          // 请求量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    ConditionDependency&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                   // 依赖服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始化降级管理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewDegradeManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        switches: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        rules:    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeRule&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        metrics:  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;float64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 检查服务是否降级&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;dm &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsDegraded&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;method&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeSwitch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    key &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; serviceKey&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(service, method)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 检查是否有明确的开关&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; switchVal, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dm.switches.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Load&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(key); ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; switchVal.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeSwitch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RLock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RUnlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.Enabled, s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 检查是否有匹配的规则&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    dm.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RLock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dm.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RUnlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(dm.rules) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;--&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 从高优先级开始&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        rule &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dm.rules[i]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;rule.Enabled {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; matchesRule&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(service, method, rule) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dm.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;checkCondition&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(rule.Condition) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // 创建临时开关&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                switchVal &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeSwitch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    Service:   service,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    Method:    method,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    Enabled:   &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    Reason:    rule.Condition.Type.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    StartTime: time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    Strategy:  rule.Strategy,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                dm.switches.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Store&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(key, switchVal)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // 设置自动恢复&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rule.Duration &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                    go&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dm.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;autoRecover&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(service, method, rule.Duration)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, switchVal&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 手动降级&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;dm &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetDegrade&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;method&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;reason&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    strategy&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DegradeStrategy&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;duration&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    key &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; serviceKey&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(service, method)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    switchVal &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeSwitch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Service:   service,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Method:    method,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Enabled:   &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Reason:    reason,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        StartTime: time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Strategy:  strategy,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    dm.switches.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Store&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(key, switchVal)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; duration &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        go&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dm.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;autoRecover&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(service, method, duration)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Infof&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务降级: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, 原因: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, service, method, reason)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 手动恢复&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;dm &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Recover&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;method&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    key &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; serviceKey&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(service, method)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; switchVal, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dm.switches.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Load&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(key); ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; switchVal.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeSwitch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s.Enabled &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        s.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Infof&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务恢复: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, service, method)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 自动恢复&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;dm &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;autoRecover&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;method&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;duration&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    timer &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewTimer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(duration)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;timer.C&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    dm.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Recover&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(service, method)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Infof&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务自动恢复: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, service, method)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 检查降级条件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;dm &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;checkCondition&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cond&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DegradeCondition&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    dm.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RLock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dm.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RUnlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    value, exists &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dm.metrics[cond.Metric]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;exists {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cond.Operator {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&amp;gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; value &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cond.Threshold&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&amp;gt;=&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; value &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cond.Threshold&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&amp;lt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; value &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cond.Threshold&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&amp;lt;=&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; value &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cond.Threshold&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;==&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; value &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cond.Threshold&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 更新监控指标&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;dm &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UpdateMetrics&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;metrics&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;float64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    dm.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dm.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; k, v &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; metrics {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        dm.metrics[k] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; v&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 检查是否需要触发自动降级&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    dm.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;checkAutoDegrade&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 检查自动降级&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;dm &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;checkAutoDegrade&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, rule &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dm.rules {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;rule.Enabled &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rule.Condition.Type &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ConditionManual {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dm.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;checkCondition&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(rule.Condition) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            dm.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetDegrade&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(rule.Service, rule.Method, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                rule.Condition.Type.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), rule.Strategy, rule.Duration)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; serviceKey&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;method&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; service &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;.&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; method&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; matchesRule&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;method&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;rule&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; DegradeRule&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rule.Service &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;*&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rule.Service &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; service {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rule.Method &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;*&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rule.Method &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; method {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-kitex降级中间件-1&quot;&gt;kitex降级中间件&lt;/h5&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; middleware&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/pkg/endpoint&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/pkg/klog&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/pkg/rpcinfo&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your_project/degrade&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 导入降级包&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建服务端降级中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; CreateDegradeMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;degradeManager&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;degrade&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Middleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;next&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;resp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;err&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 获取服务信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ri &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rpcinfo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetRPCInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ri &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            service &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ri.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;To&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            method &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ri.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;To&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Method&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 检查是否降级&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            isDegraded, degradeSwitch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degradeManager.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsDegraded&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(service, method)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;isDegraded &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degradeSwitch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warnf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务降级中: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, 原因: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                service, method, degradeSwitch.Reason)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 执行降级策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeDegradeStrategy&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp, degradeSwitch.Strategy)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 执行降级策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeDegradeStrategy&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;resp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    strategy&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; degrade&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeStrategy&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strategy.Type {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degrade.StrategyFastFail:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeFastFail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp, strategy.Config)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degrade.StrategySilent:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeSilent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp, strategy.Config)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degrade.StrategyFallback:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeFallback&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp, strategy)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degrade.StrategyCache:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeCache&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp, strategy.Config)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degrade.StrategyTimeout:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeTimeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp, strategy.Config)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degrade.StrategyRetry:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeRetry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp, strategy.Config)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeDefault&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 快速失败策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeFastFail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;resp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    config&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 直接返回错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    errorMsg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;服务暂时不可用，请稍后重试&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; config[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;error_message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]; ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        errorMsg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warnf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;快速失败降级: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errorMsg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(errorMsg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 静默处理策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeSilent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;resp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    config&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 返回默认值，不报错&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;静默降级: 返回默认值&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 根据响应类型设置默认值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 这里需要根据具体的响应类型来设置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 例如：if r, ok := resp.(*YourResponse); ok { ... }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 备用方案策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeFallback&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;resp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    strategy&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; degrade&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeStrategy&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strategy.Fallback &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;降级策略未定义备用方案&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;执行备用方案降级&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 执行备用方案&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fallbackResp, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strategy.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fallback&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;备用方案执行失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 复制响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 这里需要根据具体的类型来复制&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 例如：resp = fallbackResp&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 缓存降级策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeCache&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;resp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    config&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    cacheKey &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; generateCacheKey&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(req)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ttl &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 5&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Minute&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ttlStr, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; config[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;ttl&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]; ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; d, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ParseDuration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ttlStr.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ttl &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; d&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Infof&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;缓存降级: key=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, ttl=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, cacheKey, ttl)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 从缓存获取数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    cachedData &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getFromCache&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cacheKey)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cachedData &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 设置响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // resp = cachedData&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;缓存降级: 返回缓存数据&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 缓存未命中，返回默认值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;缓存降级: 缓存未命中，返回默认值&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 超时降级策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeTimeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;resp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    config&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    timeout &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 100&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Millisecond&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; timeoutStr, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; config[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;timeout&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]; ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; d, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ParseDuration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(timeoutStr.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            timeout &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; d&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Infof&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;超时降级: timeout=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, timeout)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 设置超时上下文&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ctx, cancel &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithTimeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, timeout)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; cancel&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 尝试快速处理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    done &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 这里应该调用正常的处理逻辑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 但为了演示，我们直接返回&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        done &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Done&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;():&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;超时降级: 请求超时，返回降级响应&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;done:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 重试降级策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeRetry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;resp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;    config&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    maxRetries &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; retries, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; config[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;max_retries&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]; ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        maxRetries &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(retries.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;float64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    retryDelay &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 100&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Millisecond&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; delay, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; config[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;retry_delay&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]; ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; d, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ParseDuration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(delay.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            retryDelay &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; d&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Infof&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;重试降级: maxRetries=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, delay=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, maxRetries, retryDelay)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; lastErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; maxRetries; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(retryDelay)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Infof&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;重试降级: 第 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 次重试&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 这里应该调用正常的处理逻辑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 但为了演示，我们直接返回成功&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; maxRetries&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 最后一次重试&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;重试降级: 达到最大重试次数，返回降级响应&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; lastErr&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 默认降级策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; executeDefault&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;resp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;默认降级: 返回空响应&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 辅助函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; generateCacheKey&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 根据请求生成缓存key&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;cache:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, req)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getFromCache&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;key&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 模拟从缓存获取数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-客户端降级中间件-1&quot;&gt;客户端降级中间件&lt;/h5&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; client&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/client&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/pkg/endpoint&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/pkg/klog&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/pkg/rpcinfo&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 客户端降级中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ClientDegradeMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;degradeManager&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;degrade&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DegradeManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;client&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Middleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;next&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;resp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 获取调用的服务信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ri &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rpcinfo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetRPCInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ri &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            service &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ri.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;To&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            method &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ri.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;To&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Method&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 检查是否降级&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            isDegraded, degradeSwitch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degradeManager.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsDegraded&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(service, method)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;isDegraded &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degradeSwitch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warnf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;客户端降级: 服务 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 已降级，原因: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                service, method, degradeSwitch.Reason)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 执行客户端降级策略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degradeSwitch.Strategy.Type {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degrade.StrategyFastFail:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // 快速失败，不发起调用&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 已降级，调用失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, service)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degrade.StrategyFallback:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // 执行备用方案&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degradeSwitch.Strategy.Fallback &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    fallbackResp, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; degradeSwitch.Strategy.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fallback&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                        // 复制响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                        // resp = fallbackResp&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                        klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;客户端降级: 执行备用方案成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 已降级，且无备用方案&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, service)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // 其他策略，尝试调用&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                klog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;客户端降级: 尝试调用已降级服务&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, req, resp)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-microservice-strategy/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>微服务</category><category>分布式</category></item><item><title>服务发现：从手搓注册中心到etcd与kitex的快速集成</title><link>https://www.claran-blog.work/posts/go-etcd/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-etcd/</guid><description>注册中心etcd详解和kitex框架下的代码实现.</description><pubDate>Wed, 04 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-引言-1&quot;&gt;引言&lt;/h2&gt;&lt;p&gt;注册中心（register）就是服务信息的存储器，存储记录了每个注册服的务网络地址等信息（微服务的ServiceName、IP、Port、MetaData等），常用的注册中心如&lt;code&gt;etcd&lt;/code&gt;，&lt;code&gt;concul&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;关于注册中心更详细的概念讲解可阅读上一篇文章：&lt;strong&gt;&lt;a href=&quot;https://www.claran-blog.work/go-kitex/&quot;&gt;Link&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;这篇文章以etcd为主例讲解&lt;/strong&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-特性-1&quot;&gt;特性&lt;/h2&gt;&lt;p&gt;etcd采用键值对存储网络实例&lt;/p&gt;
&lt;p&gt;注册中心应该有以下三个特性：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;服务注册(Registry)&lt;/strong&gt;：为rpc路由注册服务&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;服务发现(Resolver/Discovery)&lt;/strong&gt;：为api查找rpc服务&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;健康检查(KeepAlive)&lt;/strong&gt;：keepalive保障注册键值对存活&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;article-服务注册中心的代码实现与解释-1&quot;&gt;服务注册中心的代码实现与解释&lt;/h2&gt;&lt;p&gt;接下来在go里面实现etcd注册中心&lt;/p&gt;
&lt;p&gt;日常开发为避免重复造轮子，&lt;strong&gt;可直接使用kitex内部自带的etcd服务注册和发现拓展包&lt;/strong&gt;，kitex自带etcd包在该栏目后讲解，此处不使用kitex框架便于理解原理&lt;/p&gt;

&lt;h3 id=&quot;article-核心流程-1&quot;&gt;核心流程&lt;/h3&gt;
&lt;h4 id=&quot;article-服务注册流程-1&quot;&gt;服务注册流程&lt;/h4&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;1. 服务启动 -&amp;gt; 连接etcd -&amp;gt; 创建ServiceInfo -&amp;gt; 注册到etcd -&amp;gt; 启动续约 -&amp;gt; 监听RPC请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;2. 服务关闭 -&amp;gt; 收到信号 -&amp;gt; 注销服务 -&amp;gt; 停止续约 -&amp;gt; 退出程序&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-服务发现流程-1&quot;&gt;服务发现流程&lt;/h4&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;1. 网关接收HTTP请求 -&amp;gt; 从etcd查询服务 -&amp;gt; 获取服务实例列表&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;2. 随机选择实例 -&amp;gt; 创建RPC客户端 -&amp;gt; 转发请求 -&amp;gt; 返回响应&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-数据流-1&quot;&gt;数据流&lt;/h4&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;客户端 -&amp;gt; HTTP请求 -&amp;gt; API网关 -&amp;gt; etcd查询 -&amp;gt; 微服务 -&amp;gt; RPC调用 -&amp;gt; 返回响应 -&amp;gt; 客户端&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-环境准备-1&quot;&gt;环境准备&lt;/h3&gt;&lt;p&gt;安装etcd（拉取docker镜像）&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 拉取最新稳定版镜像&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; pull&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; quay.io/coreos/etcd:v3.5.0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 运行单节点集群&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -d&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 2379:2379&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \ &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;          # 客户端通信端口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;  -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 2380:2380&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \ &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;          # 节点间通信端口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;  --name&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; etcd&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \ &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           # 容器名称&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;  quay.io/coreos/etcd:v3.5.0&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \ &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 镜像版本&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;  /usr/local/bin/etcd&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \ &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;   # etcd二进制文件路径&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;  --advertise-client-urls&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; http://0.0.0.0:2379&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \ &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; # 对外暴露的客户端URL&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;  --listen-client-urls&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; http://0.0.0.0:2379&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;       # 监听的客户端URL&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-etcd公共包-1&quot;&gt;etcd公共包&lt;/h3&gt;
&lt;h4 id=&quot;article-客户端封装-client-1&quot;&gt;客户端封装（Client）&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//pkg/etcd/client.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; etcd&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go.etcd.io/etcd/clientv3&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Client结构体包装etcd客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Client&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;clientv3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 嵌入原始etcd客户端，可以直接调用其方法&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// NewClient 创建etcd客户端实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// endpoints: etcd服务器地址列表，如 [&quot;localhost:2379&quot;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 返回: 自定义的Client实例和错误信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;endpoints&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建etcd客户端配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    cli, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; clientv3.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;clientv3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Endpoints:   endpoints,        &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// etcd服务器地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        DialTimeout: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 连接超时时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 连接失败返回错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 返回包装后的客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{cli}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-服务注册-registry-1&quot;&gt;服务注册（Registry）&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//pkg/etcd/registry.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; etcd&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;encoding/json&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go.etcd.io/etcd/clientv3&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ServiceInfo 定义服务信息结构&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 用于在etcd中存储服务实例的元数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ServiceInfo&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ID      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 服务实例的唯一ID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Name    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 服务名称，如&quot;user-service&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Address &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 服务地址，如&quot;127.0.0.1&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Port    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;               // 服务端口，如8888&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Meta    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 服务元数据，如版本、环境等&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Registry 服务注册器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 负责将服务信息注册到etcd，并维护租约&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Registry&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    client   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // etcd客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    service  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceInfo&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;      // 服务信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    leaseID  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;clientv3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LeaseID&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 租约ID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    stopChan &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}     &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 停止信号通道&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// NewRegistry 创建注册器实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// client: etcd客户端实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// service: 要注册的服务信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewRegistry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;client&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Registry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Registry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client:   client,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        service:  service,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        stopChan: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}),  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始化停止通道&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Register 注册服务到etcd&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ctx: 上下文，用于控制注册过程&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ttl: 租约存活时间(秒)，到期后etcd自动删除服务信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;r &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Registry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ttl&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建租约&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 租约是etcd中的一个时间租约，到期后自动删除相关键值对&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    leaseResp, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Grant&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, ttl)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建租约失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    r.leaseID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; leaseResp.ID  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 保存租约ID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 序列化服务信息为JSON供etcd存储&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    data, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Marshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(r.service)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;序列化失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 将服务信息写入etcd&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 键的格式: /services/{服务名}/{实例ID}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    key &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/services/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, r.service.Name, r.service.ID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    _, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Put&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, key, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(data), clientv3.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithLease&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(r.leaseID))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;注册失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动续约协程，保持服务在线状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;keepAlive&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务注册成功: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;)&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, r.service.Name, r.service.Address, r.service.Port)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Deregister 从etcd注销服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务关闭时调用，删除服务注册信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;r &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Registry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Deregister&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 发送停止信号，停止续约协程&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(r.stopChan)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 从etcd删除服务信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    key &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/services/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, r.service.Name, r.service.ID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    _, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Delete&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, key)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 撤销租约，释放资源&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    _, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Revoke&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, r.leaseID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务注销: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, r.service.Name)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// keepAlive 租约续约协程&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 定期向etcd发送心跳，保持租约有效&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;r &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Registry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;keepAlive&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动租约续约&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ka, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;KeepAlive&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, r.leaseID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 续约失败直接返回&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 监听续约通道&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ka:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 收到续约响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // 通道关闭，停止续约&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 续约成功，服务继续在线&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r.stopChan:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 收到停止信号，停止续约&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-keepalive-1&quot;&gt;KeepAlive&lt;/h5&gt;&lt;p&gt;上述代码中，&lt;code&gt;client.KeepAlive&lt;/code&gt;会返回一个通道，etcd会&lt;strong&gt;定期&lt;/strong&gt;（通常为ttl的1/3，可配置）&lt;strong&gt;往通道发送健康检查信号并自动续期&lt;/strong&gt;，我们就需要异步goroutine持续监听该通道来接受该信号并检查服务健康状态&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/etcd.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-metadata-1&quot;&gt;Metadata&lt;/h5&gt;&lt;p&gt;另一方面，在服务实例增加&lt;strong&gt;服务元数据&lt;/strong&gt;，可以支持均衡&lt;strong&gt;负载机制&lt;/strong&gt;等功能的拓展，在服务被发现时可以根据元数据进行一定策略的服务实例选择，更细致的部分在服务治理再细嗦&lt;/p&gt;

&lt;h4 id=&quot;article-服务发现-discovery-1&quot;&gt;服务发现（discovery）&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//pkg/etcd/discovery.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; etcd&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;encoding/json&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;math/rand&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go.etcd.io/etcd/clientv3&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Discover 服务发现器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 负责从etcd查询服务实例信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Discover&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    client  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // etcd客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    service &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;   // 要发现的服务名称&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// NewDiscover 创建服务发现器实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// client: etcd客户端实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// service: 要发现的服务名称&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewDiscover&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;client&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Discover&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Discover&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client:  client,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        service: service,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// GetService 从etcd获取一个服务实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 使用随机负载均衡策略选择一个实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;d &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Discover&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 构造查询前缀&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 查询格式: /services/{服务名}/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    prefix &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/services/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, d.service)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 从etcd查询所有匹配的服务实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // WithPrefix(): 查询所有以prefix为前缀的键&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    resp, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; d.client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Get&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, prefix, clientv3.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithPrefix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;查询失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 检查是否有可用实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(resp.Kvs) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;没有找到服务: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, d.service)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 随机选择一个服务实例（简单的负载均衡）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 使用当前时间作为随机种子&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    rand.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Seed&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UnixNano&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    kv &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; resp.Kvs[rand.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Intn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(resp.Kvs))]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 反序列化服务信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; info &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceInfo&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unmarshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(kv.Value, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;info); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;解析失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 返回服务信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;info, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-均衡负载-1&quot;&gt;均衡负载&lt;/h5&gt;&lt;p&gt;在上述代码中，我们使用随机选择服务实例模拟了均衡负载的结果，有关均衡负载机制放在服务治理细嗦，此处只需要意识到其存在&lt;/p&gt;

&lt;h3 id=&quot;article-微服务主程序示例-1&quot;&gt;微服务主程序示例&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 用户微服务主程序&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 启动用户服务，注册到etcd，监听RPC请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os/signal&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;syscall&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/server&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user-service/kitex_gen/user/userservice&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // Kitex自动生成的代码&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;etcd-simple-demo/pkg/etcd&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;启动用户服务...&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 连接etcd服务注册中心&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // endpoints: etcd服务器地址列表，这里使用默认端口2379&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    etcdClient, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; etcd.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;localhost:2379&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;连接etcd失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; etcdClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 程序退出时关闭etcd连接&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 服务配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    serviceName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;user-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 服务名称，用于etcd注册&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    port &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 8888&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                   // 服务监听端口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 生成服务实例ID：服务名-IP-时间戳，确保唯一性&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    instanceID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;getLocalIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建服务信息对象&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 包含服务的元数据，将注册到etcd&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    serviceInfo &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;etcd&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ID:      instanceID,             &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务实例唯一ID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Name:    serviceName,            &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务名称&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Address: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;getLocalIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),           &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务IP地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Port:    port,                   &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务端口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Meta: &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{         &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务元数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;version&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;1.0.0&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;env&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:     &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建服务注册器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    registry &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; etcd.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewRegistry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(etcdClient, serviceInfo)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 注册服务到etcd&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建10秒TTL的租约，服务需要定期续约保持在线&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ctx &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; registry.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;注册服务失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 设置优雅关闭&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 监听系统信号，程序退出前注销服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    setupGracefulShutdown&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(registry)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动RPC服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 解析TCP地址，监听指定端口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    addr, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; net.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ResolveTCPAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;tcp&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, port))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建Kitex服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    svr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userservice.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        new&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),     &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 业务逻辑处理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithServiceAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(addr),  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 设置监听地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 打印启动信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户服务启动成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;   监听地址: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;getLocalIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), port)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;   注册到etcd: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, instanceID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;   可用接口: Register, Login&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动服务，阻塞等待请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; svr.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Run&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务运行失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// getLocalIP 获取本机非回环IP地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 返回: 本机IP地址字符串&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getLocalIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 获取所有网络接口地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    addrs, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; net.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InterfaceAddrs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;127.0.0.1&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 获取失败返回本地回环地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 遍历所有地址，找到第一个非回环的IPv4地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, addr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; addrs {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ipnet, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; addr.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IPNet&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ipnet.IP.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsLoopback&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ipnet.IP.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;To4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ipnet.IP.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;127.0.0.1&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 未找到返回本地回环地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// setupGracefulShutdown 设置优雅关闭&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 监听系统信号，在程序退出前注销etcd中的服务注册&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; setupGracefulShutdown&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;registry&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;etcd&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Registry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    stopChan &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; os&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Signal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建信号通道&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 监听中断信号和终止信号&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    signal.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Notify&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(stopChan, syscall.SIGINT, syscall.SIGTERM)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动协程等待信号&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;stopChan  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 阻塞等待信号&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;收到关闭信号，正在注销服务...&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 从etcd注销服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; registry.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Deregister&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;注销失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务关闭完成&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 退出程序&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;流程图&lt;/strong&gt;&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;链接etcd服务注册中心&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;构造服务注册实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;创建服务注册器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;      ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;注册服务&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-api网关主程序-1&quot;&gt;api网关主程序&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// API网关主程序&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 提供HTTP接口，通过etcd发现服务，转发请求到对应的微服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/hertz/pkg/app&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/hertz/pkg/app/server&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/client&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;etcd-simple-demo/pkg/etcd&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user-service/kitex_gen/user&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user-service/kitex_gen/user/userservice&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;启动API网关...&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 连接etcd服务注册中心&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    etcdClient, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; etcd.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;localhost:2379&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;连接etcd失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; etcdClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动HTTP服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // Hertz是高性能HTTP框架，监听8080端口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithHostPorts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:8080&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 注册HTTP路由和处理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/health&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, healthCheck)                          &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 健康检查接口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;POST&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/api/register&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;createRegisterHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(etcdClient))  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 用户注册&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 打印启动信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;API网关启动成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;   访问地址: http://localhost:8080&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;   可用接口:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;   GET    /health             健康检查&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;   POST   /api/register       用户注册&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动HTTP服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Spin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// healthCheck 健康检查处理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 用于监控网关服务是否正常运行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; healthCheck&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;app&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RequestContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;200&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;ok&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;api-gateway&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;time&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// createRegisterHandler 创建用户注册HTTP处理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 返回一个闭包函数，闭包可以访问etcdClient&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; createRegisterHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;etcdClient&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;etcd&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;app&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HandlerFunc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;app&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RequestContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 从etcd发现用户服务实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        discover &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; etcd.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewDiscover&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(etcdClient, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        instance, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; discover.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 服务发现失败，返回503服务不可用&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;503&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errorResponse&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户服务不可用&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 解析HTTP请求体为JSON&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; req &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            Username &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;username&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            Password &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;password&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            Email    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;email&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BindJSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;req); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errorResponse&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;参数错误&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 创建RPC客户端连接到用户服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        endpoint &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, instance.Address, instance.Port)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        userClient, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userservice.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;user-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithHostPorts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(endpoint),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errorResponse&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;内部错误&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 构造RPC请求并调用用户服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        rpcReq &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterRequest&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            Username: req.Username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            Password: req.Password,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            Email:    req.Email,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        rpcResp, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, rpcReq)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errorResponse&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务调用失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 根据RPC响应返回HTTP响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rpcResp.Success {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;200&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;successResponse&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;注册成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;                &quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: rpcResp.UserId,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        } &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errorResponse&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(rpcResp.Message))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// successResponse 成功响应格式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; successResponse&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;message&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;data&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;code&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;200&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: message,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;data&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    data,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// errorResponse 错误响应格式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; errorResponse&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;message&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;code&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: message,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;流程图&lt;/strong&gt;&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;创建服务发现器并寻找实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;     ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;从服务发现器获取实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;     ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;提取实例元数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;     ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;继续调用rpc/返回响应&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-进阶-1&quot;&gt;进阶&lt;/h3&gt;&lt;p&gt;以上讲解了最基础的etcd注册中心的实现和使用，但是并不是etcd注册中心的最优形态，在生产级环境中，我们会用到以下进阶部分优化我们的注册中心&lt;/p&gt;

&lt;h4 id=&quot;article-本地缓存-1&quot;&gt;本地缓存&lt;/h4&gt;&lt;p&gt;在基础版本中，每次服务调用都需要查询etcd，这会带来显著的性能开销：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;网络延迟&lt;/strong&gt;：每次RPC调用前都需要与etcd通信&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;etcd压力&lt;/strong&gt;：大量服务实例同时查询会压垮etcd&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;单点故障&lt;/strong&gt;：etcd宕机将导致整个系统无法服务发现&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;因此，一如redis之于数据库那样，我们可以考虑&lt;strong&gt;引入本地缓存&lt;/strong&gt;缓解服务器压力&lt;/p&gt;
&lt;p&gt;我们可以在服务发现器的实例中新增服务缓存：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ServiceDiscovery&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    client    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;clientv3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // etcd客户端连接&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    services  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;][]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceInstance&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 服务缓存: 服务名-&amp;gt;实例列表&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    stopChan  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}     &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 停止信号通道&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 注意：这里没有添加并发锁，多个goroutine访问services map会有并发问题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这样，对于每个服务发现器，都有内部的内存缓存缓解压力，监听到新的注册就写入缓存，监听到注册信息改动就更新缓存信息（删+再写），监听到注册失效就删除缓存&lt;/p&gt;
&lt;p&gt;更进阶的，比如说使用redis集群作缓存，实现更为复杂，先按下不表&lt;/p&gt;
&lt;p&gt;不过刚刚我们发现了一个新的词语&lt;strong&gt;监听&lt;/strong&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-服务监听-1&quot;&gt;服务监听&lt;/h4&gt;&lt;p&gt;etcd的&lt;code&gt;Watch&lt;/code&gt;机制是服务发现监听的核心，它允许客户端监听特定key的前缀变化&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Watch工作流&lt;/strong&gt;&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;客户端建立Watch连接&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;监听 /services/user-service/ 前缀&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;etcd推送事件（PUT/DELETE）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    ↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;客户端更新本地服务列表&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;根据不同的事件，我们可以配合缓存进行优化：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 本地缓存如何保持最新&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; 缓存更新机制&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 首次启动，全量获取&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    缓存 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; 从etcd获取所有实例&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 监听etcd变化（Watch机制）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; 事件 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; etcd.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Watch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; 事件类型 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; 新增 {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                缓存.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;添加&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(事件.实例)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            } &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; 事件类型 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; 删除 {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                缓存.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;删除&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(事件.实例)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            } &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; 事件类型 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; 更新 {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                缓存.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;更新&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(事件.实例)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 定期刷新（兜底机制，防止Watch丢失事件）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;30&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            缓存 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; 从etcd获取所有实例&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 全量刷新&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;示例代码&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// watchServiceChanges 监听etcd服务变化并更新本地缓存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// cache: 本地缓存map，格式为 map[服务名][]服务实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// serviceName: 要监听的服务名称&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; watchServiceChanges&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;client&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;clientv3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cache&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;][]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceInstance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;serviceName&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 构建监听的前缀key&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    watchKey &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/services/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, serviceName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 开始监听etcd变化&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    watchChan &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Watch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, watchKey, clientv3.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithPrefix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; watchResp &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; watchChan {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, event &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; watchResp.Events {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // 根据事件类型处理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Type {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; clientv3.EventTypePut: &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 新增或更新&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;                    handlePutEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(event, cache, serviceName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; clientv3.EventTypeDelete: &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 删除&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;                    handleDeleteEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(event, cache, serviceName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// handlePutEvent 处理新增或更新事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; handlePutEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;event&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;clientv3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Event&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cache&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;][]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceInstance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;serviceName&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 解析etcd中的服务实例信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instance &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceInstance&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; json.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unmarshal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(event.Kv.Value, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;instance); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;解析服务实例失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 获取当前服务列表&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    instances, exists &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cache[serviceName]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 更新或添加实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    found &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i, ins &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instances {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ins.ID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instance.ID {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 更新已有实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            instances[i] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;instance&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            found &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            break&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;found {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 添加新实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        cache[serviceName] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(instances, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;instance)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务实例更新: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;)&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, serviceName, instance.ID, instance.Address, instance.Port)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// handleDeleteEvent 处理删除事件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; handleDeleteEvent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;event&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;clientv3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Event&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;cache&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;][]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServiceInstance&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;serviceName&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 从key中提取实例ID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    keyParts &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Split&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(event.Kv.Key), &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(keyParts) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    instanceID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; keyParts[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 从缓存中删除该实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    instances, exists &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cache[serviceName]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;exists {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 查找并删除&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i, ins &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instances {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ins.ID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instanceID {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 从切片中删除元素&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            cache[serviceName] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(instances[:i], instances[i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务实例删除: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, serviceName, instanceID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-并发安全-1&quot;&gt;并发安全&lt;/h4&gt;&lt;p&gt;大部分基础项目在遇到&lt;strong&gt;高并发场景&lt;/strong&gt;的情况下，都难免会出现一些问题&lt;/p&gt;
&lt;p&gt;同样的，etcd实现的注册中心在高并发场景下的问题如下：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;缓存崩溃：由于go内部的map并不是并发安全的，所以在未设置互斥锁的情况下，多线程读写map会导致程序panic，因为缓存读多写少，应使用读写锁管理&lt;/li&gt;
&lt;li&gt;数据竞争：leaseID存在竞争条件，应使用互斥锁管理&lt;br /&gt;...(还有很多)&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-实例元数据-1&quot;&gt;实例元数据&lt;/h4&gt;&lt;p&gt;我们知道，一个被注册的服务实例通常含有其地址，端口，服务名等信息。在这个基础上，我们可以在实例结构体内新增&lt;strong&gt;实例元数据&lt;/strong&gt;（&lt;strong&gt;metadata&lt;/strong&gt;）标记该实例的详细信息，例如系统资源占用情况，复杂度，版本号，标签等信息，以便我们进行&lt;strong&gt;均衡负载机制&lt;/strong&gt;调控，&lt;strong&gt;版本管理&lt;/strong&gt;和&lt;strong&gt;标签过滤&lt;/strong&gt;等功能&lt;/p&gt;
&lt;p&gt;大部分会在后续的&lt;strong&gt;服务治理学习&lt;/strong&gt;中展开细讲&lt;/p&gt;

&lt;h2 id=&quot;article-kitex-etcd-1&quot;&gt;kitex-etcd&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;万幸的是，以上部分的内容我们并不需要挨个手写，强大的kitex会帮我们搞定&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;CloudWeGo社区对kitex框架提供了官方的etcd注册中心插件，专门用于集成etcd注册中心的服务注册和发现&lt;/p&gt;
&lt;p&gt;在该框架下，服务注册和发现非常简单，这样我们以后在自己写微服务的时候就没有自己写一大堆服务注册器或服务发射器的必要了，方便又快捷&lt;/p&gt;

&lt;h3 id=&quot;article-快速学习-1&quot;&gt;快速学习&lt;/h3&gt;&lt;p&gt;kitex封装的etcd包十分方便，只需要创建一个注册中心/解析器，再在&lt;code&gt;NewServer&lt;/code&gt;/&lt;code&gt;NewClient&lt;/code&gt;时加一个配置项（注册/发现）即可&lt;/p&gt;

&lt;h4 id=&quot;article-安装依赖-1&quot;&gt;安装依赖&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 安装 registry-etcd&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; get&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; github.com/kitex-contrib/registry-etcd&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 安装 etcd 客户端库&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; get&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; go.etcd.io/etcd/client/v3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 启动 etcd（Docker）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -d&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 2379:2379&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  --name&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; etcd&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  quay.io/coreos/etcd:v3.5.0&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  etcd&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; --advertise-client-urls&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; http://0.0.0.0:2379&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;        --listen-client-urls&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; http://0.0.0.0:2379&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-服务注册示例-1&quot;&gt;服务注册示例&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/pkg/rpcinfo&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/server&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    etcd &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/kitex-contrib/registry-etcd&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;demo/kitex_gen/echo&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;demo/kitex_gen/echo/echoservice&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; EchoServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EchoServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Echo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;echo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EchoRequest&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;echo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EchoResponse&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;echo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EchoResponse&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Message: req.Message}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建 etcd 注册中心&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    r, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; etcd.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewEtcdRegistry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:2379&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动服务并注册&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    addr, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; net.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ResolveTCPAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;tcp&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:8888&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    svr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; echoservice.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;        new&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EchoServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithServiceAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(addr),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithServerBasicInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;rpcinfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EndpointBasicInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ServiceName: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;echo-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithRegistry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(r),  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 注册到 etcd&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务已启动并注册到 etcd&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    svr.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Run&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-服务发现示例-1&quot;&gt;服务发现示例&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/client&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    etcd &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/kitex-contrib/registry-etcd&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;demo/kitex_gen/echo&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;demo/kitex_gen/echo/echoservice&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建 etcd 解析器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    r, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; etcd.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewEtcdResolver&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:2379&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建客户端（自动发现服务）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    client, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; echoservice.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;echo-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 服务名，必须与服务端一致&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithResolver&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(r),  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 从 etcd 发现服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithRPCTimeout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.Second),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 调用服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    resp, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Echo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;echo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EchoRequest&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Message: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Hello from client&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;收到响应: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, resp.Message)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-拓展-1&quot;&gt;拓展&lt;/h2&gt;&lt;p&gt;现在我们了解到了，etcd其实就是一个&lt;strong&gt;kv式存储系统&lt;/strong&gt;，这也就意味着etcd还能够实现许多功能（横向比较redis），例如通过etcd实现阻塞式的&lt;strong&gt;分布式锁&lt;/strong&gt;，且不会像redis那样单点故障：&lt;strong&gt;&lt;a href=&quot;https://b23.tv/Widbhcr&quot;&gt;redis，mysql和etcd实现分布式锁的区别&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;有关etcd的更多使用，今后再来回顾🥺&lt;/p&gt;

&lt;h2 id=&quot;article-学习文章-1&quot;&gt;学习文章&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.cloudwego.io/zh/docs/kitex/tutorials/third-party/service_discovery/etcd/&quot;&gt;kitex-etcd | CloudWeGo&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-etcd/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>微服务</category><category>分布式</category></item><item><title>走进hertz框架</title><link>https://www.claran-blog.work/posts/go-hertz/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-hertz/</guid><description>对hertz框架的简单介绍.</description><pubDate>Mon, 02 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-引言-1&quot;&gt;引言&lt;/h2&gt;&lt;p&gt;即将进入微服务时，hertz是最好要学习的一个web框架，这篇文章简单介绍一下hertz的特色和使用示例&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;代码示例仓库：&lt;a href=&quot;https://github.com/Claran309/microservice-learning-demo&quot;&gt;Link&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-概述-1&quot;&gt;概述&lt;/h2&gt;&lt;p&gt;hertz是一个由&lt;strong&gt;字节跳动&lt;/strong&gt;开发的高性能web框架&lt;/p&gt;
&lt;p&gt;相比于gin框架，hertz性能更高，&lt;strong&gt;原生主持http1.1/http2和websocket&lt;/strong&gt;等协议，支持IDL一键生成代码，且内部封装多重常用中间件，更加适应于微服务和云原生项目&lt;/p&gt;

&lt;h2 id=&quot;article-快速学习-1&quot;&gt;快速学习&lt;/h2&gt;&lt;p&gt;由于hertz的类gin API设计，拥有gin基础后学习hertz的成本会很低，此处进行常规代码示例和与gin差异之处的讲解&lt;/p&gt;

&lt;h3 id=&quot;article-启动服务器-使用中间件与注册路由-1&quot;&gt;启动服务器、使用中间件与注册路由&lt;/h3&gt;&lt;p&gt;与gin类似，区别在于hertz启动服务器为srv.spin()&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始化 Hertz 服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 默认使用 Netpoll 网络库&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithHostPorts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:8080&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 监听端口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithMaxRequestBodySize&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;20&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 最大请求体 4MB&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 日志中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 配置 Logrus 作为日志器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    logger &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; logrus.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewLogger&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    hlog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetLogger&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(logger)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 恢复中间件（防止 panic 导致服务崩溃）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Use&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(recovery.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Recovery&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        recovery.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithRecoveryHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;app&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RequestContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;err&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;stack&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            hlog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CtxErrorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发生 Panic: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;堆栈: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err, stack)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;utils&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;                &quot;error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务器内部错误&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 自定义中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Use&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;requestTimeMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 公开路由（无需认证）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    public &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Group&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/api&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        public.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/ping&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, pingHandler)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        public.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/health&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;app&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RequestContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;200&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;OK&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 需要认证的路由组&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    api &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Group&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/api&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    api.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Use&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;authMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 应用认证中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 用户相关路由&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        userGroup &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; api.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Group&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/users&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            userGroup.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/:id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, getUserHandler)      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// GET /api/users/123&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            userGroup.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;POST&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, createUserHandler)       &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// POST /api/users&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            userGroup.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PUT&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/:id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, updateUserHandler)   &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// PUT /api/users/123&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            userGroup.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DELETE&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/:id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, deleteUserHandler) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// DELETE /api/users/123&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 产品相关路由&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        api.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/products&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, listProductsHandler)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        api.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/products/:id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, getProductHandler)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 静态文件服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Static&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/static&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;./static&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 404 处理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NoRoute&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;app&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RequestContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;404&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;utils&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;请求的资源不存在&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;path&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx.Request.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;URI&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Path&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 优雅关闭处理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    h.OnShutdown &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(h.OnShutdown, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        hlog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务正在优雅关闭...&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 等待请求处理完成&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        hlog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务已关闭&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    hlog.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Hertz 服务器启动，监听端口: 8080&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;其他差异&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 获取 Form 表单数据（multipart/form-data）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;formValue &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FormValue&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;field&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;formFile, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FormFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;file&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-handler示例-1&quot;&gt;handler示例&lt;/h3&gt;&lt;p&gt;区别在于&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;参数由&lt;code&gt;c *gin.context&lt;/code&gt;变为&lt;code&gt;c context.Context,ctx *app.RequestContext&lt;/code&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;绑定请求结构体方法由&lt;code&gt;ShouldBindJSON&lt;/code&gt;变为&lt;code&gt;Bind&lt;/code&gt;或&lt;code&gt;BindAndValidate&lt;/code&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;gin.H&lt;/code&gt;由内部结构&lt;code&gt;utils.H&lt;/code&gt;替换&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Handler 示例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; updateUserHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;app&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RequestContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;userID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Param&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; req &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Name  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;name&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Email &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;email&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BindAndValidate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;req); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;utils&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;invalid request&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 获取中间件设置的用户信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    authUserID, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Get&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;200&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;utils&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:        userID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:      req.Name,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;email&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:     req.Email,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;updated_by&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: authUserID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;updated&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-中间件示例-1&quot;&gt;中间件示例&lt;/h3&gt;&lt;p&gt;除了参数差异&lt;code&gt;c *gin.context&lt;/code&gt;变为&lt;code&gt;c context.Context,ctx *app.RequestContext&lt;/code&gt;，其他完全与gin相同&lt;/p&gt;
&lt;p&gt;以jwt中间件为例&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; JWTMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;config&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; JWTConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;app&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HandlerFunc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;app&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RequestContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 从请求头获取token&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		authHeader &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetHeader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Authorization&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; authHeader &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(consts.StatusUnauthorized, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;utils&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;                &quot;code&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;401&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;                &quot;message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Authorization header is required&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Abort&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 检查Bearer格式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        const&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; bearerPrefix&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;Bearer &quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(authHeader) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(bearerPrefix) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; authHeader[:&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(bearerPrefix)] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bearerPrefix {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(consts.StatusUnauthorized, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;utils&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;                &quot;code&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;401&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;                &quot;message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Authorization header format must be &apos;Bearer {token}&apos;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Abort&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 提取token&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        tokenString &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; authHeader[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(bearerPrefix):]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 解析和验证token&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        claims, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ParseToken&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tokenString, config)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(consts.StatusUnauthorized, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;utils&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;                &quot;code&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;401&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;                &quot;message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Invalid or expired token&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;                &quot;error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:   err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Abort&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 将用户信息存储到上下文&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Set&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, claims.UserID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Set&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, claims.Username)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Set&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;roles&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, claims.Roles)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Set&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;jwt_claims&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, claims)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 继续处理请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-总结-1&quot;&gt;总结&lt;/h2&gt;&lt;p&gt;hertz框架总体来说与gin较类似，基础学习较为简单，这篇文章仅做基础框架讲解，关于hertz更复杂的方法今后再详细学习，接下来先步入微服务的学习&lt;/p&gt;

&lt;h2 id=&quot;article-学习文章-1&quot;&gt;学习文章&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.cloudwego.io/zh/docs/hertz/&quot;&gt;CloudWeGo | Hertz&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-hertz/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>分布式基础：微服务理论（gRPC）和kitex框架</title><link>https://www.claran-blog.work/posts/go-kitex/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-kitex/</guid><description>对微服务理论基础的讲解和kitex框架的介绍与快速搭建.</description><pubDate>Mon, 02 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-微服务-1&quot;&gt;微服务&lt;/h2&gt;&lt;p&gt;边学边写的Demo：&lt;strong&gt;&lt;a href=&quot;https://github.com/Claran309/microservice-learning-demo&quot;&gt;LearningDemo&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-概念解析-1&quot;&gt;概念解析&lt;/h3&gt;&lt;p&gt;区别于单体架构，微服务是一种&lt;strong&gt;分布式架构&lt;/strong&gt;模式&lt;/p&gt;

&lt;h4 id=&quot;article-单体架构-1&quot;&gt;单体架构&lt;/h4&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/microservice1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;&lt;strong&gt;单体架构就是数据库，缓存等一系列组件都在一台机器上面开发，运行和部署的架构&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;单体应用的优点&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;开发效率高&lt;/strong&gt;：功能都在单个程序内部，便于软件设计和开发规划&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;容易部署成本低&lt;/strong&gt;：程序单一不存在分布式集群的复杂部署环境，降低了部署难度&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;容易测试&lt;/strong&gt;：没有各种复杂的服务调用关系，都是内部调用方便测试&lt;br /&gt;单体架构的缺点就是，在数据，缓存，文件等不断增多的情况下，一台服务器资源有限经受不了这种压力，于是就提出了一种分布式的解决方案&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-分布式设计-1&quot;&gt;分布式设计&lt;/h4&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/microservice2.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;这种设计&lt;strong&gt;将各个服务都部署到不同的机器上面进行运行&lt;/strong&gt;，这样各个服务之间不会进行资源的竞争，压力就小了很多&lt;/p&gt;
&lt;p&gt;但是在这种情况下面就会出现一个问题：由于机器部署了多台，每个服务都可能出现宕机的情况，于是提出了集群在保障了基本的高可用&lt;/p&gt;

&lt;h4 id=&quot;article-集群-1&quot;&gt;集群&lt;/h4&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/microservice3.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;我们可以&lt;strong&gt;部署多台不同的机器跑相同的服务&lt;/strong&gt;，再通过合理的负载均衡策略，将请求分散到不同的服务器上面，这样的话就保障了一定的高可用，比如我们有两台机器，如果即使其中的一台机器挂掉，另一台机器也可以承担整个请求的任务&lt;/p&gt;
&lt;p&gt;但是当前的集群也会有一个新的问题：比如这里的服务ABC，每个服务的请求量和业务复杂度都是不同的，那么就会出现有一些服务的请求和复杂度特别高，那么我们就会对一些服务进行拆分更微小的服务，降低耦合度，这样就形成了我们的微服务&lt;/p&gt;

&lt;h4 id=&quot;article-微服务架构-1&quot;&gt;微服务架构&lt;/h4&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/microservice4.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;从单体整个应用程序开始进行拆分，&lt;strong&gt;拆分为多个服务&lt;/strong&gt;，并根据每个服务各自的特点&lt;strong&gt;拆分成更微小的服务&lt;/strong&gt;，最终就成就了我们的微服务。在微服务前有一个网关，通过负载均衡和nginx反向代理进入我们的网关，通过网关会找到我们相关的服务&lt;/p&gt;
&lt;p&gt;但是微服务这种设计结构在&lt;strong&gt;提升系统高可用性，强可拓展性和易维护性的同时，也会大大增加整个项目的复杂度和设计难度&lt;/strong&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-在项目中理解微服务-1&quot;&gt;在项目中理解微服务&lt;/h4&gt;&lt;p&gt;经过上面的了解，我们可以知道在一个微服务项目中，是应该有网关和多个微服务模块存在的，除此之外，还有&lt;br /&gt;两个重要的工具，也是实现微服务的核心技术：&lt;strong&gt;rpc客户端&lt;/strong&gt;（&lt;strong&gt;Client&lt;/strong&gt;）和&lt;strong&gt;rpc服务端&lt;/strong&gt;（&lt;strong&gt;Server&lt;/strong&gt;）&lt;/p&gt;
&lt;p&gt;rpc客户端Client负责接受api网关的rpc请求并将其序列化，发送给rpc服务端Server，而rpc服务端Server就根据具体业务逻辑执行相应代码再将相应返回给Client&lt;/p&gt;
&lt;p&gt;所以说，微服务与微服务之间是Client-Server的关系，理解这一点很重要，这意味着微服务之间可以相互调用，并且应当避免耦合&lt;/p&gt;

&lt;h4 id=&quot;article-微服务的拆分-1&quot;&gt;微服务的拆分&lt;/h4&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/microservice5.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;在服务拆分的时候，难带是拆分得越细越好吗？&lt;/p&gt;
&lt;p&gt;当一个项目拆分的时候，&lt;strong&gt;拆分的服务越多，从理论上来说它的可维护性也就越好&lt;/strong&gt;，与此同时拆分得越细，需要得团队人数就越多，&lt;strong&gt;项目得复杂度也就越高，设计难度也会大的多&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;常见的拆分逻辑&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;系统维度拆分&lt;/strong&gt;：根据系统一类功能聚集在一起的模块进行拆分，系统维度是最基本的拆分单位。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;功能维度拆分&lt;/strong&gt;：针对一些复杂度较高或重要的功能进行拆分。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;读写维度拆分&lt;/strong&gt;：针对数据操作存在较大读写差的功能或模块进行拆分&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-微服务的实现-1&quot;&gt;微服务的实现&lt;/h3&gt;&lt;p&gt;一个请求访问微服务的流程如下&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;http客户端&lt;/strong&gt;发送请求，服务器&lt;strong&gt;api网关&lt;/strong&gt;（hertz/gin）解析http请求，&lt;strong&gt;构造rpc请求&lt;/strong&gt;发送给&lt;strong&gt;内部rpc客户端&lt;/strong&gt;（手脚架生成），&lt;strong&gt;rpc客户端通&lt;/strong&gt;过网络传输（序列化）调用&lt;strong&gt;rpc服务端&lt;/strong&gt;（手脚架生成）（反序列化），&lt;strong&gt;rpc服务端&lt;/strong&gt;进入&lt;strong&gt;内部业务代码&lt;/strong&gt;处理业务逻辑，再&lt;strong&gt;原路返回&lt;/strong&gt;响应&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;HTTP客户端 (curl/浏览器)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ POST /register&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;API网关 (Hertz)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ 解析HTTP请求，调用RPC&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;RPC客户端 (Kitex生成)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ 序列化请求，发送到8888端口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;网络传输&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;RPC服务端 (Kitex生成，在8888端口监听)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ 接收请求，反序列化&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;你的业务代码 (handler.go)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ 处理注册逻辑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;返回响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;RPC服务端 → 序列化响应 → 网络 → RPC客户端 → API网关 → HTTP响应&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;接下来，我们将对各个概念和更加详细的技术进行解释&lt;/p&gt;

&lt;h4 id=&quot;article-rpc-1&quot;&gt;rpc&lt;/h4&gt;&lt;p&gt;rpc是什么？&lt;/p&gt;
&lt;p&gt;定义：是一种用于不同计算机之间通信的&lt;strong&gt;协议&lt;/strong&gt;。它&lt;strong&gt;允许一个计算机程序调用另一个计算机上的函数或者方法&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;在单体架构中，我们只需要得到这个服务对象就可以调用其方法，但是在服务拆分之后变成了两台机器，就不能这样调用了，那应该怎么办呢？&lt;/p&gt;
&lt;p&gt;我们知道，微服务设计就是将不同的服务设计在不同的服务器上单独运行，此时服务间的信息传递和调用就变得更加困难，此时就需要用到rpc通信机制，通过在当前服务上调用其他服务器注册的网关，实现像单体架构一样直接调用其方法&lt;/p&gt;
&lt;p&gt;所以rpc的存在就是把远程的服务调用变得跟本地类似&lt;/p&gt;
&lt;p&gt;但是问题又来了，我们在通过rpc调用其他服务器的服务时，怎么定位需要调用的服务的呢？&lt;/p&gt;
&lt;p&gt;除了显式注册ip:port外，我们通常使用&lt;strong&gt;注册中心&lt;/strong&gt;来解决这个问题，也涉及到了服务注册和服务发现&lt;/p&gt;

&lt;h4 id=&quot;article-注册中心-1&quot;&gt;注册中心&lt;/h4&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/microservice6.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;注册中心（register）就是服务信息的存储器，&lt;strong&gt;存储记录了每个注册微服务网络地址等信息&lt;/strong&gt;（微服务的ServiceName、IP、Port、MetaData等），常用的注册中心如etcd，concul&lt;/p&gt;

&lt;h5 id=&quot;article-服务注册-1&quot;&gt;服务注册&lt;/h5&gt;&lt;p&gt;每个微服务在启动时，将自己的网络地址等信息注册到注册中心，由注册中心存储这些数据&lt;/p&gt;

&lt;h5 id=&quot;article-定时续期-1&quot;&gt;定时续期&lt;/h5&gt;&lt;p&gt;定时续期（keep alive），定期告诉 Service Registry 自己还在，能够继续服务&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;健康检查&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;主动探测：注册中心定期调用服务的健康检查接口。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;心跳机制：服务定期发送心跳包，超时未收到则标记实例为不健康&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/blockquote&gt;
&lt;p&gt;如etcd，使用租约健康机制，主程序要定时keep alive确保注册中心存活，若注册中心失活就再次进行服务注册&lt;/p&gt;
&lt;p&gt;服务消费者从注册中心查询服务提供者的地址，并通过该地址调用服务提供者的接口&lt;/p&gt;

&lt;h5 id=&quot;article-服务发现-1&quot;&gt;服务发现&lt;/h5&gt;&lt;p&gt;服务发现的方式一般有两种：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;拉取的方式：服务消费方（Consumer）主动向注册中心发起服务查询的请求。&lt;/li&gt;
&lt;li&gt;推送的方式：服务订阅/通知变更（下发）：服务消费方（Consumer）主动向注册中心订阅某个服务，当注册中心中该服务信息发生变更时，注册中心主动通知消费者&lt;/li&gt;
&lt;/ol&gt;

&lt;h4 id=&quot;article-服务治理-1&quot;&gt;服务治理&lt;/h4&gt;&lt;p&gt;服务治理，在基础的微服务项目上确保&lt;strong&gt;微服务系统的稳定性、可靠性和可观测性&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;常见的服务治理包括&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;负载均衡&lt;/li&gt;
&lt;li&gt;熔断与降级&lt;/li&gt;
&lt;li&gt;限流：计数器，滑动窗口，漏桐，令牌桶&lt;/li&gt;
&lt;li&gt;重试与超时&lt;/li&gt;
&lt;li&gt;redis集群&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-消息队列-1&quot;&gt;消息队列&lt;/h4&gt;&lt;p&gt;上面所说的rpc通信方式属于同步通信，而此处的消息队列便是&lt;strong&gt;异步通信&lt;/strong&gt;，可用于解耦服务依赖&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;应用场景&lt;/strong&gt;：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;异步处理&lt;/li&gt;
&lt;li&gt;应用解耦&lt;/li&gt;
&lt;li&gt;流量削峰&lt;/li&gt;
&lt;li&gt;最终一致性&lt;br /&gt;&lt;strong&gt;主流消息队列&lt;/strong&gt;：&lt;br /&gt;&lt;strong&gt;Kafka&lt;/strong&gt;：高吞吐，适合日志、流处理&lt;br /&gt;&lt;strong&gt;RabbitMQ&lt;/strong&gt;：功能丰富，适合复杂路由&lt;br /&gt;&lt;strong&gt;RocketMQ&lt;/strong&gt;：阿里出品，事务消息强&lt;br /&gt;&lt;strong&gt;nsq&lt;/strong&gt;：go原生实现&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-分布式事务-1&quot;&gt;分布式事务&lt;/h4&gt;&lt;p&gt;在微服务中，可能存在多个服务争夺跨服务数据的情况，因此在微服务架构中，保证跨服务的数据一致性是巨大挑战，此时就要用到分布式事务来确保事务一致性&lt;/p&gt;
&lt;p&gt;dtm: &lt;a href=&quot;https://github.com/dtm-labs/dtm&quot;&gt;GitHub - dtm-labs/dtm: A distributed transaction framework, supports workflow, saga, tcc, xa, 2-phas&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-可观测性-1&quot;&gt;可观测性&lt;/h4&gt;&lt;p&gt;在单体式架构中，我们常用日志进行项目观察，但是对于微服务而言，给每个微服务分配日志再查询是不现实也不方便的，此时我们就需要用到可观测性三巨头：指标（Metrics）、链路追踪（Tracing）、分布式日志（Logging）&lt;/p&gt;

&lt;h5 id=&quot;article-指标-metrics-1&quot;&gt;指标（Metrics）&lt;/h5&gt;&lt;p&gt;四个黄金指标&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;延迟&lt;/strong&gt;（Latency）：请求处理时间&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;流量&lt;/strong&gt;（Traffic）：请求量/QPS&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;错误&lt;/strong&gt;（Errors）：错误率&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;饱和度&lt;/strong&gt;（Saturation）：资源使用率&lt;/li&gt;
&lt;/ol&gt;

&lt;h5 id=&quot;article-链路追踪-tracing-1&quot;&gt;链路追踪（Tracing）&lt;/h5&gt;&lt;p&gt;分布式请求跟踪，分析请求在系统中的完整路径。&lt;/p&gt;
&lt;p&gt;OpenTelemetry标准：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Trace&lt;/strong&gt;：一次请求的完整路径&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Span&lt;/strong&gt;：单个服务内的操作单元&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Context&lt;/strong&gt;：传递跟踪信息&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-分布式日志-logging-1&quot;&gt;分布式日志（Logging）&lt;/h5&gt;&lt;p&gt;集中收集、存储和查询分布式系统的日志。&lt;/p&gt;
&lt;p&gt;ELK Stack：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Elasticsearch&lt;/strong&gt;：存储和检索&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Logstash&lt;/strong&gt;：收集和解析&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Kibana&lt;/strong&gt;：可视化&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;article-微服务框架-1&quot;&gt;微服务框架&lt;/h2&gt;&lt;p&gt;接下来，我们进行微服务的基础代码实现&lt;/p&gt;
&lt;p&gt;常用两个微服务框架：&lt;strong&gt;go-zero和kitex&lt;/strong&gt;，此处详细介绍&lt;strong&gt;kitex&lt;/strong&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-go-zero-1&quot;&gt;go-zero&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;go-zero&lt;/strong&gt;是万俊峰开发的Go微服务框架，集成了各种工程实践&lt;/p&gt;
&lt;p&gt;核心特性：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;内置代码生成工具&lt;/li&gt;
&lt;li&gt;内置服务治理&lt;/li&gt;
&lt;li&gt;声明式API开发&lt;/li&gt;
&lt;li&gt;高性能RPC框架&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;架构组件：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;REST/RPC服务框架&lt;/li&gt;
&lt;li&gt;API网关&lt;/li&gt;
&lt;li&gt;配置中心&lt;/li&gt;
&lt;li&gt;任务调度&lt;/li&gt;
&lt;li&gt;缓存管理&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-kitex-1&quot;&gt;kitex&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;Kitex&lt;/strong&gt;是字节跳动开源的Go微服务RPC框架，已在字节内部大规模使用&lt;/p&gt;
&lt;p&gt;核心优势：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;极致性能：基于Netpoll网络库，性能领先&lt;/li&gt;
&lt;li&gt;扩展性强：支持多协议、可扩展传输层&lt;/li&gt;
&lt;li&gt;服务治理：内置服务发现、负载均衡、熔断等&lt;/li&gt;
&lt;li&gt;代码生成：强大IDL代码生成能力&lt;/li&gt;
&lt;li&gt;云原生：原生支持K8s、服务网格&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;article-用kitex快速搭建基础微服务demo-1&quot;&gt;用kitex快速搭建基础微服务demo&lt;/h2&gt;&lt;p&gt;kitex支持从IDL文件&lt;strong&gt;自动生成rpc客户端/服务端&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;一下以最基础的demo为例，实现支持用户注册功能的微服务demo&lt;/p&gt;

&lt;h3 id=&quot;article-安装依赖和必要工具-1&quot;&gt;安装依赖和必要工具&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 安装Kitex代码生成工具&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; github.com/cloudwego/kitex/tool/cmd/kitex@latest&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 安装Thriftgo（用于Thrift IDL）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; install&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; github.com/cloudwego/thriftgo@latest&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 验证安装&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kitex&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; --version&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;thriftgo&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; --version&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-项目目录和结构-1&quot;&gt;项目目录和结构&lt;/h3&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;kitexDemo/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── api-gateway/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── main.go      # 主入口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── router.go    # 路由定义&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── http.go      # HTTP处理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── user-service/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── main.go      # RPC服务入口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── handler.go   # 业务逻辑&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;└── idl/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── kitex_gen/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── user/        # 生成代码，以下略&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;└── user.thrift  # 接口定义&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-编写idl文件-1&quot;&gt;编写IDL文件&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;IDL&lt;/strong&gt;（&lt;strong&gt;接口定义语言&lt;/strong&gt;）定义了服务接口和数据结构，是&lt;strong&gt;RPC通信的契约&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;thrift&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;//idl/user.thrift&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;namespace go user&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;//用户注册请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;struct RegisterReq {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    1: string username&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    2: string password&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;//用户注册响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;struct RegisterResp {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    1: bool success&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;    2: string message&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;//用户服务接口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;service UserService {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;RegisterResp Register(1: RegisterReq req)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-代码生成-1&quot;&gt;代码生成&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 初始化Go模块&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; mod&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; init&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 生成Kitex代码&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;kitex&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -module&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; project_name&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; idl/user.thrift&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;kitex框架会自动根据thrift文件生成rpc代码&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;再分别进入各自的目录中，执行如下命令生成代码：&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;（可选）&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// item 目录下执行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;kitex &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;module project_name &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;service service_name &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;use ..&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;kitex_gen ..&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;idl&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;user.thrift&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这样kitex就会在我们的服务模块中生成main和hanlder代码框架以及启动脚本和kitex配置&lt;/p&gt;

&lt;h3 id=&quot;article-编写rpc业务逻辑代码-1&quot;&gt;编写rpc业务逻辑代码&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//user-service/handler.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;microservicesDemo/L2-kitex/kitex_gen/user&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// UserServiceImpl 实现Kitex生成的接口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterReq&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterResp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; req.Username &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; req.Password &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterResp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Success: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Message: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户名、密码、邮箱不能为空&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(req.Username) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterResp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Success: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Message: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户名至少3个字符&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterResp&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Success: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Message: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;注册成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-编写rpc服务启动代码-1&quot;&gt;编写rpc服务启动代码&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//user-service/main.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;microservicesDemo/L2-kitex/kitex_gen/user/userservice&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/server&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	addr, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; net.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ResolveTCPAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;tcp&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:8080&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		panic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	svr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userservice.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewServer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		new&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserServiceImpl&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),         &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 业务处理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithServiceAddr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(addr), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 监听端口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//启动rpc服务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; svr.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Run&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		panic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-编写api网关代码-1&quot;&gt;编写api网关代码&lt;/h3&gt;&lt;p&gt;编写api代码&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//api-gateway/main.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;microservicesDemo/L2-kitex/kitex_gen/user/userservice&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/hertz/pkg/app/server&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // Hertz服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/kitex/client&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;         // Kitex客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 全局RPC客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userClient &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;userservice&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// init函数，在main之前执行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; init&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;初始化rpc客户端...&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建kitex客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	userClient, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userservice.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user-service&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithHostPorts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1:8080&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建客户端失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;RPC客户端初始化成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;连接到: 127.0.0.1:8888&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WithHostPorts&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:8888&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	handler &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; APIHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	RegisterRoutes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(h, handler)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;网关服务器正在端口 8888 上启动&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Spin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//api-gateway/router&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/hertz/pkg/app/server&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; RegisterRoutes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;srv&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Hertz&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;handler&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; APIHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; srv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Group&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/user&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	user.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;POST&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/register&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, handler.Register)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//api-gateway/http.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;microservicesDemo/L2-kitex/kitex_gen/user&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/hertz/pkg/app&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/cloudwego/hertz/pkg/common/utils&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; APIHandler&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewAPIHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;APIHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;APIHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;APIHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;app&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RequestContext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 常规handler&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	startTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; req &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Username &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;username&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Password &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;password&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BindAndValidate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;req); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;绑定参数时发生错误&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;utils&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;code&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;msg&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;绑定参数时发生错误&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 构造rpc请求，包名为构建时填写的包名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	rpcReq &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RegisterReq&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Username: req.Username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Password: req.Password,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 调用rpc请求&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;调用rpc服务...&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	rpcResp, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Register&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, rpcReq)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;RPC调用失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;utils&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;code&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务内部错误: &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 判断rpc服务成功与否&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	statusCode &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 200&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;rpcResp.Success {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		statusCode &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 400&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	duration &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Since&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(startTime)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 返回HTTP响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;注册处理完成，状态码: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;，耗时: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, statusCode, duration)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(statusCode, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;utils&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;code&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    statusCode,      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// HTTP状态码&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;success&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: rpcResp.Success, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 业务是否成功&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: rpcResp.Message, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 业务消息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-学习文章-1&quot;&gt;学习文章&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://github.com/LanshanTeam/Courseware-Backend-Go-2024/blob/main/lesson14/%E5%BE%AE%E6%9C%8D%E5%8A%A1%E5%9F%BA%E7%A1%80%E7%90%86%E8%AE%BA.md&quot;&gt;蓝山Go组-2024 | 微服务理论基础&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.cloudwego.io/zh/docs/kitex/&quot;&gt;CloudWeGo | Kitex&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-kitex/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>微服务</category><category>分布式</category></item><item><title>网盘后端项目的相关功能思路&amp;实现</title><link>https://www.claran-blog.work/posts/claran-cloud-disk/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/claran-cloud-disk/</guid><description>针对ClaranCloudDisk项目的回顾.</description><pubDate>Sat, 21 Feb 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-网盘业务-1&quot;&gt;网盘业务&lt;/h2&gt;&lt;p&gt;不久前写了一个网盘后端项目，花了两个月时间（我是f5😭😭😭），故写篇博客总结一下用到的新鲜（对我而言）的技术&lt;/p&gt;
&lt;p&gt;我得项目分为四个模块：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;用户管理模块&lt;/li&gt;
&lt;li&gt;文件管理模块&lt;/li&gt;
&lt;li&gt;分享模块&lt;/li&gt;
&lt;li&gt;后台管理模块&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;详见：&lt;strong&gt;&lt;a href=&quot;https://github.com/Claran309/ClaranCloudDisk&quot;&gt;ClaranCloudDisk&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-服务器保存文件-1&quot;&gt;服务器保存文件&lt;/h3&gt;&lt;p&gt;网盘就离不开服务器保存文件这一块，个人写了两种保存方法：本地磁盘直接保存和MinIO存储（T神的点拨，T-God Orz），实际上应该还有OSS云存储这一块，但是因为是托管式云存储所以要收费&lt;/p&gt;
&lt;p&gt;有一些简单但是很方便的技术比如：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;秒传文件：直接检测文件哈希值查找是否含有相同文件，如果有的话就直接创建文件记录（引用一下找到的文件）就行&lt;/li&gt;
&lt;li&gt;限定用户资源：在表中新增些值，&lt;code&gt;Storage&lt;/code&gt;或者&lt;code&gt;IsVIP&lt;/code&gt;啥的，再在服务层进行相应检测即可&lt;/li&gt;
&lt;li&gt;文件收藏：&lt;code&gt;file&lt;/code&gt;表新增&lt;code&gt;IsStarred&lt;/code&gt;再新增相应路由和服务即可&lt;/li&gt;
&lt;li&gt;回收站：同上，&lt;code&gt;IsDeleted&lt;/code&gt;即可&lt;/li&gt;
&lt;li&gt;文件搜索：&lt;code&gt;Gorm&amp;amp;SQL&lt;/code&gt;里的&lt;code&gt;LIKE&lt;/code&gt;关键字&lt;/li&gt;
&lt;li&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-本地磁盘直接保存-1&quot;&gt;本地磁盘直接保存&lt;/h4&gt;&lt;p&gt;这一块比较简单，用的直接就是Os包，io包，bufio之类的，在捕获到上传文件后，简单鉴权验证之类的后创建用户文件夹，生成fileHash和唯一标识符，再用标识符作文件名确保保存文件这块不会有问题，&lt;br /&gt;之后就是创建文件夹、Copy文件内容就行，总的来说还是比较简单&lt;/p&gt;
&lt;p&gt;具体的部分代码如下：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Upload&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;userID&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; multipart&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;fileHeader&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;multipart&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileHeader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	isVIP, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.UserRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetVIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取用户信息失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 验证单个文件大小&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fileHeader.Size &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.MaxFileSize {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;单个文件大小不能超过 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%.2f&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;GB&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;float64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.MaxFileSize)&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1024&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1024&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1024&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 验证用户是否拥有足够存储空间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	userStorage, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.UserRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetStorage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取用户信息失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;isVIP &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fileHeader.Size&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;userStorage &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.NormalUserMaxStorage {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;非VIP用户总存储空间已超额！&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 计算Hash&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	hash, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileHash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;计算文件哈希失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 检测秒传&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	existingFile, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByHash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, hash)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; existingFile &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 检测用户是否有此文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		userFiles, _, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByUserID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, existingFile.UserID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, userFile &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userFiles {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userFile.Filename &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fileHeader.Filename {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;您已拥有该文件&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 创建文件记录（秒传）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Ext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileHeader.Filename)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		newFile &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			UserID:   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Name:     fileHeader.Filename,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Filename: existingFile.Filename,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Path:     existingFile.Path,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Size:     fileHeader.Size,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Hash:     hash,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			MimeType: fileHeader.Header.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Get&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Content-Type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Ext:      ext,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//数据层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Create&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, newFile); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;秒传失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//更新用户存储空间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UpdateUserStorage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID), fileHeader.Size)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; newFile, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 生成filename&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fileName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CreateName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileHeader.Filename, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	filePath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.uploadDir, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID)), fileName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 保存文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Save&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(file, filePath); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;保存文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建文件记录&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Ext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileHeader.Filename)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	newFile &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		UserID:   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Name:     fileHeader.Filename,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Filename: fileName,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Path:     filePath,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Size:     fileHeader.Size,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Hash:     hash,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MimeType: fileHeader.Header.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Get&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Content-Type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Ext:      ext,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Create&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, newFile); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 回滚&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Remove&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filePath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建文件记录失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//更新用户存储空间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UpdateUserStorage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID), fileHeader.Size)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; newFile, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Save&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; multipart&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;filePath&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//创建目录&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	dir &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Dir&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filePath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//0755 : 0-无特殊权限  7-rwx  5-rx  5-rx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MkdirAll&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(dir, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0755&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//创建文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	dst, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Create&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filePath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dst.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//复制文件内容&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	_, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; io.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Copy&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(dst, file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;要注意的问题就是filepath.join后文件路径可能会出问题，比如多一个反斜杠之类的：&lt;code&gt;user_1//Hsu7Husd98s//file_1.jpg&lt;/code&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-集成minio-1&quot;&gt;集成minIO&lt;/h4&gt;&lt;p&gt;这一块是在我写完本地磁盘直接保存后直接集成到，只需要修改保存部分的代码即可，具体技术见连接文章&lt;/p&gt;
&lt;p&gt;详见：&lt;strong&gt;&lt;a href=&quot;https://www.claran-blog.work/go-minio/&quot;&gt;MinIO&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;但是依旧还是踩了坑，比如桶名&lt;code&gt;bucket_name&lt;/code&gt;和键名&lt;code&gt;object_name&lt;/code&gt;命名规范之类的，当时还找了好久的错误www&lt;/p&gt;

&lt;h3 id=&quot;article-邮箱验证码-email包-1&quot;&gt;邮箱验证码 - email包&lt;/h3&gt;&lt;p&gt;这一块比较简单，跟着网上的教学文章学就行，总结了一些知识点 ↓&lt;/p&gt;
&lt;p&gt;详见：&lt;strong&gt;&lt;a href=&quot;https://www.claran-blog.work/go-email/&quot;&gt;email包&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;不过我自己写的时候发现连接池出了问题，但是因为项目已经收尾所以就没怎么改，直接把连接池删了（&lt;/p&gt;

&lt;h3 id=&quot;article-敏感内容检测-flashtext-1&quot;&gt;敏感内容检测 - flashtext&lt;/h3&gt;&lt;p&gt;这一块有点难绷，因为想做敏感内容检测就学了一下flashtext，也很简单，但是这个库在我的项目里基本只能识别文件名或文本文件之类的，感觉比较鸡肋就没加上去，&lt;br /&gt;进阶的对文件内容，比如检测视频或图像是否含有敏感内容之类的到时有其他库，不过是因为要花钱还是啥的就没弄。&lt;/p&gt;
&lt;p&gt;但是现在回想起来发现其实说不定也能调用AI来对文件进行检测，不过感觉有点奢侈了（）&lt;/p&gt;

&lt;h3 id=&quot;article-下载限流-ticker-1&quot;&gt;下载限流 - ticker&lt;/h3&gt;&lt;p&gt;限流这一块主要就是通过设定limitedSpeed和Ticker，让数据在每Ticker流过限制的量，具体实现如下代码：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//限速&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	bufferSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;64&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1024&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 64KB缓冲区&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; limitedSpeed &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bufferSize {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		bufferSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; limitedSpeed&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	buf &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, bufferSize)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ticker &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewTicker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ticker.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Stop&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ticker.C:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 每秒最多读取limitedSpeed字节&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			bytesRead &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bytesRead &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; limitedSpeed {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				remaining &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; limitedSpeed &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bytesRead&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				readSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; remaining&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; readSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bufferSize {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					readSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bufferSize&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 读取文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				n, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; stream.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Read&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(buf[:readSize])&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; n &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;					// 写入HTTP响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					_, writeErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.Writer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Write&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(buf[:n])&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; writeErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;						return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					c.Writer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Flush&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 立即发送给客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					bytesRead &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(n) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 累计已读取字节&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; io.EOF {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;						zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;下载请求结束&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;							zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.RequestURI),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;							zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.Method),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;							zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;client_ip&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ClientIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;						return&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 文件读取完成&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ctx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Done&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;():&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;下载请求超时&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.RequestURI),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.Method),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;client_ip&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ClientIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 上下文取消&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-分片上传-1&quot;&gt;分片上传&lt;/h3&gt;&lt;p&gt;在做分片上传的前期我是一头雾水，主要还是因为分片上传实际上是前后端协作的一个功能，前端将文件切成一定数量的分片，再将分片依次传给后端，同时每次传输给后端几个参数：&lt;br /&gt;chunk_index,chunk_total,fileHash之类的，用来给后端标记当前上传的是哪个文件的第几号分片&lt;/p&gt;
&lt;p&gt;而后端在接受这些分片时，对于第一个分片要初始化分片上传服务，创建临时文件夹保存分片文件，之后依次接受并保存相应分片，当接受最后一个分片时，将临时文件夹内的所有分片文件&lt;br /&gt;进行合并，再将合并后的文件进行常规的保存和数据库记录操作&lt;/p&gt;
&lt;p&gt;详细代码如下：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ChunkUpload&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;上传分片请求开始&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.RequestURI),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.Method),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;client_ip&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ClientIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//捕获数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	userID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//获取分片文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	file, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FormFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunk&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;无分片文件: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;无分片文件&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//获取分片状态数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	chunkIndexStr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PostForm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunk_index&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Str&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	chunkTotalStr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PostForm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunk_total&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Str&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fileHash &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PostForm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;file_hash&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fileName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PostForm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;file_name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fileMimeType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PostForm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;file_mime_type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// mimetype&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkIndexStr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkTotalStr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fileHash &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fileName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;无分片元数据: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;请上传元数据&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//string -&amp;gt; int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	chunkIndex, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Atoi&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunkIndexStr)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;不正确的chunkIndex格式: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunkIndex应当是数字&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	chunkTotal, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Atoi&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunkTotalStr)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;不正确的chunkTotal格式: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunkTotal应当是数字&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkIndex &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkTotal &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;不正确的chunkIndex或chunkTotal: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunkIndex或chunkTotal错误&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fileReader, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; file.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Open&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;打开分片文件: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;打开分片文件失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fileReader.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	chunkData &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, file.Size)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	_, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fileReader.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Read&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunkData)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;读取分片文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;读取分片文件失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//服务层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//如果是第一个分片 -&amp;gt; 初始化分片上传&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkIndex &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.fileService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InitChunkUpload&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID, fileName, fileHash, chunkTotal) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始化上传，创建临时文件夹&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;初始化上传失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;初始化上传失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//保存分片文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.fileService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SaveChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileHash, userID, chunkIndex, chunkData)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;保存分片文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//如果是最后一个分片 -&amp;gt; 合并所有分片文件 &amp;amp; 返回上传成功响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkIndex &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunkTotal&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		file, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.fileService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MergeAllChunks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID, fileHash, fileName, fileMimeType)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;合并分片失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;合并分片失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;上传分片请求结束&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.RequestURI),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.Method),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;client_ip&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ClientIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Success&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:         file.ID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:       file.Name,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;size&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:       file.Size,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;mime_type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  file.MimeType,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;created_at&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: file.CreatedAt,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;文件上传成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;上传分片请求结束&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.RequestURI),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.Method),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;client_ip&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ClientIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//返回响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Success&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;chunk_index&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: chunkIndex,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;chunk_total&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: chunkTotal,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:      &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;uncompleted&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;分片上传成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InitChunkUpload&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;userID&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;fileName&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;fileHash&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;chunkTotal&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//检查文件是否已存在&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	_, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FindByHash&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), fileHash)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;文件已存在&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//初始化redis -&amp;gt; 开始记录当前分片上传状态&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InitChunkUploadSession&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileHash, chunkTotal)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;初始化缓存失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//创建临时分片文件夹&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tmpPath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;.&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, s.uploadDir, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID)), &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;tmp_uploads/&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fileHash) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ./user_:id/tmp_uploads/fileHash/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MkdirAll&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tmpPath, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0755&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//回滚&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CleanChunkUploadSession&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileHash)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建临时目录失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SaveChunk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;fileHash&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;userID&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;chunkIndex&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;chunkData&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//验证：判定redis数据是否过期 -&amp;gt; 结束会话&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CheckChunkUploadSession&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileHash)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;redis: nil&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;上传会话已过期，请重新上传&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;访问缓存失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//将分片保存在临时文件夹内&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tmpPath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.uploadDir, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID)), &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;tmp_uploads/&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fileHash) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ./user_:id/tmp_uploads/fileHash/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	chunkPath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;.&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;tmpPath, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunk_&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, chunkIndex))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunkPath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunkPath, chunkData, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0644&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;保存分片失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//更新redis信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UpdateChunkUploadSession&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileHash, chunkIndex)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Remove&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunkPath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;更新分片状态失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MergeAllChunks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;userID&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;fileHash&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;fileName&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;mimetype&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//在临时文件夹内合并所有分片&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//分片信息是否完整&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	finished, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsChunkUploadFinished&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileHash)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;检查上传状态失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;finished {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;已上传的分片不完整&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//获取分片列表&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	chunks, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetChunks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileHash)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取分片列表失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//排序&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	sort.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Ints&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunks)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//合并分片&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	filePath, fileSize, _, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MergeChunks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID, fileHash, fileName, chunks)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;合并分片失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//删除redis数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CleanChunkUploadSession&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileHash)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//将分片整合为file&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Ext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//zap.S().Info(filePath, ext, mimetype, fileName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	file &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		UserID:   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Name:     fileName,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Filename: s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CreateName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileName, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID)),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Path:     filePath,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Size:     fileSize,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Hash:     fileHash,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MimeType: mimetype,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Ext:      ext,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//将file信息存储在mysql中&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.FileRepo.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Create&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;上传文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//更新file&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//finalFile, _ := s.FileRepo.FindByHash(context.Background(), fileHash)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;file, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MergeChunks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;userID&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;fileHash&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;filename&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;chunks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fileName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CreateName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filename, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	filePath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.uploadDir, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID)), fileName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Ext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filePath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//创建目录&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	dir &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Dir&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filePath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//0755 : 0-无特殊权限  7-rwx  5-rx  5-rx&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MkdirAll&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(dir, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0755&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	finalFile, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Create&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filePath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建最终文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; finalFile.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//合并分片&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; totalSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tmpPath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;.&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, s.uploadDir, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID)), &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;tmp_uploads/&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fileHash) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ./user_:id/tmp_uploads/fileHash/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, chunkIndex &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunks {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//寻找当前chunk路径&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		chunkPath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tmpPath, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunk_&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, chunkIndex))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//打开当前chunk&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		chunkFile, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Open&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunkPath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;打开分片失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//将chunk内容合并到file&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		writer, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; io.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Copy&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(finalFile, chunkFile)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		chunkFile.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;合并分片失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		totalSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; writer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//删除当前临时chunk&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Remove&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunkPath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//合并后把file存入minIO&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//删除临时文件夹&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//获取字节数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	finalFileData, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; io.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadAll&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(finalFile)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;读取合并文件失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//保存到minIO&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Save&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), filePath, finalFileData, ext); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//删除本地文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//os.Remove(filePath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Remove&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tmpPath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filePath, totalSize, ext, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-断点传续-1&quot;&gt;断点传续&lt;/h3&gt;&lt;p&gt;断点传续的功能需要建立在分片上传之上，因为断点传续本质上是在分片传输时，前端用来获取分片上传服务状态的接口，这个接口可以为前端提供还差哪些分片的信息，让前端可以&lt;br /&gt;弥补性地上传剩余的分片或者接着上传上次没有传递完的切片，故名断点传续&lt;/p&gt;
&lt;p&gt;代码如下：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetChunkStatus&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取分片状态请求开始&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.RequestURI),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.Method),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;client_ip&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ClientIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//捕获数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fileHash &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PostForm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;file_hash&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fileHash &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;缺少filehash参数&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;缺少fileHash参数&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//服务层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	uploadedChunks, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.fileService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetUploadedChunks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fileHash)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取分片状态失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取分片状态请求结束&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.RequestURI),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.Method),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;client_ip&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ClientIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//成功响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Success&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;file_hash&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:       fileHash,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;uploaded_chunks&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: uploadedChunks,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;uploaded_count&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(uploadedChunks),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取上传状态成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//因为服务层是对数据层的直接调用，所以此处跳过服务层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;repo &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;mysqlFileRepo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetUploadedChunks&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;fileHash&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) ([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	chunkKey &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;chunkupload:chunk:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fileHash)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	chunksStr, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; repo.cache.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SMembers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunkKey)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunks []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, chunkStr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunksStr {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		chunk, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Atoi&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunkStr)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		chunks &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(chunks, chunk)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; chunks, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-文件预览-1&quot;&gt;文件预览&lt;/h3&gt;&lt;p&gt;文件预览可以说简单也可以说复杂，本质上是对请求预览的文件进行mime类型判断，再根据不同的mime类型执行不同的预览方法，比如是文本文件就直接返回内容，是不可预览的文件就&lt;br /&gt;返回不可预览的信息或者返回直接文件内容&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Preview&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;预览文件请求开始&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.RequestURI),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.Method),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;client_ip&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ClientIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//捕获数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	userID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fileID, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ParseInt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Param&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;无效的文件ID: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;无效的文件ID&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//服务层获取文件信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ctx &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.Request.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	file, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.fileService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetFileInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, userID, fileID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;文件不存在或无权限访问: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;404&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;文件不存在或无权访问: &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	exist, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exists&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, file.Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;检查文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;检查文件失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;exist {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;文件已丢失&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;404&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;文件已丢失&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//=============================================================================================================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//是否存在&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//if _, err := os.Stat(file.Path); os.IsNotExist(err) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//	util.Error(c, 404, &quot;文件已丢失&quot;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//	return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//=============================================================================================================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//服务层获取文件类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fileType, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.fileService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetMimeType&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取文件类型失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取文件类型失败: &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fileType {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;image&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PreImage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;video&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PreVideo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;audio&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PreAudio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;document&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PreDoc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;text&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PreText&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;other&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PreText&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, file) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// // 其他类型尝试作为文本预览&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;未解析的文件类型: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fileType)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;未解析的文件类型&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;预览文件请求结束&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.RequestURI),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.Method),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;client_ip&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ClientIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PreImage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//设置响应头&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; file.Ext&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;svg&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;svg+xml&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	MineType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;image/&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Content-Type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, MineType)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Cache-Control&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;public, max-age=31536000&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 缓存1年&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//从minIO获取文件流&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	stream, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetStream&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, file.Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;从minIO获取文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;从minIO获取文件失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; stream.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	io.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Copy&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c.Writer, stream)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PreVideo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//设置响应头&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; file.Ext&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;mov&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;quicktime&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;avi&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;x-msvideo&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;mkv&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;x-matroska&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	MineType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;video/&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Content-Type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, MineType)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Accept-Ranges&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;bytes&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//从minIO获取文件流&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	stream, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetStream&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c.Request.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), file.Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;从minIO获取文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;从minIO获取文件失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; stream.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	http.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServeContent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c.Writer, c.Request, file.Name, time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), stream.(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;io&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadSeeker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//神器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//http.ServeFile(c.Writer, c.Request, file.Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PreAudio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//设置响应头&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; file.Ext&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;mp3&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;mpeg&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	MineType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;audio/&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Content-Type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, MineType)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Accept-Ranges&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;bytes&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//从minIO获取文件流&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	stream, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetStream&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c.Request.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), file.Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;从minIO获取文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;从minIO获取文件失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; stream.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	http.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ServeContent&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c.Writer, c.Request, file.Name, time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), stream.(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;io&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadSeeker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//神器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//http.ServeFile(c.Writer, c.Request, file.Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PreDoc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; file.Ext&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;pdf&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// PDF文件可以直接预览&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Content-Type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;application/pdf&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Content-Disposition&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;inline; filename=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\&quot;%s\&quot;&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, file.Name))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;txt&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;md&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;js&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;css&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;html&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;json&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;xml&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;yaml&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;yml&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 文本类文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PreText&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 其他文档类型，返回下载&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Content-Type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;application/octet-stream&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Content-Disposition&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;attachment; filename=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\&quot;%s\&quot;&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, file.Name))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//从minIO获取文件流&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	stream, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetStream&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, file.Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;从minIO获取文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;从minIO获取文件失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; stream.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	io.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Copy&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c.Writer, stream)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PreText&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;file&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Content-Type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;text/plain; charset=utf-8&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Header&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Content-Disposition&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;inline; filename=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\&quot;%s\&quot;&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, file.Name))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//从minIO获取文件流&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	stream, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetStream&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, file.Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;从minIO获取文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;从minIO获取文件失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; stream.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	io.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Copy&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c.Writer, stream)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//=============================================================================================================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 打开文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//fileContent, err := os.Open(file.Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//if err != nil {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//	util.Error(c, 500, &quot;打开文件失败: &quot;+err.Error())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//	return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//defer fileContent.Close()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//// 发送文件内容&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//io.Copy(c.Writer, fileContent)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//=============================================================================================================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;需要注意的是，应该还需要有一个接口为前端返回预览信息：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FileHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetPreInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取文件预览信息请求开始&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.RequestURI),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.Method),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;client_ip&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ClientIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 捕获数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	userID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fileID, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ParseInt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Param&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;无效的文件ID: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;无效的文件ID&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 调用服务层获取文件信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ctx &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.Request.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	file, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.fileService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetFileInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, userID, fileID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;文件不存在或无权限访问: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;404&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;文件不存在或无权访问: &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//服务层获取文件类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fileType, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.fileService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetMimeType&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取文件类型失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取文件类型失败: &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fileType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;document&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fileType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;application&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//修改响应头&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; file.Ext&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;svg&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;svg+xml&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;mov&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;quicktime&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;avi&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;x-msvideo&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;mkv&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;x-matroska&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;mp3&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;mpeg&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;docx&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;vnd.openxmlformats-officedocument.wordprocessingml.document&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;doc&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;msword&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;xls&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;vnd.ms-excel&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;xlsx&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;vnd.openxmlformats-officedocument.spreadsheetml.sheet&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;ppt&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;vnd.ms-powerpoint&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;pptx&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;vnd.openxmlformats-officedocument.presentationml.presentation&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;txt&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;plain&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;js&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;javascript&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;md&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;markdown&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	MimeType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fileType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;/&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ext&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	canPreview &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fileType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;other&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		canPreview &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 返回预览信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	previewInfo &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:           file.ID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:         file.Name,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;size&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:         file.Size,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;mime_type&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    MimeType,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;category&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:     fileType,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;can_preview&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  canPreview,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;extension&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    file.Ext,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;preview_url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/api/files/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/preview&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, file.ID),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;content_url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/api/files/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/content&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, file.ID),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;download_url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/api/files/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/download&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, file.ID),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;created_at&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:   file.CreatedAt,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取文件预览信息请求结束&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.RequestURI),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;method&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.Method),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;client_ip&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ClientIP&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	util.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Success&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;file&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: previewInfo,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取预览信息成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-配置管理和日志管理-1&quot;&gt;配置管理和日志管理&lt;/h3&gt;&lt;p&gt;经典地使用Zap和Viper进行配置管理&lt;/p&gt;
&lt;p&gt;详见 &lt;strong&gt;&lt;a href=&quot;https://www.claran-blog.work/go-viper&amp;amp;zap/&quot;&gt;Zap&amp;amp;Viper&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;在使用viper前我还是自己写的配置管理包去访问.env，所以集成Viper很顺利就完成了，不过我为了展示viper的功能再加了一层yaml封装www&lt;/p&gt;

&lt;h3 id=&quot;article-安全相关-1&quot;&gt;安全相关&lt;/h3&gt;&lt;p&gt;这一块我只了解了一些最基础的安全问题，比如XSS，CSRF之类的&lt;/p&gt;
&lt;p&gt;在我的项目规划里有一定的说明：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;安全问题&lt;ul&gt;
&lt;li&gt;&lt;span&gt;☑ &lt;/span&gt; XSS：上传或预览文本文件时可能触发，但是本项目将文本文件的上传一律设置为了&lt;code&gt;text/plain&lt;/code&gt;，并且使用io.Copy流式传输，且启用了&lt;code&gt;&quot;X-XSS-Protection&quot;&lt;/code&gt;XSS过滤，基本没有XSS风险&lt;/li&gt;
&lt;li&gt;&lt;span&gt;☑ &lt;/span&gt; SQL注入：gorm内部会自动进行参数化处理，并且项目内基本使用了参数化查询，基本没有风险&lt;/li&gt;
&lt;li&gt;&lt;span&gt;☑ &lt;/span&gt; CSRF：正常来说应使用CSRF中间件并进行CSRF Token认证，但是本项目认证方式为通过请求头传递的jwt，不会被CSRF攻击&lt;/li&gt;
&lt;li&gt;&lt;span&gt;☑ &lt;/span&gt; 其他： 添加RateLimited中间件和Security中间件&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;article-总结-1&quot;&gt;总结&lt;/h2&gt;&lt;p&gt;写这个项目的缘由还是因为很久之前蓝山有个学长的仓库里有一个网盘项目，当时觉得很好奇就了解学习了一下，再加上后端考核有一个选择就是网盘，就写了网盘相关的项目ww&lt;/p&gt;
&lt;p&gt;学长的项目↓&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/LPAN.png&quot; alt=&quot;LPAN.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;这次写项目还是带给了我一定的经验的新知识，不过我花了两个月可能还是有点磨蹭了，之后再接再厉吧！&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/claran-cloud-disk/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>项目</category></item><item><title>email包:在Go项目中发送邮件</title><link>https://www.claran-blog.work/posts/go-email/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-email/</guid><description>Go中email包的使用.</description><pubDate>Fri, 20 Feb 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-引言-1&quot;&gt;引言&lt;/h2&gt;&lt;p&gt;有时候我们可能需要项目实现&lt;strong&gt;发送邮件&lt;/strong&gt;给指定用户之类的功能，这时候就需要用到&lt;strong&gt;email包&lt;/strong&gt;&lt;code&gt;github.com/jordan-wright/email&lt;/code&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-email包-1&quot;&gt;Email包&lt;/h2&gt;
&lt;h3 id=&quot;article-概述-1&quot;&gt;概述&lt;/h3&gt;&lt;p&gt;email包是一个专为&lt;strong&gt;电子邮件&lt;/strong&gt;设计的“高级工具箱”，让构建和发送邮件变得像调用API一样简单、直观。&lt;/p&gt;
&lt;p&gt;其核心目标是提供一套简洁、直观且功能完整的API，用于在Go程序中轻松创建和发送电子邮件，屏蔽了MIME格式的复杂性，让开发者能够专注于邮件内容本身&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;本质上，一封符合MIME标准的邮件是一个结构复杂的多部分文档，因此email包的价值在于，它将底层复杂的MIME构建逻辑完全封装，为开发者提供了一个清晰、类型安全的抽象层&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3 id=&quot;article-smtp-1&quot;&gt;SMTP&lt;/h3&gt;&lt;p&gt;电子邮件在网络中传输和网页一样需要遵从特定的协议，常用的电子邮件协议包括 &lt;strong&gt;SMTP，POP3，IMAP&lt;/strong&gt;&lt;br /&gt;其中邮件的创建和发送只需要用到 &lt;strong&gt;SMTP 协议&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;SMTP 是 &lt;strong&gt;Simple Mail Transfer Protocol&lt;/strong&gt; 的简称，即&lt;strong&gt;简单邮件传输协议&lt;/strong&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-快速学习-1&quot;&gt;快速学习&lt;/h3&gt;&lt;p&gt;安装依赖&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; get&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; github.com/jordan-wright/email&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-编写代码前的准备-1&quot;&gt;编写代码前的准备&lt;/h4&gt;&lt;p&gt;要实现项目发送邮件的功能，我们需要先准备一个&lt;strong&gt;充当服务器邮箱的邮箱地址&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;此博客中的邮箱地址以&lt;code&gt;example@gmail.com&lt;/code&gt;为例&lt;/p&gt;

&lt;h5 id=&quot;article-邮箱准备-1&quot;&gt;邮箱准备&lt;/h5&gt;&lt;ol&gt;
&lt;li&gt;开启&lt;strong&gt;两步验证&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;访问 &lt;a href=&quot;https://myaccount.google.com/security&quot;&gt;https://myaccount.google.com/security&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;找到&quot;两步验证&quot;，按提示开启（需要绑定手机号）&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;生成&lt;strong&gt;应用专用密码&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;访问 &lt;a href=&quot;https://myaccount.google.com/apppasswords&quot;&gt;https://myaccount.google.com/apppasswords&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;选择应用：邮件&lt;/p&gt;
&lt;p&gt;选择设备：其他（自定义名称），输入你的项目名称&lt;/p&gt;
&lt;p&gt;点击&quot;生成&quot;，复制16位密码&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;只显示一次，务必保存好！&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h5 id=&quot;article-配置准备-1&quot;&gt;配置准备&lt;/h5&gt;&lt;p&gt;通过email包实现的邮件发送需要以下配置：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EmailConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    SMTPHost:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;smtp.gmail.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// gmail邮箱服务器地址（由邮箱企业服务器提供）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    SMTPPort:  &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;587&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// gmail邮箱服务器端口（由邮箱服务器地址决定）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    SMTPUser:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;example@gmail.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 用作服务器的邮箱&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    SMTPPass:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;abcdefghijklmnop&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 刚刚生成的应用专用密码&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    FromName:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Claran云盘&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 邮件发送人署名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    FromEmail: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;example@gmail.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 邮件发送人邮箱&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-邮件对象化构建-1&quot;&gt;邮件对象化构建&lt;/h4&gt;&lt;p&gt;在email包的设计里，一封邮件就是一个&lt;strong&gt;Email结构体实例&lt;/strong&gt;。你需要关心的只是这个对象的属性：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    From:    &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发件人 &amp;lt;example@gmail.com&amp;gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    To:      []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;收件人1@example.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;收件人2@example.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Cc:      []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;抄送人@example.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Bcc:     []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;密送人@example.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Subject: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;您的账户验证码&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Text:    []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;您的验证码是 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,validationCode), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 纯文本正文&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    HTML:    []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;`&amp;lt;h1&amp;gt;欢迎！&amp;lt;/h1&amp;gt;&amp;lt;p&amp;gt;您的验证码是&amp;lt;strong&amp;gt;123456&amp;lt;/strong&amp;gt;&amp;lt;/p&amp;gt;`&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// HTML正文&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-嵌入式资源和附件-1&quot;&gt;嵌入式资源和附件&lt;/h4&gt;&lt;p&gt;email包最亮眼的功能之一：添加附件或内嵌图片（如HTML中的Logo）无需与底层的multipart/mixed或multipart/related纠缠&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;添加附件： 只需指定文件路径或io.Reader，并可选设置文件名&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;嵌入图片： 调用Attach或Embed后，你会得到一个唯一的Content-ID (CID)。在HTML中通过&lt;code&gt;&amp;lt;img src=&quot;cid:your-cid&quot;&amp;gt;&lt;/code&gt;引用即可，包会自动将图片作为邮件的一部分（而非附件）发送&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 添加一个PDF附件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;_, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AttachFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;report.pdf&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 嵌入一张图片作为HTML正文的一部分&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;cid, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Embed&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;logo.png&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;e.HTML &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;`&amp;lt;img src=&quot;cid:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot; alt=&quot;Logo&quot;/&amp;gt; &amp;lt;p&amp;gt;正文&amp;lt;/p&amp;gt;`&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, cid))&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-发送一封简单邮件-1&quot;&gt;发送一封简单邮件&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/jordan-wright/email&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; EmailConfig&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	SMTPHost  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // gmail邮箱服务器地址（由邮箱企业服务器提供）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	SMTPPort  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;     // gmail邮箱服务器端口（由邮箱服务器地址决定）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	SMTPUser  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;stgring&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 用作服务器的邮箱&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	SMTPPass  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 刚刚生成的应用专用密码&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	FromName  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 邮件发送人署名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	FromEmail &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 邮件发送人邮箱&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	emailConfig &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; EmailConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		SMTPHost:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;smtp.gmail.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,    &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// gmail邮箱服务器地址（由邮箱企业服务器提供）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		SMTPPort:  &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;587&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,                 &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// gmail邮箱服务器端口（由邮箱服务器地址决定）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		SMTPUser:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;example@gmail.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 用作服务器的邮箱&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		SMTPPass:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;abcdefghijklmnop&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 刚刚生成的应用专用密码&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		FromName:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Claran云盘&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,        &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 邮件发送人署名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		FromEmail: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;example@gmail.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 邮件发送人邮箱&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; email.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	e.From &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;系统通知 &amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&amp;gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,emailConfig.FromName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	e.To &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user@example.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;} &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 接收人邮件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	e.Subject &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;测试邮件&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 邮件主题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	e.Text &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;这是一封来自Go程序的测试邮件。&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 正文&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 或 e.HTML = []byte(&quot;&amp;lt;h1&amp;gt;HTML正文&amp;lt;/h1&amp;gt;&quot;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 使用SMTP发送&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Send&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(emailConfig.SMTPHost&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Itoa&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(emailConfig.SMTPPort), smtp.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PlainAuth&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, emailConfig.FromEmail, emailConfig.SMTPPass, emailConfig.SMTPHost))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送失败: &quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;邮件发送成功！&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-邮件抄送-1&quot;&gt;邮件抄送&lt;/h4&gt;&lt;p&gt;该插件有两种抄送模式即 &lt;code&gt;CC（Carbon Copy）&lt;/code&gt;和 &lt;code&gt;BCC （Blind Carbon Copy）&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;抄送功能只需要添加两个参数即可&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    e.Cc &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;XXX@qq.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,XXX@qq.com}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    e.Bcc &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;XXX@qq.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-带html代码的邮件-1&quot;&gt;带HTML代码的邮件&lt;/h4&gt;&lt;p&gt;使用&lt;code&gt;e.HTML = []byte(htmlContent)&lt;/code&gt;实现该功能&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;VerificationService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SendEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;toEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;code&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 构建邮件主题&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	subject &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;ClaranCloudDisk验证码&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 构建邮件内容，前端框架由AI生成&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	htmlContent &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&amp;lt;!DOCTYPE html&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&amp;lt;html&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&amp;lt;head&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&amp;lt;meta charset=&quot;utf-8&quot;&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&amp;lt;style&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			.code { &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				font-size: 24px; &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				color: #1890ff; &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				font-weight: bold;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				letter-spacing: 5px;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				padding: 10px 20px;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				background: #f0f9ff;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				border-radius: 4px;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				display: inline-block;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&amp;lt;/style&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&amp;lt;/head&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&amp;lt;body&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&amp;lt;div&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&amp;lt;h3&amp;gt;邮箱验证码&amp;lt;/h3&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&amp;lt;p&amp;gt;您的验证码是：&amp;lt;span class=&quot;code&quot;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&amp;lt;/span&amp;gt;&amp;lt;/p&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&amp;lt;p&amp;gt;验证码5分钟内有效，请尽快使用。&amp;lt;/p&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&amp;lt;/div&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&amp;lt;/body&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&amp;lt;/html&amp;gt;`&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, code)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建邮件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; email.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	e.From &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&amp;gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, s.emailConfig.FromName, s.emailConfig.FromEmail)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	e.To &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{toEmail}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	e.Subject &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; subject&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	e.HTML &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(htmlContent)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	e.Text &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;您的验证码是: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, code))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 使用连接池发送&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//return s.pool.Send(e, 10*time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Send&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.emailConfig.SMTPHost&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Itoa&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.emailConfig.SMTPPort), smtp.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PlainAuth&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, s.emailConfig.FromEmail, s.emailConfig.SMTPPass, s.emailConfig.SMTPHost))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-邮件连接池-1&quot;&gt;邮件连接池&lt;/h4&gt;&lt;p&gt;每次调用Send时都会和 SMTP 服务器建立一次连接，如果发送邮件很多很频繁的话可能会有性能问题&lt;/p&gt;
&lt;p&gt;而email提供了&lt;strong&gt;连接池&lt;/strong&gt;，可以复用网络连接&lt;/p&gt;
&lt;p&gt;以下程序创建了 4 goroutine 共用一个连接池发送邮件，并设置发送 10 封邮件后程序退出&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net/smtp&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/jordan-wright/email&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    p, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; email.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;smtp.qq.com:25&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;        4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        smtp.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PlainAuth&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;XXX@qq.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;你的授权码&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;smtp.qq.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;failed to create pool:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wg &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WaitGroup&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Done&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Send&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(e, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stderr, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; sent error:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, e, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 10&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; email.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewEmail&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        e.From &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;dj &amp;lt;XXX@qq.com&amp;gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        e.To &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;XXX@qq.com&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        e.Subject &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;Awesome web&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        e.Text &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Awesome Web &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ch)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Wait&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-注意事项-1&quot;&gt;注意事项&lt;/h2&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;SMTP认证与安全&lt;/strong&gt;： 生产环境务必使用STARTTLS（端口587）或SSL/TLS（端口465）。&lt;strong&gt;避免使用明文认证&lt;/strong&gt;。对于Gmail、QQ等，使用“&lt;strong&gt;应用专用密码&lt;/strong&gt;”而非登录密码&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;连接池管理&lt;/strong&gt;： 对于发送量大的应用，务必使用&lt;strong&gt;连接池&lt;/strong&gt;(&lt;strong&gt;email.Pool&lt;/strong&gt;)以避免频繁建立TCP/TLS连接的开销。注意合理设置池大小和超时时间&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;错误处理与重试&lt;/strong&gt;： 邮件发送可能因网络或SMTP服务器问题失败。生产代码中应考虑加入&lt;strong&gt;重试机制&lt;/strong&gt;（如指数退避）和&lt;strong&gt;死信队列&lt;/strong&gt;，确保关键邮件不丢失&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;附件大小限制&lt;/strong&gt;： 大多数SMTP服务器和邮件客户端对附件总大小有限制（通常为10MB-25MB）。对于大文件，应考虑上传到&lt;strong&gt;云存储&lt;/strong&gt;（如MinIO/S3）后，&lt;strong&gt;在邮件中发送下载链接&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;收件人列表&lt;/strong&gt;： 批量发送时，&lt;strong&gt;避免在To或Cc字段填入所有收件人地址&lt;/strong&gt;，这会&lt;strong&gt;暴露用户邮箱&lt;/strong&gt;。应使用Bcc（密送），或更好的方式是&lt;strong&gt;为每个收件人单独调用Send&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;HTML邮件兼容性&lt;/strong&gt;： 并非所有邮件客户端都完美支持现代HTML/CSS。应使用&lt;strong&gt;简单的布局和内联样式&lt;/strong&gt;，并务必&lt;strong&gt;提供Text后备版本&lt;/strong&gt;。可以使用专业工具进行测试&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;模板注入风险&lt;/strong&gt;： 如果邮件模板内容来自用户输入，必须警惕&lt;strong&gt;模板注入攻击&lt;/strong&gt;。使用html/template（而非text/template）并确保对动态内容进行正确的HTML转义&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;article-参考文章-1&quot;&gt;参考文章&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.topgoer.com/%E5%85%B6%E4%BB%96/%E5%8F%91%E9%82%AE%E4%BB%B6.html&quot;&gt;发送邮件 | Go语言中文文档&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-email/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>Zap&amp;Viper：标准化日志和配置管理</title><link>https://www.claran-blog.work/posts/go-viper-zap/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-viper-zap/</guid><description>第三方库Zap和Viper的学习.</description><pubDate>Fri, 20 Feb 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-引言-1&quot;&gt;引言&lt;/h2&gt;&lt;p&gt;在开发Go后端项目时，我们总会用到两大王牌工具：&lt;strong&gt;Zap-标准化日志管理系统&lt;/strong&gt; 和 &lt;strong&gt;Viper-配置管理系统&lt;/strong&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-zap-1&quot;&gt;Zap&lt;/h2&gt;&lt;p&gt;在构建可靠、可维护的Go应用程序时，直接使用fmt.Println或log标准库虽然简单，但难以满足生产环境对高性能、结构化和灵活配置的需求&lt;/p&gt;
&lt;p&gt;Zap是一个能够进行&lt;strong&gt;标准化日志管理的第三方库&lt;/strong&gt;，可以实现结构化，等级化且高自定义性的日志输出，无论是控制台还是日志文档都不在话下&lt;/p&gt;

&lt;h3 id=&quot;article-快速学习-1&quot;&gt;快速学习&lt;/h3&gt;&lt;p&gt;安装依赖：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; get&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -u&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; go.uber.org/zap&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-基本使用-1&quot;&gt;基本使用&lt;/h4&gt;&lt;p&gt;Zap使用&lt;strong&gt;日志器&lt;/strong&gt;（&lt;strong&gt;Logger&lt;/strong&gt;）作为对象实例进行日志管理方法&lt;/p&gt;
&lt;p&gt;在使用Logger前，需要&lt;strong&gt;初始化创建Logger&lt;/strong&gt;：&lt;/p&gt;
&lt;p&gt;而Zap提供了不同模式的Logger以供选择&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; dev&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewDevelopment&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is info&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is warn&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; test&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewExample&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;exam this is info&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;exam this is warn&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;exam this is error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; prod&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewProduction&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;prod this is info&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;prod this is warn&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;prod this is error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;dev模式&lt;/strong&gt;下，日志格式是text格式，并且warn和error会有栈信息&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;example模式&lt;/strong&gt;下，格式是json，并且字段只有level和msg&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;prod模式&lt;/strong&gt;下，格式也是json，多一个时间和函数位置字段，生产环境上用json格式的日志更方便排查&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Zap1.png&quot; alt=&quot;Zap1.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-日志级别-1&quot;&gt;日志级别&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 使用 zap 的 NewDevelopmentConfig 快速配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;cfg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewDevelopmentConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;cfg.Level &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewAtomicLevelAt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(zap.WarnLevel)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建 logger&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;logger, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cfg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Build&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Debug&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;this is dev debug log&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;this is dev info log&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;this is dev warn log&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;this is dev error log&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;this is dev fatal log&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-时间格式化-1&quot;&gt;时间格式化&lt;/h4&gt;&lt;p&gt;Zap默认的时间格式并不美观和实用，我们可以自己更改&lt;strong&gt;日志时间格式&lt;/strong&gt;：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 使用 zap 的 NewDevelopmentConfig 快速配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;cfg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewDevelopmentConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;cfg.EncoderConfig.EncodeTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TimeEncoderOfLayout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;2006-01-02 15:04:05&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 替换时间格式化方式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建 logger&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;logger, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cfg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Build&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is info&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这样，Zap输出的日志时间格式就是形如&lt;code&gt;2026-2-20 15:12:32&lt;/code&gt;样式的了&lt;/p&gt;

&lt;h4 id=&quot;article-sugar日志-1&quot;&gt;Sugar日志&lt;/h4&gt;&lt;p&gt;它提供了两种主要的日志器（Logger）：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;SugaredLogger&lt;/strong&gt;： 在性能与易用性间取得平衡，支持printf风格的格式化（如Infof）和松散的键值对（如Info(&quot;failed to fetch URL&quot;, &quot;url&quot;, url, &quot;attempt&quot;, 3)），性能远超标准库。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Logger&lt;/strong&gt;： 追求极致性能，要求所有日志字段都必须是强类型的（使用zap.Field，如zap.String(&quot;url&quot;, url)），性能比SugaredLogger更高。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;一般的Logger只有Error，Info等字符串方法，使得插入变量这一操作更加复杂&lt;/p&gt;
&lt;p&gt;而SugaredLogger（以下简称Slog）是一个&lt;strong&gt;加强版的Logger实例&lt;/strong&gt;，可以支持Printf类似的&lt;strong&gt;格式化字符串&lt;/strong&gt;方法，比如Errorf，Infof等&lt;/p&gt;
&lt;p&gt;使用 &lt;code&gt;Slog := logger.Sugar()&lt;/code&gt;得到Logger的Slog&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Zap2.png&quot; alt=&quot;Zap2.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-结构化日志-1&quot;&gt;结构化日志&lt;/h4&gt;&lt;p&gt;&lt;code&gt;zap&lt;/code&gt;支持通过&lt;code&gt;Field&lt;/code&gt;的形式记录结构化日志，方便分析和查询&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;logger, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewDevelopment&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;this is info&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;admin&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;42&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;active&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Zap3.png&quot; alt=&quot;Zap3.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-自定义解码器-1&quot;&gt;自定义解码器&lt;/h3&gt;&lt;p&gt;对于更深层级的Zap使用，我们会用到&lt;strong&gt;自定义解码器&lt;/strong&gt;，允许我们对Zap默认解码器的内部进行&lt;strong&gt;配置和功能修改&lt;/strong&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-颜色控制-1&quot;&gt;颜色控制&lt;/h4&gt;&lt;p&gt;让zap输出指定颜色的日志，本质上是对默认配置&lt;code&gt;NewDevelopmentConfig()&lt;/code&gt;中的解码器配置&lt;code&gt;EncoderConfig&lt;/code&gt;里的&lt;code&gt;EncodeLevel&lt;/code&gt;定制解码器&lt;code&gt;Encoder&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;以及，我们需要了解控制台的&lt;strong&gt;颜色控制字符&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[31mthis is 红色&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[0m&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[32mthis is 绿色&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[0m&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[33mthis is 黄色&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[0m&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[34mthis is 蓝色&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[0m&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[35mthis is 紫色&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[0m&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[36mthis is 青色&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[0m&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Encoder代码示例：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 定义颜色&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  colorRed&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[31m&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  colorGreen&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[32m&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  colorYellow&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[33m&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  colorBlue&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;   =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[34m&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  colorReset&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[0m&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 自定义 EncodeLevel&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; coloredLevelEncoder&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;level&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; zapcore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Level&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;enc&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; zapcore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PrimitiveArrayEncoder&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; level {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.DebugLevel:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    enc.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AppendString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(colorBlue &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;DEBUG&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; colorReset)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.InfoLevel:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    enc.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AppendString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(colorGreen &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;INFO&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; colorReset)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.WarnLevel:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    enc.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AppendString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(colorYellow &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;WARN&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; colorReset)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.ErrorLevel, zapcore.DPanicLevel, zapcore.PanicLevel, zapcore.FatalLevel:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    enc.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AppendString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(colorRed &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;ERROR&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; colorReset)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    enc.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AppendString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(level.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 默认行为&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; dev&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 使用 zap 的 NewDevelopmentConfig 快速配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  cfg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewDevelopmentConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  cfg.EncoderConfig.EncodeTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TimeEncoderOfLayout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;2006-01-02 15:04:05&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 替换时间格式化方式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  cfg.EncoderConfig.EncodeLevel &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; coloredLevelEncoder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 创建 logger&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cfg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Build&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is info&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is warn&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;此时日志等级的输出效果被美化&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Zap4.png&quot; alt=&quot;Zap4.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-自定义日志输出-1&quot;&gt;自定义日志输出&lt;/h4&gt;&lt;p&gt;通过自定义&lt;strong&gt;Encoder&lt;/strong&gt;，对原始日志行进行字符串方法处理&lt;/p&gt;
&lt;p&gt;以下是为日志行增加项目名称前缀的示例&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 定义前缀&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; logPrefix&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;[MyApp] &quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 自定义 Encoder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; prefixedEncoder&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;  zapcore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Encoder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;prefixedEncoder&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EncodeEntry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;entry&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; zapcore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Entry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;fields&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;zapcore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Field&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;buffer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Buffer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 先调用原始的 EncodeEntry 方法生成日志行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  buf, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e.Encoder.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EncodeEntry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(entry, fields)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 在日志行的最前面添加前缀&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logLine &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Reset&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AppendString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(logPrefix &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; logLine)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; dev&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 使用 zap 的 NewDevelopmentConfig 快速配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  cfg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewDevelopmentConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  cfg.EncoderConfig.EncodeTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TimeEncoderOfLayout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;2006-01-02 15:04:05&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 替换时间格式化方式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 创建自定义的 Encoder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  encoder &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;prefixedEncoder&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Encoder: zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewConsoleEncoder&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cfg.EncoderConfig), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 使用 Console 编码器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 创建 Core&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  core &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewCore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    encoder,                    &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 使用自定义的 Encoder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddSync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdout), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出到控制台&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    zapcore.DebugLevel,         &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 设置日志级别&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 创建 Logger&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(core, zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddCaller&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is info&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is warn&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;效果预览&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Zap5.png&quot; alt=&quot;Zap5.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-全局日志-1&quot;&gt;全局日志&lt;/h4&gt;&lt;p&gt;有些时候想要在应用程序的任何地方都可以直接使用的日志实例，就需要用到&lt;strong&gt;全局日志&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始化全局日志&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; initLogger&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 使用 zap 的 NewDevelopmentConfig 快速配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  cfg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewDevelopmentConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  cfg.EncoderConfig.EncodeTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TimeEncoderOfLayout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;2006-01-02 15:04:05&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 替换时间格式化方式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 创建 Logger&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; cfg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Build&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReplaceGlobals&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(logger)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; dev&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is info&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is warn&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Infof&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is info &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;xxx&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warnf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is warn &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;xxx&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;dev this is error &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;xxx&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;L方法返回的是&lt;strong&gt;标准zap实例&lt;/strong&gt;，S方法返回的是&lt;strong&gt;SuperedZap的实例&lt;/strong&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-日志双写-1&quot;&gt;日志双写&lt;/h4&gt;&lt;p&gt;日志双写就是同时把日志行写出在控制台和日志文件中&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始化全局日志&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; initLogger&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 使用 zap 的 NewDevelopmentConfig 快速配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  cfg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewDevelopmentConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  cfg.EncoderConfig.EncodeTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TimeEncoderOfLayout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;2006-01-02 15:04:05&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 替换时间格式化方式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 创建 Core&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  consoleCore &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewCore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewConsoleEncoder&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cfg.EncoderConfig),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddSync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdout), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出到控制台&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    zapcore.DebugLevel,         &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 设置日志级别&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  file, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;OpenFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.log&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, os.O_CREATE&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;|&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;os.O_APPEND&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;|&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;os.O_WRONLY, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0644&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  fileCore &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewCore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewConsoleEncoder&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cfg.EncoderConfig),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddSync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(file), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出到文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    zapcore.DebugLevel,    &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 设置日志级别&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  core &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewTee&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(consoleCore, fileCore)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 创建 Logger&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  logger &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(core, zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddCaller&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReplaceGlobals&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(logger)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;使用zapcore.NewTee可以组合多个core实例&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-日志分片-1&quot;&gt;日志分片&lt;/h4&gt;&lt;p&gt;将日志文件以不同的策略进行分片处理，常见的为&lt;strong&gt;按时间分片&lt;/strong&gt;和&lt;strong&gt;按等级分片&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;以下代码实现了按照日期进行日志分片，并单独分理处ERR等级的日志行&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; log&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;path/filepath&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go.uber.org/zap&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go.uber.org/zap/buffer&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go.uber.org/zap/zapcore&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 颜色配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;	colorRed&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[31m&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;	colorGreen&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[32m&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;	colorYellow&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[33m&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;	colorBlue&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;   =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[34m&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;	colorReset&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\033&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;[0m&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// MyEncoder 自定义解码器模型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; MyEncoder&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	AppName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;	zapcore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Encoder&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	errFile &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	writer  &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MyLogWriter&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// MyLogWriter 自定义日志文件写入器模型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; MyLogWriter&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	mu      &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Mutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	logDate &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	file    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;File&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	logPath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 自定义解码器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MyEncoder&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EncodeEntry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;entry&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; zapcore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Entry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;fields&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;zapcore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Field&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;buffer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Buffer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 获取原始解码数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	buf, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.Encoder.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EncodeEntry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(entry, fields)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 自定义前缀数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	DataStr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Reset&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AppendString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;[&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.AppName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;] &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; DataStr)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 时间分片&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	m.writer.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.writer.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	currentDate &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Format&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;2006-01-02&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 检查是否需要切换到新的日志文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.writer.logDate &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; currentDate {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 关闭当前日志文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.writer.file &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			m.writer.file.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 创建新的日志文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		newPath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(m.writer.logPath, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, currentDate)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MkdirAll&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(newPath, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0755&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建文件夹错误&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		filePath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(newPath, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot; INFO&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		file, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;OpenFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filePath, os.O_CREATE&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;|&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;os.O_APPEND&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;|&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;os.O_WRONLY, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0644&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 不存在则创建，只写入&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;打开文件错误&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filePath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 更新writer&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		m.writer.file &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; file&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		m.writer.logDate &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; currentDate&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 如果是err及以下的log_level&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; entry.Level &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.ErrorLevel {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.errFile &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;			// 创建新的日志文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			newPath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(m.writer.logPath, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, currentDate)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			filePath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(newPath, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot; ERR&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			errFile, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;OpenFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filePath, os.O_CREATE&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;|&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;os.O_APPEND&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;|&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;os.O_WRONLY, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0644&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 不存在则创建，只写入&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			m.errFile &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errFile&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		m.errFile.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.writer.logDate &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; currentDate {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		m.writer.file.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(buf.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 返回数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; buf, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; InitLogManager&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;appName&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;logPath&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	cfg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewDevelopmentConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 时间格式化配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	cfg.EncoderConfig.EncodeTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TimeEncoderOfLayout&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;2006-01-02 15:04:05&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 配置自定义解码器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	myEncoder &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MyEncoder&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		AppName: appName,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Encoder: zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewConsoleEncoder&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(cfg.EncoderConfig),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		writer: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MyLogWriter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			logPath: logPath,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建core&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	core &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewCore&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		myEncoder,                  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 解码器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zapcore.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddSync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Stdout), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出到控制台&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zapcore.InfoLevel,          &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// log_level&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建logger&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Logger &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(core, zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddCaller&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 全局日志&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReplaceGlobals&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(Logger)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;效果预览&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Zap6.png&quot; alt=&quot;Zap6.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-使用标准-1&quot;&gt;使用标准&lt;/h3&gt;&lt;p&gt;在后端web项目中，应当对&lt;strong&gt;主程序的开始/结束&lt;/strong&gt;，&lt;strong&gt;路由的注册&lt;/strong&gt;，&lt;strong&gt;路由的请求开始/结束&lt;/strong&gt;，&lt;strong&gt;缓存的命中信息&lt;/strong&gt;，以及&lt;strong&gt;所有的错误触发点&lt;/strong&gt;进行日志写入，并搭配合理的错误抛出机制，快速定位错误来源&lt;/p&gt;
&lt;p&gt;注意&lt;strong&gt;避免暴露敏感信息&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;项目日志示例：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Zap7.png&quot; alt=&quot;Zap7.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-viper-1&quot;&gt;Viper&lt;/h2&gt;&lt;p&gt;Viper则是配置管理的万能钥匙，支持&lt;strong&gt;多种配置源管理&lt;/strong&gt;和&lt;strong&gt;动态热更新&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;Viper 使用如下的优先级来读取配置：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;显示的值设置&lt;/li&gt;
&lt;li&gt;命令行标记标记&lt;/li&gt;
&lt;li&gt;环境变量&lt;/li&gt;
&lt;li&gt;配置文件&lt;/li&gt;
&lt;li&gt;键值存储&lt;/li&gt;
&lt;li&gt;默认值&lt;/li&gt;
&lt;/ol&gt;
&lt;blockquote&gt;
&lt;p&gt;注：Viper 配置中的键不区分大小写&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3 id=&quot;article-快速学习-2&quot;&gt;快速学习&lt;/h3&gt;&lt;p&gt;安装依赖&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; get&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -u&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; github.com/spf13/viper&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-设置默认值-1&quot;&gt;设置默认值&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetDefault&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;filePath&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;./dir/images/albums/blogAlbum/usr&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetDefault&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;root&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;123456&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;以下以环境变量&lt;code&gt;.env&lt;/code&gt;管理和配置文件&lt;code&gt;.yaml&lt;/code&gt;管理做代码演示&lt;/p&gt;

&lt;h4 id=&quot;article-环境变量-1&quot;&gt;环境变量&lt;/h4&gt;&lt;p&gt;viper可以轻松地绑定环境变量&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AutomaticEnv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 自动绑定所有环境变量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BindEnv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;database.user&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;DB_USER&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 显式绑定特定环境变量&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-配置文件-1&quot;&gt;配置文件&lt;/h4&gt;&lt;p&gt;viper可以轻松地读写配置文件&lt;/p&gt;

&lt;h5 id=&quot;article-读取-1&quot;&gt;读取&lt;/h5&gt;&lt;p&gt;首先需要配置viper，让viper知道在哪里查找配置文件&lt;/p&gt;
&lt;p&gt;Viper 支持 JSON、 TOML、 YAML、 HCL、 INI、 envfile 和 JavaProperties 文件&lt;/p&gt;
&lt;p&gt;Viper 可以同时搜索多个路径，但目前单个 Viper 实例&lt;strong&gt;只支持单个配置文件&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;下面是使用 Viper 读取配置文件的一个示例，不需要指定一个完整路径，但在使用时至少应当提供一个配置文件&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; TestReadConfigFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;t&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;testing&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;T&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;   viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetConfigName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;config.yml&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 读取名为config的配置文件，没有设置特定的文件后缀名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;   viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetConfigType&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;yaml&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)       &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 当没有设置特定的文件后缀名时，必须要指定文件类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;   viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddConfigPath&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;./&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)         &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 在当前文件夹下寻找&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;   viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddConfigPath&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;$HOME/&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)     &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 使用变量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;   viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddConfigPath&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;.&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)          &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 在工作目录下查找&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;   err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadInConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//读取配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;   if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;      log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;   }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;当未找到配置文件时：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadInConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;  if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err.(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;viper&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ConfigFileNotFoundError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 配置文件未找到&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  } &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 其他类型的错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;当访问嵌套配置的时候通过&lt;code&gt;.&lt;/code&gt;&lt;strong&gt;分隔符&lt;/strong&gt;进行访问，例如：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;server&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;database&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;      &quot;url&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;mysql....&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;可以通过&lt;code&gt;GetString(&quot;server.database.url&quot;)&lt;/code&gt;来进行&lt;strong&gt;嵌套访问&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;访问配置的所有函数：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;Get(key string) : interface{}&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GetBool(key string) : bool&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GetFloat64(key string) : float64&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GetInt(key string) : int&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GetIntSlice(key string) : []int&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GetString(key string) : string&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GetStringMap(key string) : map[string]interface{}&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GetStringMapString(key string) : map[string]string&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GetStringSlice(key string) : []string&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GetTime(key string) : time.Time&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;GetDuration(key string) : time.Duration&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;IsSet(key string) : bool&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;AllSettings() : map[string]interface{}&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h6 id=&quot;article-演示-1&quot;&gt;演示&lt;/h6&gt;&lt;p&gt;对于这样一个依赖于环境变量&lt;code&gt;.env&lt;/code&gt;的&lt;code&gt;yaml&lt;/code&gt;配置文件：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;YAML&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;#===============================应用配置=================================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;app&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${APP_NAME}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  env&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${APP_ENV}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  log_path&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${LOG_PATH}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  max_requests_every_minute&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${MAX_REQUESTS_EVERY_MINUTE}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  http&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    host&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${APP_HOST}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    port&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${APP_PORT}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  file&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    cloud_file_dir&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${CLOUD_FILE_DIR}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    avatar_dir&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${AVATAR_DIR}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    default_avatar_dir&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${DEFAULT_AVATAR_PATH}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    max_file_size&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${MAX_FILE_SIZE}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    normal_user_max_storage&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${NORMAL_USER_MAX_STORAGE}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    limited_speed&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${LIMITED_SPEED}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;jwt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  secret_key&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${SECRET_KEY}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  issuer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${ISSUER}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  exp_time_hours&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${EXP_TIME_HOURS}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;#===============================数据库配置===============================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;database&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  mysql&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    root_password&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${MYSQL_ROOT_PASSWORD}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    database&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${MYSQL_DATABASE}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${MYSQL_USER}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    password&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${MYSQL_PASSWORD}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    dsn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${DB_DSN}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  redis&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    addr&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${REDIS_ADDR}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    password&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${REDIS_PASSWORD}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;    db&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${REDIS_DB}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;#===============================存储配置================================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;minIO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  root_user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${MINIO_ROOT_USER}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  password&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${MINIO_ROOT_PASSWORD}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${MINIO_ENDPOINT}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  bucket_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${MINIO_BUCKET_NAME}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;#===============================服务器邮箱配置===========================&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  SMTP_host&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${SMTP_HOST}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  SMTP_port&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${SMTP_PORT}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  SMTP_user&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${SMTP_USER}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  SMTP_pass&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${SMTP_PASS}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  from_name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${FROM_NAME}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#22863A&quot;&gt;  from_email&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;${FROM_EMAIL}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;使用如下代码进行配置管理：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; config&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os/signal&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;syscall&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/fsnotify/fsnotify&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/spf13/viper&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go.uber.org/zap&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; EmailConfig&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	SMTPHost  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	SMTPPort  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	SMTPUser  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	SMTPPass  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	FromName  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	FromEmail &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; RedisConfig&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Addr     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Password &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	DB       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; MinIOConfig&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	MinIORootName   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	MinIOPassword   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	MinIOEndpoint   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	MinIOBucketName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Config&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// App&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	AppName     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	LogPath     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	MaxRequests &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// jwt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	JWTSecret      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	JWTIssuer      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	JWTExpireHours &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// Files&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	CloudFileDir         &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	AvatarDIR            &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	DefaultAvatarPath    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	MaxFileSize          &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 单个文件大小限制 (GB)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	NormalUserMaxStorage &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 非VIP用户存储空间限制 (GB)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	LimitedSpeed         &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 非VIP用户下载速度限额 (MB) - 0 为不限速&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// mysql&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	DSN &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//redis&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Redis &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RedisConfig&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//minIO&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	MinIO &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MinIOConfig&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//Email&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Email &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EmailConfig&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//http&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Host &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Port &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; InitConfigByViper&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//初始化viper&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetConfigName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;config&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetConfigType&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;yaml&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddConfigPath&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;./config/config.yaml&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 加载环境变量文件 .env&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	godotenv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Load&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//读取config.yaml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	configContent, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;./config/config.yaml&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;os读取config.yaml失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//展开环境变量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	expandedContent &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ExpandEnv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(configContent))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//提取config.yaml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(expandedContent)); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;viper提取config.yaml失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 默认配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetDefault&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;ClaranCloudDisk&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetDefault&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.file.cloud_file_dir&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;./CloudFiles&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetDefault&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.file.avatar_dir&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;./Avatars&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetDefault&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.file.default_avatar_path&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;./Avatars/DefaultAvatar/DefaultAvatar.png&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetDefault&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.log_path&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;./log./logs&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//返回配置数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		AppName:              viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		LogPath:              viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.log_path&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MaxRequests:          viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.max_requests_every_minute&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		JWTSecret:            viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;jwt.secret_key&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		JWTIssuer:            viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;jwt.issuer&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		JWTExpireHours:       viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;jwt.exp_time_hours&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		CloudFileDir:         viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.file.cloud_file_dir&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		AvatarDIR:            viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.file.avatar_dir&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		DefaultAvatarPath:    viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.file.default_avatar_dir&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MaxFileSize:          viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.file.max_file_size&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),           &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 25 GB&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		NormalUserMaxStorage: viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.file.normal_user_max_storage&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//100 GB&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		LimitedSpeed:         viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.file.limited_speed&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),           &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 10 MB/s&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		DSN:                  viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;database.mysql.dsn&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Redis: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RedisConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Addr:     viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;database.redis.addr&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			Password: viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;database.redis.password&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			DB:       viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;database.redis.db&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MinIO: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MinIOConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			MinIORootName:   viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;minio.root_user&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			MinIOPassword:   viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;minio.password&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			MinIOEndpoint:   viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;minio.endpoint&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			MinIOBucketName: viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;minio.bucket_name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Email: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;EmailConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			SMTPHost:  viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email.SMTP_host&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			SMTPPort:  viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email.SMTP_port&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			SMTPUser:  viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email.SMTP_user&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			SMTPPass:  viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email.SMTP_pass&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			FromName:  viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email.from_name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			FromEmail: viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;email.from_email&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		},&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Host: viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.http.host&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Port: viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;app.http.port&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-写入-1&quot;&gt;写入&lt;/h5&gt;&lt;p&gt;Viper 提供了一系列函数来方便开发者将运行时存储的配置&lt;strong&gt;写入配置文件&lt;/strong&gt;中&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// WriteConfig 将配置写入原配置文件中，不存在会报错，存在的话会覆盖&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WriteConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; v.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// SafeWriteConfig 将配置安全的写入原配置文件中，不存在时会写入，存在的话则不会覆盖&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; SafeWriteConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; v.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SafeWriteConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// WriteConfigAs 将当前的配置写入指定文件，文件不存在时会返回错误，存在时会覆盖原有配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WriteConfigAs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;filename&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; v.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WriteConfigAs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filename) }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// SafeWriteConfigAs 如果指定的文件存在的话，将不会覆盖原配置文件，文件存在的话会返回错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; SafeWriteConfigAs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;filename&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; v.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SafeWriteConfigAs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(filename) }&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-监控和重载配置-1&quot;&gt;监控和重载配置&lt;/h3&gt;&lt;p&gt;Viper 允许应用程序在运行时&lt;strong&gt;动态读取配置文件&lt;/strong&gt;，即不需要重新启动应用程序也可以使更新的配置生效&lt;/p&gt;
&lt;p&gt;只需要简单地告诉 Viper 实例去监视配置变化，或者可以提供一个函数给 viper 以便每次发生变化时运行该函数&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; TestWatchingConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;t&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;testing&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;T&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;OnConfigChange&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;e&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; fsnotify&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Event&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;配置文件已更改:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, e.Name)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;  viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WatchConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;以下为项目中监控和重载配置的示例：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WatchConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;开始监控配置文件&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	watcher, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fsnotify.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewWatcher&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建监控器失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; watcher.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; watcher.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;./config/config.yaml&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;监控文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;监控配置文件中: ./config/config.yaml&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//信号传递&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	signalChan &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; os&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Signal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	signal.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Notify&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(signalChan, os.Interrupt, syscall.SIGTERM)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//持续监控&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;watcher.Events:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; event.Op&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fsnotify.Write &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fsnotify.Write {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warnf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;检测到配置文件变化: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, event.Name)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Millisecond)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				//热重载&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				//读取config.yaml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				configContent, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadFile&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;./config/config.yaml&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;os读取config.yaml失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				//展开环境变量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				expandedContent &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ExpandEnv&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(configContent))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				//fmt.Println(expandedContent)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				//提取config.yaml&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; viper.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(expandedContent)); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;viper提取config.yaml失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Warn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;配置已热重载，请及时重启服务器&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;watcher.Errors:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;监控出错:  &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;signalChan:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;L&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Info&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;停止监控&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-参考文章-1&quot;&gt;参考文章&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://golang.halfiisland.com/community/pkgs/config/Viper.html&quot;&gt;Viper | Golang学习中文文档&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.fengfengzhidao.com/article/e8OCcZUB8lppN5cb7HmJ&quot;&gt;枫枫知道 | Zap第三方库&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-viper-zap/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>MinIO：完美的对象存储</title><link>https://www.claran-blog.work/posts/go-minio/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-minio/</guid><description>minio及其在Go中的使用.</description><pubDate>Thu, 19 Feb 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-引言-1&quot;&gt;引言&lt;/h2&gt;&lt;p&gt;最近做了网盘相关项目，了解一下一般情况下常用的一些文件存储方法：用IO库进行的&lt;strong&gt;本地磁盘存储&lt;/strong&gt;，需要付费但是方便安全的&lt;strong&gt;OSS云存储&lt;/strong&gt;（阿里云等），以及今天的主角的-&lt;strong&gt;MinIO&lt;/strong&gt;对象存储系统&lt;/p&gt;
&lt;p&gt;可以说，MinIO就是可以存储文件的“数据库”&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;在本质上，OSS云存储也只不过是在企业云服务器上部署的MinIO或本地存储方式，MinIO同样也是经过包装过的直接访问本地磁盘的存储方式&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2 id=&quot;article-概述和特点-1&quot;&gt;概述和特点&lt;/h2&gt;&lt;p&gt;MinIO的独特之处，在于其完全&lt;strong&gt;云原生&lt;/strong&gt;，&lt;strong&gt;高性能&lt;/strong&gt;，&lt;strong&gt;轻量级&lt;/strong&gt;且&lt;strong&gt;完全开源&lt;/strong&gt;的设计哲学，内部完全由&lt;strong&gt;Go语言&lt;/strong&gt;实现，它重新定义了企业级对象存储的构建和运行方式&lt;/p&gt;
&lt;p&gt;再简单点说，MinIO的独特之处在于，它将对象存储的门槛降到了最低（&lt;strong&gt;轻量 &amp;amp; 开源&lt;/strong&gt;），同时将性能拉到了最高，专为&lt;strong&gt;云原生&lt;/strong&gt;和&lt;strong&gt;容器化环境&lt;/strong&gt;而生&lt;/p&gt;
&lt;p&gt;如同之前所说，MinIO是一种完美的对象存储系统，那么MinIO和其他存储方式有什么区别呢？&lt;/p&gt;
&lt;p&gt;这里我们就要聚焦到MinIO的&lt;strong&gt;设计理念&lt;/strong&gt;和&lt;strong&gt;S3标准的云原生&lt;/strong&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-独特的对象和k-v化存储-object-bucket-1&quot;&gt;独特的对象和K-V化存储（Object &amp;amp; Bucket）&lt;/h3&gt;&lt;p&gt;MinIO的对象化存储，存的不只是文件的数据，还有文件的&lt;strong&gt;标识符Key&lt;/strong&gt;和文件的&lt;strong&gt;元数据Value&lt;/strong&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-k-v-1&quot;&gt;K-V&lt;/h4&gt;&lt;p&gt;在minIO的存储设计里，所有需要存储的文件本质上都是一个&lt;strong&gt;对象（Object）&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;我们都知道，无论是最简单的文本文件TXT，还是动辄几GB的视频文件或文件流，本质上都是由&lt;strong&gt;字节流&lt;/strong&gt;（&lt;strong&gt;byte[]&lt;/strong&gt;）构成的，而MinIO存储的正是这种字节流（byte[]），因此MinIO基本能够存储所有文件类型&lt;/p&gt;
&lt;p&gt;更重要的是，MinIO将每个对象都通过一个唯一的“键”寻址，并与元数据绑定，这也是S3的协议标准&lt;/p&gt;

&lt;h4 id=&quot;article-存储桶-bucket-1&quot;&gt;存储桶（Bucket）&lt;/h4&gt;&lt;p&gt;在MinIO中，这个K-v设计中的这个Key可以是&lt;code&gt;MyApp/Project1/storage/1.txt&lt;/code&gt;，但本质上这个Key是一个&lt;strong&gt;标识符&lt;/strong&gt;，而非真实的目录层级&lt;/p&gt;
&lt;p&gt;因此，与传统的&lt;strong&gt;树状文件系统&lt;/strong&gt;不同的是，MinIO独特的&lt;strong&gt;KV式&lt;/strong&gt;设计，让他的对象存储变成了一个巨大的**“存储池”**，而非依赖于路径下层层进深的树状结构。&lt;/p&gt;
&lt;p&gt;所有对象都放在一个巨大的&lt;strong&gt;桶&lt;/strong&gt;（&lt;strong&gt;Bucket&lt;/strong&gt;）里，通过唯一的键Key直接定位&lt;/p&gt;
&lt;p&gt;这种设计让存储的拓展性变得无比简单，让人无须担心目录树的深度或复杂度&lt;/p&gt;

&lt;h3 id=&quot;article-s3-1&quot;&gt;S3&lt;/h3&gt;&lt;p&gt;在说云原生之前，我们需要先了解一下S3这一概念&lt;/p&gt;
&lt;p&gt;S3 是 &lt;strong&gt;Amazon Simple Storage Service&lt;/strong&gt; 的简称，是亚马逊AWS云提供的一项&lt;strong&gt;核心对象存储服务&lt;/strong&gt;，核心结构也为B-O（Bucket-Object）式存储服务，具有&lt;strong&gt;高耐久性&lt;/strong&gt;和&lt;strong&gt;可用性&lt;/strong&gt;，使用标准的&lt;strong&gt;RESTful API&lt;/strong&gt;进行上传，下载和管理操作&lt;/p&gt;
&lt;p&gt;由于S3出色的设计，可靠的稳定性，S3的API接口已经成为对象存储领域的行业标准协议。无数应用程序，工具或开源项目都原生支持S3协议&lt;/p&gt;

&lt;h3 id=&quot;article-云原生-1&quot;&gt;云原生&lt;/h3&gt;&lt;p&gt;云原生意味着MinIO不仅采用了&lt;strong&gt;云原生架构原则&lt;/strong&gt;，也可以运行在云服务器上&lt;/p&gt;
&lt;p&gt;MinIO本身可以看作一个&lt;strong&gt;提供S3 API的微服务&lt;/strong&gt;，用户可以通过K8S，用yaml文档声明式地定义和部署一个MinIO集群以实现自动化运维，且可以根据自身情况，动态规划MinIO中的Pod实例数量来契合个人的项目数据&lt;/p&gt;
&lt;p&gt;也正是因为MinIO的&lt;strong&gt;S3支持&lt;/strong&gt;和他强大的&lt;strong&gt;工具生态&lt;/strong&gt;，MinIO才得以成为对象存储的杀手锏&lt;/p&gt;

&lt;h2 id=&quot;article-minio的使用-1&quot;&gt;MinIO的使用&lt;/h2&gt;&lt;p&gt;我们可以在自己的项目里运用MinIO存储&lt;/p&gt;

&lt;h3 id=&quot;article-快速开始-1&quot;&gt;快速开始&lt;/h3&gt;
&lt;h4 id=&quot;article-1-拉取并运行docker镜像-1&quot;&gt;1. 拉取并运行Docker镜像&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 拉取最新的MinIO镜像&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; pull&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; minio/minio&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 运行 MinIO 容器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 将主机上的 `~/minio/data` 目录挂载到容器内，用于持久化存储数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 将主机上的 `~/minio/config` 目录挂载到容器内，用于存储配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;# 默认控制台端口为 9001，API端口为 9000&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 9000:9000&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -p&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 9001:9001&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  --name&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; minio&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; ~/minio/data:/data&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; ~/minio/config:/root/.minio&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -e&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;MINIO_ROOT_USER=admin&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  -e&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;MINIO_ROOT_PASSWORD=yourstrongpassword&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  minio/minio&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; server&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; /data&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; --console-address&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;:9001&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-2-minio管理控制台-1&quot;&gt;2. MinIO管理控制台&lt;/h4&gt;&lt;p&gt;运行后，可以通过访问&lt;a&gt;http://localhost:9001，使用上述账号密码登录MinIO管理控制台&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-3-安装客户端库-1&quot;&gt;3. 安装客户端库&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; get&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; github.com/minio/minio-go/v7&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-4-初始化客户端库-1&quot;&gt;4. 初始化客户端库&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/minio/minio-go/v7&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/minio/minio-go/v7/pkg/credentials&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 配置参数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    endpoint &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;localhost:9000&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    accessKeyID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;admin&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 即 MINIO_ROOT_USER&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    secretAccessKey &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;yourstrongpassword&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 即 MINIO_ROOT_PASSWORD&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    useSSL &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 使用http/https&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 初始化客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    minioClient, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; minio.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(endpoint, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Options&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Creds:  credentials.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewStaticV4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(accessKeyID, secretAccessKey, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Secure: useSSL,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;初始化客户端失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%#v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, minioClient) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 打印客户端信息，确认连接成功&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-api实例-1&quot;&gt;API实例&lt;/h3&gt;
&lt;h4 id=&quot;article-初始化客户端-1&quot;&gt;初始化客户端&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ctx &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    endpoint &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;localhost:9000&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    accessKeyID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;your-access-key&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    secretAccessKey &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;your-secret-key&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    useSSL &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 初始化客户端&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    minioClient, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; minio.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(endpoint, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Options&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Creds:  credentials.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewStaticV4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(accessKeyID, secretAccessKey, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Secure: useSSL,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-创建存储桶-1&quot;&gt;创建存储桶&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建一个存储桶（如果不存在）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    bucketName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;my-documents&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    location &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;us-east-1&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 对MinIO来说，这个值通常无关紧要&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MakeBucket&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, bucketName, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MakeBucketOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Region: location})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 检查存储桶是否已存在&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        exists, errBucketExists &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BucketExists&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, bucketName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errBucketExists &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; exists {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;存储桶 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 已存在&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, bucketName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        } &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建存储桶失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    } &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;成功创建存储桶 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, bucketName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-上传文件-1&quot;&gt;上传文件&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;   // 3. 上传一个文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    objectName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;example.jpg&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    filePath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;./local-image.jpg&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    contentType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;image/jpeg&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    info, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FPutObject&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, bucketName, objectName, filePath, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PutObjectOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{ContentType: contentType})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;上传文件失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;成功上传 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;，大小：&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; bytes， ETag： &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, objectName, info.Size, info.ETag)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-生成url-1&quot;&gt;生成URL&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 4. 生成一个用于临时访问文件的预签名URL（有效期7天）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    expiry &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 7&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 24&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 60&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 60&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 秒&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    presignedURL, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PresignedGetObject&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, bucketName, objectName, time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(expiry)&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.Second, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatalln&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;生成预签名URL失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;您可以通过此链接临时访问文件：&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, presignedURL.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-注意事项-1&quot;&gt;注意事项&lt;/h3&gt;&lt;ol&gt;
&lt;li&gt;启用HTTPS以加密数据传输&lt;/li&gt;
&lt;li&gt;可以在控制台通过&lt;code&gt;Access Key&lt;/code&gt;为不同程序创建具有特定策略（policy）的子账户，避免直接使用ROOT账户密钥&lt;/li&gt;
&lt;li&gt;数据持久化：使用Docker或K8S不是时，务必通过卷（Volume）或持久化卷声明（PVC）将&lt;code&gt;/data&lt;/code&gt;目录挂载到宿主机或网络存储，避免重启容器造成数据丢失&lt;/li&gt;
&lt;li&gt;桶命名（bucket_name）限制: 3-63字符，只允许 小写字母,数字,点号&lt;code&gt;.&lt;/code&gt;,连字符&lt;code&gt;-&lt;/code&gt;，不能包含相邻的句点&lt;code&gt;..&lt;/code&gt;或与连字符相邻的句点&lt;code&gt;.-&lt;/code&gt;/&lt;code&gt;-.&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;对象命名（object_name）: 建议使用 ASCⅡ可打印字符，在Windows环境使用时，不允许包含对操作系统有歧义的字符 &quot;./&quot;&lt;/li&gt;
&lt;/ol&gt;

&lt;h3 id=&quot;article-项目实例-1&quot;&gt;项目实例&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; minIO&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;bytes&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;io&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;mime&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;path&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;path/filepath&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/minio/minio-go/v7&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/minio/minio-go/v7/pkg/credentials&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go.uber.org/zap&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; MinIOClient&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Client     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Client&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	BucketName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewMinIOClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;endpoint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;accessKeyID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;secretAccessKey&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;bucketName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;DefaultAvatarPath&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MinIOClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//初始化minIOClient&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	minioClient, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; minio.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(endpoint, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Options&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Creds:  credentials.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewStaticV4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(accessKeyID, secretAccessKey, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Secure: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// http&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;初始化minIO客户端失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//验证bucket是否存在&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	exist, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BucketExists&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), bucketName)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;exist {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MakeBucket&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), bucketName, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MakeBucketOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;新建bucket失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;验证minIO_bucket失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//上传默认头像&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Path &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;.&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, DefaultAvatarPath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	DefaultAvatar, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Open&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取默认头像失败:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	DefaultAvatarData, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; io.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadAll&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(DefaultAvatar)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ext &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; path.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Ext&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(DefaultAvatarPath)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	reader &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bytes.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(DefaultAvatarData)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	size &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(DefaultAvatarData))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	mimeType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; mime.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TypeByExtension&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ext)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	opts &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PutObjectOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{ContentType: mimeType}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	_, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; minioClient.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PutObject&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), bucketName, DefaultAvatarPath, reader, size, opts)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;上传默认头像失败:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;上传默认头像失败:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MinIOClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Client:     minioClient,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		BucketName: bucketName,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MinIOClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Save&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;objectName&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;data&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ext&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//捕获数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//mimeType := mime.TypeByExtension(ext)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	mimeType &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; mime.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TypeByExtension&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ext)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	reader &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bytes.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewReader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(data)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	size &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(data))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//Options&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	opts &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PutObjectOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{ContentType: mimeType}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//保存文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//PutObject(ctx context.Context, bucketName, objectName string, reader io.Reader, objectSize int64,opts PutObjectOptions) (info UploadInfo, err error)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	_, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.Client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PutObject&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, m.BucketName, objectName, reader, size, opts)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;保存到minIO失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;保存到minIO失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MinIOClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Delete&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;objectName&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//RemoveObject(ctx context.Context, bucketName, objectName string, opts minio.RemoveObjectOptions) error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.Client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RemoveObject&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, m.BucketName, objectName, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RemoveObjectOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		zap.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;S&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;从minIO删除文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;从minIO删除文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MinIOClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Update&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;objectName&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;data&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ext&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Save&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, objectName, data, ext)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MinIOClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exists&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;objectName&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//StatObject(ctx context.Context, bucketName, objectName string, opts StatObjectOptions) (ObjectInfo, error)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//NoSuchKey&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	_, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.Client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StatObject&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, m.BucketName, objectName, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StatObjectOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errType, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err.(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ErrorResponse&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errType.Code &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;NoSuchKey&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; false&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;检查文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MinIOClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetBytes&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;objectName&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) ([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//GetObject(ctx context.Context, bucketName, objectName string, opts GetObjectOptions) (*Object, error)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	obj, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.Client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetObject&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, m.BucketName, objectName, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetObjectOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; obj.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//检查文件是否存在&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; obj.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Stat&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;文件不存在: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//读取数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	data, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; io.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadAll&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(obj)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;读取文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; data, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MinIOClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetStream&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ctx&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;objectName&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;io&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ReadCloser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//GetObject(ctx context.Context, bucketName, objectName string, opts GetObjectOptions) (*Object, error)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	obj, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; m.Client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetObject&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, m.BucketName, objectName, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;minio&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetObjectOptions&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取文件失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//流式传输不关闭obj，直接返回&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; obj, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-参考文章-1&quot;&gt;参考文章&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://min-io.cn/docs/minio/linux/developers/go/minio-go.html&quot;&gt;minio-Go 快速入门指南&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-minio/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>工具</category></item><item><title>随笔.7：期末月的自我欺骗</title><link>https://www.claran-blog.work/posts/diary7/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/diary7/</guid><description>颓废了一段时间.</description><pubDate>Thu, 29 Jan 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;隔了将近一个月，我终于滚回来里qwq&lt;/p&gt;
&lt;p&gt;离开都前半段时间表面上说是在复习期末周，实际上一开始复习文化课就忍不住摸鱼qwq浪费了大把时间，高数也没好好看😭qwq&lt;/p&gt;
&lt;p&gt;怎么只有我一个人在玩啊😱&lt;/p&gt;
&lt;p&gt;考完后一周到现在一直在玩《是四个字：三个字》游戏qwq，可恶的鹰角居然在我一考完就公厕😭终末地最近毕业了滚回来写代码了😭&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;先做下规划吧😭&lt;/p&gt;
&lt;p&gt;因为放假前就在写网盘，所以蓝山考核应该能更快完成😋，然后再花一周写一下红岩考核吧&lt;/p&gt;
&lt;p&gt;然后就可以往后学学websocket，微服务，gRPC什么的😋在开学前尽量学学吧😋&lt;/p&gt;
&lt;p&gt;不过各位大佬都直接给考核用上这些技术栈了😱我要不要也先学学后面的东西再重构项目啊😱&lt;/p&gt;
&lt;p&gt;不过得留几天时间准备一下高数补考（）之前复习直接摆了&lt;/p&gt;
&lt;p&gt;还好一外给我养的太好了😋英语居然意外拿了个专业第一😋&lt;/p&gt;
&lt;p&gt;接下来又要开始努力了喵，虽然每天还是在玩游戏喵，要似了喵&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;对了&lt;/p&gt;
&lt;p&gt;大佬们的博客都好好看&lt;/p&gt;
&lt;p&gt;我得找个时间把我这个又丑又烂的博客迁移到Astro &amp;amp; Mizuki去，又好看性能又好，还有好多新功能，xm了&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/diary7/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>随笔</category><category>杂项</category></item><item><title>2025回顾/大一上总结</title><link>https://www.claran-blog.work/posts/term1/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/term1/</guid><description>大一上学期回顾与总结.</description><pubDate>Thu, 29 Jan 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;2025过去了，也代表着我的大一上生活结束了&lt;/p&gt;
&lt;p&gt;那么我的大一上，或者说2025，干了啥呢？&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;前半年的苦逼高三先按下不表，高考的目标本来也是邮砖的计科的，结果高考分数比预估的低了很多😭，&lt;br /&gt;还好惆怅之余还是捡漏到了你邮的一个半科班，快哉快哉&lt;/p&gt;
&lt;p&gt;然后的暑假自然也是爽快地玩了三个月&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;之后就到了九月份开学，初入重邮就经历了军训，依旧无所事事&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;到了十月初，红蓝的招新会开始了，原本来重邮就希望能进红蓝（高三时重邮招生宣传办的老师使劲鼓吹），我就去了解了一下&lt;br /&gt;红蓝和各个部门，最后选择了后端开发，在后面选择了学习golang，开始了大学写代码之旅&lt;br /&gt;在这期间，我先是过完了java和go的基础语法内容，然后放弃了java选择了go语言，并搭了一个网站当个人博客用，之后继续学习了go接口和并发，完整地过完了基础&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;十一月，我主要接触并学习了web编程，不得不说初入web相关还是感觉到很困惑和复杂的，要边补全计网基础内容，边明确前后端分工职责，还要学习gin相关新知识&lt;br /&gt;和ai斗智斗勇。&lt;/p&gt;
&lt;p&gt;除此之外，还学了写了jwt，协程池和mysql数据库，并开始写一些最基础的crud项目&lt;/p&gt;
&lt;p&gt;在这个阶段，我也开始结识到了同届的各位大佬-mo神汪神T神（我喜欢你），认识到了相比之下的不足，也感受到了相当的压力&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;十二月的前几天，我粗略地过了一下linux和docker的相关内容后，学习了redis作缓存和一些缓存策略，同时意识到了八股的存在，恐怖如斯&lt;/p&gt;
&lt;p&gt;学习完这些，也就差不多算学完了计划里大一上应该学的内容&lt;/p&gt;
&lt;p&gt;不过照理说我更应该继续往后了解的，不过我放缓了脚步，同时开始写一个网盘crud项目，持续了两周直到期末周到来&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;一月，期末周开始，到考试结束，甚至说到现在，是我最恶堕的时候，打着备战期末的名头没写代码，复习文化课也是摸鱼耍&lt;br /&gt;，高数也没好好学，直接摆烂准备补考&lt;/p&gt;
&lt;p&gt;我忏悔😭😭😭，虽然这个坏习惯大概一辈子也改不掉😭，我可是高中天天，甚至每节课偷偷玩手机，还不写作业的人啊😭&lt;br /&gt;如此安于现状且享乐主义😭我忏悔😭&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;至此一月即将结束，终末地也毕业没了肝的欲望，我终于滚回来继续写代码里&lt;/p&gt;
&lt;p&gt;希望日后蒸蒸日上，寒假规划什么的放在随笔7里了&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;祝好！&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/term1/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>随笔</category><category>杂项</category></item><item><title>随笔.6：被同届小登们吓哭</title><link>https://www.claran-blog.work/posts/diary6/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/diary6/</guid><description>迎来了第一个期末www.</description><pubDate>Thu, 18 Dec 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;之前一直没正经搞过科学上网，只依赖于Watt和一些垃圾加速器翻墙，今天终于搞了个科学上网🥲，终于看到猫神的博客了🤩，tql🤩&lt;/p&gt;
&lt;p&gt;如果我也有幸算个同级小登的话，感觉我是最后面的一个了😱，有童子功大手子T神😋，有25级cyjj猫神🥰，有一周写了1w行代码的全栈(&lt;del&gt;自称不是&lt;/del&gt;)DaWesen大蛇🤩，还有万能大蛇skh🤩，还有很多我还没了解到的隐藏大手子😭&lt;/p&gt;
&lt;p&gt;怎么都这么强😱给大家伙桂霞了😭😭😭&lt;/p&gt;
&lt;p&gt;本来以为跟着蓝山进度走就差不多了😭看来我太天真了😭不行我得赶快追逐大蛇们的脚步😭还得拓展拓展知识面😭&lt;/p&gt;
&lt;p&gt;而且力扣也有段时间没刷了🥲都是我告诉自己不用着急的锅🥲&lt;/p&gt;
&lt;p&gt;在猫神和cyjj博客都看到了这样一句话，简直是人生座右铭的程度口牙😭&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/%E7%8C%AB%E7%A5%9E%E5%8D%9A%E5%AE%A2.png&quot; alt=&quot;猫神博客.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;目前打算先把突发奇想的一个网盘Demo写完，希望大概到月底能弄完吧😭应该能用来当寒假考核作业吧qwq&lt;/p&gt;
&lt;p&gt;然后就得学点新东西了 (虽然写Demo的途中也会学到新东西，但是与真正热爱学习的人比起来相形见绌😭)&lt;/p&gt;
&lt;p&gt;不过也有些比较感兴趣的Demo想写😭到时候再说吧😭&lt;/p&gt;
&lt;p&gt;还有很多东西没学😭希望能来得及吧😭&lt;/p&gt;
&lt;p&gt;就算不说后端啥的😭期末考试又咋办啊😭感觉数学必挂了😭为啥我还要学医学和图学啥的呀😭&lt;/p&gt;
&lt;p&gt;（另外，感觉进度这么慢还写博客啥的有点蠢qwq，在博客上整理笔记只是个人习惯qwq，感觉只有写出来才有那种懂了的感觉qwq）&lt;/p&gt;
&lt;p&gt; &lt;strong&gt;↑&lt;/strong&gt; 经典自己跟自己打架&lt;/p&gt;
&lt;p&gt;认真规划一下，年末把Demo写完，再完善一下之前遗漏的东西（io，dockercompose，yaml，lua，redis限流，ctx啥的），然后再写个小脚本（纯粹自己感兴趣qwq，爬个&lt;del&gt;Pixiv网页&lt;/del&gt;图片啥的 [&lt;del&gt;所以说涩涩是人类第一生产力呢🥲&lt;/del&gt;]）&lt;br /&gt;差不多就到1月第二周，开始准备期末考试的同时也学一下自学大纲里往后的东西，寒假争取能学个半吧🥲&lt;/p&gt;
&lt;p&gt;不过期末考试真能过吗🥲数学咋办啊🥲&lt;/p&gt;
&lt;p&gt;好像把之前的随笔删了🥲&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/diary6/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>随笔</category><category>杂项</category></item><item><title>Docker基础</title><link>https://www.claran-blog.work/posts/docker/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/docker/</guid><description>初步讲解Docker,Dockerfile和Docker-compose.</description><pubDate>Fri, 12 Dec 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-docker-1&quot;&gt;Docker&lt;/h2&gt;
&lt;h3 id=&quot;article-docker是什么-1&quot;&gt;Docker是什么？&lt;/h3&gt;&lt;p&gt;Docker 是一个容器化平台，它可以将应用程序及其所有依赖项打包到一个标准化的、可移植的&quot;容器&quot;中&lt;/p&gt;
&lt;p&gt;容器就像一个轻量级的虚拟机，但更加高效&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;核心特点：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;轻量&lt;/strong&gt;：共享主机操作系统内核，不需要完整操作系统&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;快速&lt;/strong&gt;：秒级启动&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;一致&lt;/strong&gt;：在任何地方运行结果相同&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;隔离&lt;/strong&gt;：应用之间互不干扰&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;可移植&lt;/strong&gt;：&quot;一次构建，处处运行&quot;&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-基础概念-1&quot;&gt;基础概念&lt;/h3&gt;
&lt;h4 id=&quot;article-镜像-image-1&quot;&gt;镜像（image）&lt;/h4&gt;&lt;p&gt;镜像就是将写好的源代码或编译后生成的可执行文件打包后的结果，特点就是可以分发，存储&lt;/p&gt;
&lt;p&gt;docker 的镜像有着自己的储存格式，每个镜像相当于一个 root 的层状文件系统，不仅仅包含了服务程序本身，还包含了程序所有的依赖，例如 python, java 程序需要一个对应的解释器环境&lt;/p&gt;
&lt;p&gt;在 dockerhub (&lt;a href=&quot;https://hub.docker.com/&quot;&gt;https://hub.docker.com/&lt;span&gt;&lt;/span&gt;&lt;/a&gt;) 中储存了很多镜像&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Docker2.png&quot; alt=&quot;Docker2.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-容器-container-1&quot;&gt;容器（Container）&lt;/h4&gt;&lt;p&gt;容器就是镜像实体化执行后的实例，互相隔离&lt;/p&gt;
&lt;p&gt;容器本质上是一个进程及它的子进程等，一个容器基于一个镜像，十分类似面向对象编程中类与对象之间的关系，容器基于镜像产生，当启动一个容器，我们写的服务程序就开始运行了&lt;/p&gt;
&lt;p&gt;容器的生命周期是短暂的，它不像镜像从构建并发布后就可以一直存在。当一个容器被删除，它运行时具有的文件系统会被清理，但它基于的镜像的数据卷不会被删除，所以需要有一个动态变化的数据或者持久化容器内程序的运行结果，要将其放到数据卷内挂载到容器内部，否则容器被删除后文件也会被删除&lt;/p&gt;

&lt;h4 id=&quot;article-仓库-repository-1&quot;&gt;仓库（Repository）&lt;/h4&gt;&lt;p&gt;一个镜像属于一个仓库，可以通过 “仓库名称:镜像tag” 来定位一个具体的镜像&lt;/p&gt;

&lt;h4 id=&quot;article-注册中心-registry-1&quot;&gt;注册中心（Registry）&lt;/h4&gt;&lt;p&gt;一个储存大量仓库的地方，最大的公开 Registry 莫过于 &lt;a href=&quot;https://hub.docker.com/&quot;&gt;&lt;strong&gt;docker hub&lt;/strong&gt;&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-挂载和数据卷-volume-1&quot;&gt;挂载和数据卷（Volume）&lt;/h4&gt;
&lt;h4 id=&quot;article-端口映射-ports-1&quot;&gt;端口映射（ports）&lt;/h4&gt;
&lt;h4 id=&quot;article-环境变量-env-1&quot;&gt;环境变量（ENV）&lt;/h4&gt;
&lt;h3 id=&quot;article-docker的安装-1&quot;&gt;Docker的安装&lt;/h3&gt;
&lt;h4 id=&quot;article-docker-desktop-1&quot;&gt;Docker Desktop&lt;/h4&gt;
&lt;h4 id=&quot;article-docker-engine-1&quot;&gt;Docker Engine&lt;/h4&gt;
&lt;h3 id=&quot;article-docker的使用-1&quot;&gt;Docker的使用&lt;/h3&gt;
&lt;h4 id=&quot;article-工作流程-1&quot;&gt;工作流程&lt;/h4&gt;
&lt;h5 id=&quot;article-拉取镜像-1&quot;&gt;拉取镜像&lt;/h5&gt;
&lt;h5 id=&quot;article-创建镜像-1&quot;&gt;创建镜像&lt;/h5&gt;&lt;p&gt;见下文Dockerfile内容&lt;/p&gt;

&lt;h5 id=&quot;article-操作容器-1&quot;&gt;操作容器&lt;/h5&gt;
&lt;h5 id=&quot;article-数据管理-1&quot;&gt;数据管理&lt;/h5&gt;
&lt;h5 id=&quot;article-端口映射和容器互联-1&quot;&gt;端口映射和容器互联&lt;/h5&gt;
&lt;h4 id=&quot;article-常用指令-1&quot;&gt;常用指令&lt;/h4&gt;
&lt;h3 id=&quot;article-docker的底层原理和核心技术-1&quot;&gt;Docker的底层原理和核心技术&lt;/h3&gt;
&lt;h4 id=&quot;article-namespace-1&quot;&gt;Namespace&lt;/h4&gt;
&lt;h4 id=&quot;article-cgroups-1&quot;&gt;CGroups&lt;/h4&gt;
&lt;h4 id=&quot;article-unionfs-1&quot;&gt;UnionFS&lt;/h4&gt;
&lt;h2 id=&quot;article-dockerfile-1&quot;&gt;Dockerfile&lt;/h2&gt;
&lt;h2 id=&quot;article-docker-compose-1&quot;&gt;docker-compose&lt;/h2&gt;&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/docker/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>工具</category><category>后端</category><category>linux</category></item><item><title>基医期末复习</title><link>https://www.claran-blog.work/posts/text-basic-m/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/text-basic-m/</guid><description>期末复习-基础医学概论.</description><pubDate>Fri, 12 Dec 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;孩子们我回来了&lt;/p&gt;
&lt;p&gt;前面几周一直在写ClaranCloudDisk，现在打算先停住寒假再写&lt;/p&gt;
&lt;p&gt;不好孩子们，下周一就要考基医了孩子们，再不复习就要炸缸了&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;风好大，好凉快，大地在上升&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/%E9%BC%A0%E9%BC%A0%E8%B7%B3%E6%A5%BC.jpg&quot; alt=&quot;鼠鼠跳楼.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;孩子们，一起来复习基医吧&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/%E9%BB%84%E9%87%91%E7%9F%BF%E5%B7%A5%E6%8D%9E%E4%BA%BA.jpg&quot; alt=&quot;黄金矿工捞人.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-pre-1&quot;&gt;Pre&lt;/h2&gt;&lt;p&gt;基础：高中生物知识 --&amp;gt; 非常重要，不然医学学着学着还要恶补高中知识&lt;/p&gt;

&lt;h2 id=&quot;article-main-1&quot;&gt;Main&lt;/h2&gt;
&lt;h3 id=&quot;article-绪论-1&quot;&gt;绪论&lt;/h3&gt;&lt;p&gt;冠状面/额状面/冠状轴：将人体分为前后的面/轴&lt;/p&gt;
&lt;p&gt;矢状面/矢状轴：将人体分为左右的面/轴&lt;/p&gt;
&lt;p&gt;水平面/垂直轴：请输入文本&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/%E4%BA%BA%E4%BD%93%E5%89%96%E9%9D%A2%E5%9B%BE.jpg&quot; alt=&quot;人体剖面图.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;入体最主要调节方式：神经调节&lt;/p&gt;
&lt;p&gt;神经调节的基本调节方式：反射 (详情见高中生物)&lt;/p&gt;
&lt;p&gt;急性离体实验：急性指短时，离体rt，常见例子为&lt;strong&gt;神经不应期的测定&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;激素分泌：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;远距分泌：血液运输&lt;/li&gt;
&lt;li&gt;旁分泌：外液扩散&lt;/li&gt;
&lt;li&gt;自分泌：rt，如肿瘤细胞&lt;/li&gt;
&lt;li&gt;神经分泌：请输入文本&lt;/li&gt;
&lt;li&gt;（非激素传递方式）突触分泌：神经递质&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;解剖学姿势：&lt;strong&gt;身体直立，面向前方，双眼平视，两足并拢，足尖向前，双上肢下垂于躯干两侧，手掌向前&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;孩子们，周一我就复习了这么一点，我真是fvv😭😭😭mmM&lt;/p&gt;
&lt;p&gt;孩子们我回来了，现在是2026.1.4-22:27，主包才发现电脑忘带电源适配器了&lt;/p&gt;
&lt;p&gt;今天拼尽全力复习一天，终于战胜6个章节，还剩7个章节怎么办😭😭😭&lt;/p&gt;

&lt;h3 id=&quot;article-第一章-1&quot;&gt;第一章&lt;/h3&gt;&lt;p&gt;随意肌/骨骼肌/横纹肌：能通过意识主动控制的肌肉&lt;/p&gt;
&lt;p&gt;原发性主动转运：直接消耗atp&lt;/p&gt;
&lt;p&gt;继发性主动转运：简介消耗atp，利用其他物质的顺浓度梯度差转运，可逆浓度转运&lt;/p&gt;
&lt;p&gt;易化扩散：不可逆浓度&lt;/p&gt;
&lt;p&gt;结缔组织：包括喜报，纤维和基质，继续包括&lt;strong&gt;骨组织，软骨组织，脂肪组织，血液，韧带&lt;/strong&gt;等&lt;/p&gt;
&lt;p&gt;结缔组织的特点：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;细胞间质多，由细丝状的纤维、基质组成&lt;/li&gt;
&lt;li&gt;细胞数量少，但种类多，无极性&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;上皮组织的特点：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;成分多，间质少&lt;/li&gt;
&lt;li&gt;有记性，分游离面和基底面&lt;/li&gt;
&lt;li&gt;无血管、神经末梢丰富&lt;/li&gt;
&lt;li&gt;有基膜&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-第四章-1&quot;&gt;第四章&lt;/h3&gt;&lt;p&gt;动作电位：“全或无”，短暂，可逆，可扩步&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/%E7%BB%86%E8%83%9E%E8%86%9C%E6%BF%80%E5%8C%96.jpg&quot; alt=&quot;细胞膜激化.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;去极化：-70mV -&amp;gt; -50mV&lt;/p&gt;
&lt;p&gt;超级化：-70mV -&amp;gt; -90mV&lt;/p&gt;
&lt;p&gt;兴奋：去极化（超常期） -&amp;gt; 复极化 -&amp;gt; 超级化（低常期） -&amp;gt; 恢复&lt;/p&gt;
&lt;p&gt;郎飞结：有髓神经末梢轴突外未被髓鞘包裹的区域，信号在郎飞结间跳跃传递，因此传导速度更快，离子跨膜移动总数更低，耗能更低，不衰减扩步&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/%E8%82%8C%E8%82%89%E7%BB%93%E6%9E%84.jpg&quot; alt=&quot;肌肉结构.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;肌小节：肌肉基本单位&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;暗带（A带）：由粗肌丝（含肌球蛋白）和细肌丝（部分）组成&lt;/li&gt;
&lt;li&gt;明带（I带）：有细肌丝（含肌动蛋白）组成&lt;/li&gt;
&lt;li&gt;H区：A带中的一部分。仅由粗肌丝再一次&lt;/li&gt;
&lt;li&gt;Z线：分隔肌小节的单位&lt;/li&gt;
&lt;li&gt;M线：H区中央固定粗肌丝的结构&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/%E5%AD%A3%E5%B0%8F%E5%A7%90.jpg&quot; alt=&quot;季小姐.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/%E5%AD%A3%E5%B0%8F%E5%A7%902.jpg&quot; alt=&quot;季小姐2.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;&lt;strong&gt;（✨重点！）滑行学说：&lt;/strong&gt;&lt;br /&gt;肌肉收缩时，细肌丝向肌小节中央M线方向滑行，使肌小节缩短&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;在这之中，只有细肌丝移动，粗肌丝不移动，细肌丝向M先移动，因此明带缩短，暗带不变&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/%E6%9C%BA%E4%B8%80%E5%8A%A8%E7%90%86%E8%AE%BA.jpg&quot; alt=&quot;机一动理论.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;横管：肌膜上凹进去的部分，负责信号更深层次的传递&lt;/p&gt;
&lt;p&gt;纵管：肌浆网，类内质网的膜系统，负责存储的调节钙离子浓度&lt;/p&gt;
&lt;p&gt;终末池：纵管衍生膨大的部分&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;✨三联管：&lt;/strong&gt;&lt;br /&gt;由 终末池+横管+终末池 组成&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/%E4%B8%89%E8%81%94%E4%BD%93.jpg&quot; alt=&quot;三联体.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;横桥：肌球蛋白上可以与肌动蛋白位点结合，并拉动细肌丝与“横桥周期”的结构，多次重复上述过程可以形成肌肉滑动收缩&lt;/p&gt;
&lt;p&gt;肌肉收缩的终极原理：&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/%E6%9C%BA%E4%B8%80%E5%8A%A8.jpg&quot; alt=&quot;机一动.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/%E8%82%8C%E8%82%89%E6%BF%80%E5%8A%B1.jpg&quot; alt=&quot;肌肉激励.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;抗重力肌群：如图&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/%E6%8A%97%E9%87%8D%E5%8A%9B%E8%82%8C%E7%BE%A4.jpg&quot; alt=&quot;抗重力肌群.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;锥体系：如图&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/%E9%94%A5%E4%BD%93%E7%B3%BB.jpg&quot; alt=&quot;锥体系.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;Ach：乙酰胆碱&lt;/p&gt;

&lt;h3 id=&quot;article-第五章-神经系统-1&quot;&gt;第五章：神经系统&lt;/h3&gt;&lt;p&gt;脊髓：中心有纵行的中央管，中央管的周围是灰质，白质位于脊髓的周围部分&lt;/p&gt;
&lt;p&gt;神经核：中枢神经系统中相似的神经元包体和树突集中为灰质团块的结构&lt;/p&gt;
&lt;p&gt;神经节：与神经核的区别为属于“周围神经系统”&lt;/p&gt;
&lt;p&gt;EPSP：兴奋性突触后电位：突触间兴奋效果&lt;/p&gt;
&lt;p&gt;IPSP：抑制性突触后电位：抑制效果&lt;/p&gt;
&lt;p&gt;特异性投射系统&amp;amp;非特异性投射系统：精准投射（或不精准泛射）于大脑皮层以造成精确操作的&lt;/p&gt;
&lt;p&gt;脑干：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;延髓：心血管运动中枢+呼吸中枢&lt;/li&gt;
&lt;li&gt;脑桥：链接上鞋+睡眠调节&lt;/li&gt;
&lt;li&gt;中脑：视觉和听觉反射的初级中枢&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;脊休克：请输入文本，脊髓与高位中枢断离，肌张力下降或消失，血管扩张，血压下降，反射消失等，会慢慢恢复&lt;/p&gt;
&lt;p&gt;第一信号：具体事务&lt;/p&gt;
&lt;p&gt;第二信号：抽象事物，人类特征，如文字等&lt;/p&gt;
&lt;p&gt;神经元联系方式：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;环状式联系：一个神经元通过中间神经元，最终由返回自我影响的活动，用于后发放和反馈调节&lt;/li&gt;
&lt;li&gt;单线式联系：链表&lt;/li&gt;
&lt;li&gt;辐散式联系：一对多&lt;/li&gt;
&lt;li&gt;聚合式联系：多对一，总和的结构基础&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;几茶酚胺类：多巴胺，贤上腺素，去甲肾上腺素&lt;/p&gt;
&lt;p&gt;在感神经节后纤维的递质是：Ach&lt;/p&gt;
&lt;p&gt;小脑：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;绒球小结叶：调节身体平衡&lt;/li&gt;
&lt;li&gt;小脑前叶：调节肌张力&lt;/li&gt;
&lt;li&gt;小脑后叶：随意运动&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;间脑：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;背侧丘脑：皮质下高级感觉中枢&lt;/li&gt;
&lt;li&gt;下丘脑：内脏活动和内分泌&amp;amp;情绪调节中枢&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;以下属于胆碱能受体的是：M，N1，N2&lt;/p&gt;
&lt;p&gt;脊髓&amp;amp;神经：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;本体感觉和精细触觉通路：同侧，上行&lt;/li&gt;
&lt;li&gt;痛觉与温度觉通路：对侧，交叉，上行&lt;/li&gt;
&lt;li&gt;随意运动通路：对侧，交叉，下行&lt;blockquote&gt;
&lt;p&gt;用于解决脊髓半截断相关题目&lt;/p&gt;
&lt;/blockquote&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;α-运动神经元：支配梭外肌纤维&lt;/p&gt;
&lt;p&gt;γ-运动神经元：支配梭内肌纤维&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Spec：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;支配肾上腺髓质的交感神经不需要换元&lt;/li&gt;
&lt;li&gt;绝大部分交感神经的节后纤维属于肾上腺素神经&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;视觉皮层代表区位于：枕叶距状裂（wtf？）&lt;/p&gt;
&lt;p&gt;大脑皮层投射区：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;中央前回：初级运动&lt;/li&gt;
&lt;li&gt;中央后回：躯体感觉&lt;/li&gt;
&lt;li&gt;枕叶皮层：视觉&lt;/li&gt;
&lt;li&gt;皮层边缘：边缘系统：情绪，记忆，内脏...&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;腱器官抑制肌梭&lt;/p&gt;
&lt;p&gt;肌梭引起牵张反射&lt;/p&gt;
&lt;p&gt;游离神经末梢：痛觉&lt;/p&gt;
&lt;p&gt;认得基本生命中枢位于：延髓&lt;/p&gt;
&lt;p&gt;摄食中枢位于：丘脑&lt;/p&gt;
&lt;p&gt;简述感觉传导通路：&lt;br /&gt;脊神经节 --（脊髓）-- 延髓 -- 内侧丘系 --（对侧）-- 丘脑 -- 大脑皮层&lt;/p&gt;

&lt;h3 id=&quot;article-第六章-感觉系统-1&quot;&gt;第六章：感觉系统&lt;/h3&gt;&lt;p&gt;请输入文本，最简单的一集&lt;/p&gt;
&lt;p&gt;懒得写了，直接拍笔记吧&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/1.jpg&quot; alt=&quot;1.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/2.jpg&quot; alt=&quot;2.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-第九章-循环系统-1&quot;&gt;第九章：循环系统&lt;/h3&gt;&lt;p&gt;最难的一集&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/3.jpg&quot; alt=&quot;3.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/img/%E5%9F%BA%E5%8C%BB/4.jpg&quot; alt=&quot;4.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;孩子们，我还没复习完，只复习到这里😭😭😭&lt;/p&gt;
&lt;p&gt;还有4章😭😭😭&lt;/p&gt;
&lt;p&gt;我去了孩子们，我的资料是老版本的，又多了3章没复习😭😭😭&lt;/p&gt;
&lt;p&gt;怎么办孩子们😭😭😭明天下午一点考试😭😭😭现在是晚上十一点半😭😭😭&lt;/p&gt;
&lt;p&gt;明早起来在草草地看两章吧😭😭😭给他就是了😭😭😭&lt;/p&gt;

&lt;h3 id=&quot;article-其他-1&quot;&gt;其他&lt;/h3&gt;&lt;p&gt;孩子们我看完了（其实还有两章没看）！&lt;/p&gt;
&lt;p&gt;但是没时间归档到blog上了，不搞了！&lt;/p&gt;

&lt;h2 id=&quot;article-end-1&quot;&gt;End&lt;/h2&gt;&lt;p&gt;哈哈哈哈哈孩子们我考完了！太几把简单了哈哈哈！感谢老师！！！&lt;/p&gt;
&lt;p&gt;挂科已然成为不可能之事！！！&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/text-basic-m/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>随笔</category><category>杂项</category></item><item><title>走进缓存：Redis、缓存策略和常见缓存问题</title><link>https://www.claran-blog.work/posts/go-redis/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-redis/</guid><description>学习Redis缓存基础和常用缓存策略.</description><pubDate>Tue, 09 Dec 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-非关系型数据库概述-1&quot;&gt;非关系型数据库概述&lt;/h2&gt;&lt;p&gt;关系型数据库的优势在于数据的规范性和严格的表格结构，但这也使得它在某些场景下变得不够灵活，尤其是在面对大规模数据、高并发请求和复杂数据结构时，会面临性能瓶颈&lt;/p&gt;
&lt;p&gt;与此相对，非关系型数据库摒弃了传统的表格结构，通常具有更灵活的数据存储方式，并且能够根据实际需求进行扩展，尤其适合处理大数据量和快速读写的场景&lt;/p&gt;
&lt;p&gt;常见的非关系型数据库包括：Redis、MongoDB等&lt;/p&gt;

&lt;h2 id=&quot;article-redis-1&quot;&gt;Redis&lt;/h2&gt;
&lt;h3 id=&quot;article-意义-1&quot;&gt;意义&lt;/h3&gt;&lt;p&gt;如果只使用MySQL之类的关系型数据库，承载不了过大的访问量，过大的访问量会对数据库产生过大压力，导致业务出现问题&lt;/p&gt;
&lt;p&gt;在 web 开发里面，为了解决这个问题，我们也引入了&lt;strong&gt;缓存&lt;/strong&gt;的概念。缓存的作用是将数据存储在访问速度更快的内存中，当请求访问这些数据时，直接从内存中读取，避免频繁访问磁盘和数据库，从而大大提高性能。&lt;/p&gt;
&lt;p&gt;Redis 是一种高性能的内存数据存储系统，它是一个 NoSQL 数据库，广泛用于缓存场景。通过 Redis，我们可以将数据库中频繁访问的数据缓存起来，从而减少数据库压力，提高响应速度。&lt;/p&gt;

&lt;h3 id=&quot;article-基础概念-1&quot;&gt;基础概念&lt;/h3&gt;&lt;p&gt;Redis 有着以下的特性，决定了他天生适合当作分布式缓存中间件使用：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;键值对存储&lt;/strong&gt;：Redis 是一个键值对存储数据库，可以将数据以键值对的形式存储在内存中，支持各种类型的数据结构，如字符串、哈希、列表、集合等。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;内存存储&lt;/strong&gt;：Redis 将数据存储在内存中，这使得它的读写速度极快，远超传统的磁盘数据库。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;持久化选项&lt;/strong&gt;：虽然 Redis 主要作为内存数据库，但它也提供了持久化机制，可以定期将数据保存到磁盘上，以防数据丢失。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;高可用性&lt;/strong&gt;：Redis 支持主从复制、分区、哨兵等机制，能够实现高可用的分布式架构。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-数据结构和命令-1&quot;&gt;数据结构和命令&lt;/h3&gt;&lt;p&gt;先连接 redis&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;redis-cli&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -h&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; localhost&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -p&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 6379&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -a&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;passwor&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;d&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;如果是 docker 部署，需要先进入要 redis 容器里：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;docker&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; exec&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; -it&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; redis&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; /bin/bash&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h5 id=&quot;article-1-string-1&quot;&gt;1. String&lt;/h5&gt;&lt;p&gt;字符串，最基本的类型，可以存储任何数据，例如文本或数字。命令如下：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;SET [key] [value]&lt;/code&gt;：添加或修改一个已有的 String 类型的键值对。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;GET [key]&lt;/code&gt;：根据 key 获取 String 类型的 value。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;MSET [key1 value1] [key2 value2] ...&lt;/code&gt;：批量添加多个 String 类型的键值对。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;MGET [key1] [key2] ...&lt;/code&gt;：根据多个 key 获取多个 String 类型的 value。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;INCR [key]&lt;/code&gt;：让一个整型的 key 自增 1。（对应的有 DECR）&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;INCRBY [key] [increment]&lt;/code&gt;：让一个整型的 key 自增并指定步长，例如 &lt;code&gt;INCRBY num 2&lt;/code&gt; 让 num 值自增 2。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;INCRBYFLOAT [key] [increment]&lt;/code&gt;：让一个浮点类型的数字自增并指定步长。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;SETNX [key] [value]&lt;/code&gt; 或 &lt;code&gt;SET [key] [value] NX&lt;/code&gt;：添加一个 String 类型的键值对，前提是这个 key 不存在，否则不执行。（分布式锁）&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;SETEX [key] [seconds] [value]&lt;/code&gt; 或 &lt;code&gt;SET [key] EX [value]&lt;/code&gt;：添加一个 String 类型的键值对，并且指定有效期（单位：秒）。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;blockquote&gt;
&lt;p&gt;缓存如何存储 MySQL 里面的结构化数据呢？&lt;/p&gt;
&lt;p&gt;其实很简单，我们 MySQL 里面的一行数据其实对应到 Go 里面就是一个结构体，那么我们可以对这个结构体进行序列化成一个字符串，这样就能当作 json 字符串存储到 string 中&lt;/p&gt;
&lt;p&gt;当然这样也有一个弊端，那就是无法灵活修改 string 的成员，下面的数据类型可以帮我们克服这一点。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr /&gt;

&lt;h5 id=&quot;article-2-hash-1&quot;&gt;2. Hash&lt;/h5&gt;&lt;p&gt;哈希类型，可以理解为 Go 语言里面的 map，虽然可能会觉得 redis 本身就是一个 kv 数据库，里面还有一个 kv 类型很奇怪，但是这是必要的，一个 key 的 value 就是所谓的 map，可以理解为key里面又存储了多个key的键值对，相较于上面 json 字符串形式存储数据有着一定的优势，那就是对 json 字符串中的单个数据进行修改很不方便，而 hash 类型则可以对单个字段进行 CRUD。&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;key&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── field1: value1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── field2: value2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;└── field3: value3&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;HSET [key] [field1] [value1] [field2] [value2] ...&lt;/code&gt;：添加或修改 hash 类型 key 的 field 的值。注：hmset也行，不过已经弃用了.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;HGET [key] [field]&lt;/code&gt;：获取 hash 类型 key 的 field 的值。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;HMGET [key] [field1] [field2] ...&lt;/code&gt;：批量获取多个 field 的值。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;HGETALL [key]&lt;/code&gt;：获取 key 中的所有 field 和 value。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;HKEYS [key]&lt;/code&gt;：获取 key 中的所有 field。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;HVALS [key]&lt;/code&gt;：获取 key 中的所有 value。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;HINCRBY [key] [field] [increment]&lt;/code&gt;：让指定 field 值增加指定步长。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;HSETNX [key] [field] [value]&lt;/code&gt;：添加 field 的值，前提是 field 不存在，否则不执行。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;

&lt;h5 id=&quot;article-3-list-1&quot;&gt;3. List&lt;/h5&gt;&lt;p&gt;可以看作是一个双向队列，但是查询速度 O(N)，原因在他的底层设计，为了节省内存，所以不支持下标查询，下面是他的命令：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;LPUSH [key] [element] ...&lt;/code&gt;：向列表左侧插入一个或多个元素。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;LPOP [key]&lt;/code&gt;：移除并返回列表左侧第一个元素，没有则返回 nil。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;RPUSH [key] [element] ...&lt;/code&gt;：向列表右侧插入一个或多个元素。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;RPOP [key]&lt;/code&gt;：移除并返回列表右侧第一个元素。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;LRANGE [key] [start] [end]&lt;/code&gt;：返回指定范围内的所有元素。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;BLPOP [key] [timeout]&lt;/code&gt;：在没有元素时等待指定时间，然后返回列表左侧元素。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;BRPOP [key] [timeout]&lt;/code&gt;：在没有元素时等待指定时间，然后返回列表右侧元素。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;

&lt;h5 id=&quot;article-4-set-1&quot;&gt;4. Set&lt;/h5&gt;&lt;p&gt;相当于C++的 &lt;code&gt;unordered_set&lt;/code&gt; 或者 Java 的 &lt;code&gt;HashSet&lt;/code&gt;，可以用于查看共同好友等，底层使用哈希表实现，&lt;br /&gt;之存储成员，并不是k-v型数据类型，特点是无序，元素不可重复，查找快，支持交集并集这些功能&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;SADD [key] [member] ...&lt;/code&gt;：向 set 中添加一个或多个元素。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;SREM [key] [member] ...&lt;/code&gt;：移除 set 中的指定元素。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;SCARD [key]&lt;/code&gt;：返回 set 中元素的个数。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;SISMEMBER [key] [member]&lt;/code&gt;：判断元素是否存在于 set 中。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;SMEMBERS [key]&lt;/code&gt;：获取 set 中的所有元素。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;SINTER [key1] [key2] ...&lt;/code&gt;：求 key1 与 key2 的交集。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;SDIFF [key1] [key2] ...&lt;/code&gt;：求 key1 与 key2 的差集。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;SUNION [key1] [key2] ...&lt;/code&gt;：求 key1 和 key2 的并集。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;

&lt;h5 id=&quot;article-5-sortedset-1&quot;&gt;5. SortedSet&lt;/h5&gt;&lt;p&gt;有序集合，其实就是给上面 Set 的 member 换成 Key-Value 的形式，也就是 Key 为元素，Value 为数值，按照 Value 进行排序，可以实现排行榜之类的功能，常见命令如下：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;ZADD [key] [score] [member]&lt;/code&gt;：添加或更新元素的 score 值。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;ZREM [key] [member]&lt;/code&gt;：删除元素。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;ZSCORE [key] [member]&lt;/code&gt;：获取元素的 score 值。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;ZRANK [key] [member]&lt;/code&gt;：获取元素的升序排名。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;ZCARD [key]&lt;/code&gt;：获取元素数量。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;ZCOUNT [key] [min] [max]&lt;/code&gt;：统计 score 在指定范围内的元素个数。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;ZINCRBY [key] [increment] [member]&lt;/code&gt;：让元素 score 增加指定值。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;ZRANGE [key] [min] [max]&lt;/code&gt;：按升序获取指定排名范围的元素。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;ZREVRANGE [key] [min] [max]&lt;/code&gt;：按降序获取指定排名范围的元素。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;ZRANGEBYSCORE [key] [min] [max]&lt;/code&gt;：按 score 获取指定范围的元素。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;code&gt;ZDIFF&lt;/code&gt;、&lt;code&gt;ZINTER&lt;/code&gt;、&lt;code&gt;ZUNION&lt;/code&gt;：求差集、交集、并集。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-其他-1&quot;&gt;其他&lt;/h5&gt;&lt;p&gt;其他的数据结构并不算基本的数据结构类型：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;bitmap&lt;/strong&gt;：底层使用 String 类型实现，其实就是一个位图，每一位只需要 1 bit，占用非常小，很适合用于存储文章阅读，签到状况这些数据。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Geo&lt;/strong&gt;：底层使用 SortedSet 实现，用于表示经纬度，如果想要找方圆距离多少的数据，就可以用他，本质是将经纬度对应成分数来打分排行的。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Stream&lt;/strong&gt;：算是一个新加入的数据结构，用于实现消息队列，但是本身功能并不多，所以大多数人还是会使用专门的消息队列。&lt;/li&gt;
&lt;/ol&gt;

&lt;h5 id=&quot;article-redis-中键的设计规范-1&quot;&gt;Redis 中键的设计规范&lt;/h5&gt;&lt;p&gt;由于Redis中没有表这一结构，于是我们会需要key按照 &lt;code&gt;项目名:业务名:类型:主键id&lt;/code&gt; 的方式命名，但并不固定，比如mysql里面的shopping库中的goods表的id为1的数据的 key 可以表示为 &lt;code&gt;shopping:goods:1&lt;/code&gt;，而这一个 key 对应的 value 可以是结构体（对象）序列化后的 json 字符串,这里值得一提的是，如果你用的 &lt;code&gt;RDM&lt;/code&gt; 的 redis 图形化界面，这样的命名在图形化界面里面会以&lt;strong&gt;树&lt;/strong&gt;的形式出现，显示很清晰，但是 &lt;code&gt;Datagrip&lt;/code&gt; 这类软件貌似并不支持这个功能。&lt;/p&gt;

&lt;h3 id=&quot;article-go-redis-1&quot;&gt;go-redis&lt;/h3&gt;&lt;p&gt;go 里面既然有 gorm 可以操作 MySQL，那么 go 里面也有一个库可以帮助我们去操作 redis&lt;/p&gt;
&lt;p&gt;我们可以通过&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Bash&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;go&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; get&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; github.com/redis/go-redis/v9&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;去获取这个包，然后就可以在 go 里面愉快的操作 redis 了&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;基本命令请看官方教程：&lt;a href=&quot;https://redis.ac.cn/docs/latest/develop/clients/go/&quot;&gt;API使用教程&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;示例代码：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;context&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/redis/go-redis/v9&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Character&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Name         &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `redis:&quot;Name&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Profession   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `redis:&quot;Profession&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Cost         &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `redis:&quot;Cost&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Favorability &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    `redis:&quot;Favorability&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	client &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; redis.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewClient&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;redis&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Options&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Addr:         &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;localhost:6379&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Password:     &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		DB:           &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,               &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// DB_ID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Protocol:     &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,               &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 使用 Redis 协议版本 2（默认，最常用） - Protocol: 0 表示自动选择&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		PoolSize:     &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,             &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 连接池大小&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		MinIdleConns: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,              &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 最小空闲连接数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		DialTimeout:  &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 连接超时&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		ReadTimeout:  &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 读取超时&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		WriteTimeout: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 写入超时&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ctx &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; context.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Background&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 连接测试&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	pong, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Ping&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		panic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;连接 Redis 失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Redis 连接成功:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, pong)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;==================================== Lab1 =======================================&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Set&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Elaina&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;The ashen witch&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Err&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 没有.Err()就不返回err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;set failed: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err1)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	val, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Get&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Elaina&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// .Result()可以返回值，也可用于Set，用于Set时返回操作结果（Ok）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;get failed: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, val)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;==================================== Lab2 =======================================&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	hashField &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;Name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Amiya&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;Profession&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Healthier&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;Cost&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;15&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;Favorability&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;200&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resSet, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HSet&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Character:1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, hashField).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;hset failed: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, resSet) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// -&amp;gt; 4 , k-v量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resName, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HGet&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Character:1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;hget failed: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, resName) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// -&amp;gt; Amiya&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resProf, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HGet&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Character:1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Profession&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;hget failed: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, resProf) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// -&amp;gt; Healthier&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resCost, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HGet&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Character:1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Cost&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;hget failed: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, resCost) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// -&amp;gt; 15&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resFav, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HGet&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Character:1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Favorability&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;hget failed: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, resFav) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// -&amp;gt; 200&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	resCharacter, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HGetAll&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Character:1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;hget failed: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, resCharacter) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// -&amp;gt; map[Cost:15 Favorability:200 Name:Amiya Profession:Healthier]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;==================================== Lab3 =======================================&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; Info &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Character&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; client.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HGetAll&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ctx, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Character:1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scan&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Info) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 绑定Redis-Hash到结构体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;hget failed: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Name: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%13s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;Profession:   &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%8s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;Cost: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%10d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;Favorability: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, Info.Name, Info.Profession, Info.Cost, Info.Favorability)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-缓存-1&quot;&gt;缓存&lt;/h2&gt;&lt;p&gt;学习完了Redis基础，接下来该了解Redis如何在项目中作缓存了&lt;/p&gt;

&lt;h3 id=&quot;article-缓存基础-1&quot;&gt;缓存基础&lt;/h3&gt;&lt;p&gt;我常用的Redis缓存策略通常包含两种类型：写入数据时和读取数据时的操作&lt;/p&gt;

&lt;h4 id=&quot;article-写入数据-1&quot;&gt;写入数据&lt;/h4&gt;&lt;p&gt;写入数据时：使用&lt;code&gt;写后删除 + TTL&lt;/code&gt;策略&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;直接写入数据库&lt;/li&gt;
&lt;li&gt;删除缓存，等待下一次读取时再写入缓存&lt;/li&gt;
&lt;/ol&gt;
&lt;hr /&gt;
&lt;p&gt;为什么要使用&lt;code&gt;写后删除 + TTL&lt;/code&gt;策略？&lt;/p&gt;
&lt;p&gt;我们日常使用 Redis 大多是用作缓存，问题来了，我们第一次读取 MySQL 数据的时候，希望将这个数据缓存到 Redis 中，之后的读取就全是使用 Redis 来读取了，那么当有没有 Redis 中缓存的数据与 MySQL 的数据不一致的时候呢？当我们需要写数据的时候，我们肯定需要去写 MySQL 了，那么 Redis 中的数据应该如何处理呢？你们可能觉得很简单，直接修改 Redis 里面的数据不就行了？大多数人最开始做缓存策略可能都是这样做的，但是这样其实还是会导致不一致的问题：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;请求1：写 MySQL&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;请求2：写 MySQL&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;请求2：更新 redis 缓存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;请求1：更新 redis 缓存&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;如果出现上面这种情况，那么就会导致缓存和数据库的数据不一致，在平常自己测试的时候可能很难发现，但是并发度上来了，这种问题就会非常明显。&lt;/p&gt;
&lt;p&gt;所以最常见，最简单的做法是写后删除，也就是写完 MySQL 的数据之后，删除 redis 中的数据，缺点是之后又需要重新访问数据库来重建缓存（但是可以用 &lt;a href=&quot;https://zhuanlan.zhihu.com/p/382965636&quot;&gt;singleflight&lt;span&gt;&lt;/span&gt;&lt;/a&gt; 来优化一下）这种情况也有很小的情况会引起数据不一致，如果当时 Redis 没有缓存数据时：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;请求1：读请求，发现 Redis 没有数据，读 MySQL&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;请求2：写 MySQL&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;请求2：删除 Redis 缓存&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;请求1：重建 redis 缓存&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;虽然也会导致不一致，但是概率很小，所以实际上大多数人都是直接用的写后删除策略 + 合适的 TTL，那么有没有完全避免数据不一致的策略呢？是有的，据我所知：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;延迟双删：写后先删除一遍，然后过一段时间又删除一遍，当然，实现起来比较复杂，依赖了延迟这段时间，语义上防止比当前写请求还旧的读请求还残留在请求路径上。&lt;/li&gt;
&lt;li&gt;版本号机制：实现起来比较简单，使用单调增的版本号来防止读旧数据，每次写 MySQL 都将版本号写回到 Redis，这个版本号由于单调增的机制，不会出现旧数据覆盖新数据的情况，所以可以放心写，这样就不用担心旧数据的情况了。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;上面还提到了重建缓存是有一定开销的，可以想象一下，在短时间内访问量比较大的时候，如果此时 Redis 中还没有缓存，那么就会有多个请求尝试去重建缓存，这里就会引起不必要的开销，因为实际上我们只需要有一个请求去重建缓存就可以了，剩下的只需要等待，这里就是典型的狗堆效应的问题，最简单的方法就是加锁，分布式场景下就用分布式锁，我之前看见个博客讲的挺好的，现在找不到了，还有个优化策略就是用上述的 singleflight&lt;/p&gt;
&lt;hr /&gt;

&lt;h4 id=&quot;article-读取数据-1&quot;&gt;读取数据&lt;/h4&gt;&lt;p&gt;在读取数据时采用以下策略：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;线尝试直接从缓存中读取&lt;/li&gt;
&lt;li&gt;缓存未命中，查询数据库&lt;/li&gt;
&lt;li&gt;写入缓存（分布式锁防止击穿）&lt;/li&gt;
&lt;/ol&gt;

&lt;h3 id=&quot;article-缓存击穿-缓存雪崩和缓存穿透-1&quot;&gt;缓存击穿、缓存雪崩和缓存穿透&lt;/h3&gt;
&lt;h4 id=&quot;article-缓存击穿-1&quot;&gt;缓存击穿&lt;/h4&gt;&lt;p&gt;单个热点key在缓存中过期，此时有大量并发请求访问这个key，所有请求瞬间穿透到数据库，导致数据库压力激增。&lt;/p&gt;
&lt;p&gt;解决方案：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;互斥锁（Mutex Lock）&lt;/li&gt;
&lt;li&gt;分布式锁（Redis SetNX） （常用）&lt;/li&gt;
&lt;li&gt;singleflight（Go 官方库）&lt;/li&gt;
&lt;li&gt;热点数据永不过期&lt;/li&gt;
&lt;/ol&gt;

&lt;h4 id=&quot;article-缓存雪崩-1&quot;&gt;缓存雪崩&lt;/h4&gt;&lt;p&gt;大量缓存key在同一时间过期，导致大量请求同时穿透到数据库，数据库压力瞬间激增甚至宕机&lt;/p&gt;
&lt;p&gt;解决方案：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;随机过期时间 （常用）&lt;/li&gt;
&lt;li&gt;分级缓存&lt;/li&gt;
&lt;li&gt;缓存预热 + 定时刷新&lt;/li&gt;
&lt;li&gt;服务降级和熔断&lt;/li&gt;
&lt;/ol&gt;

&lt;h4 id=&quot;article-缓存穿透-1&quot;&gt;缓存穿透&lt;/h4&gt;&lt;p&gt;查询一个数据库中不存在的数据，导致每次请求都穿透缓存直接查询数据库。如果被恶意攻击，大量请求不存在的数据，会导致数据库压力过大&lt;/p&gt;
&lt;p&gt;解决方案：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;缓存空值（常用）&lt;/li&gt;
&lt;li&gt;布隆过滤器（Bloom Filter）&lt;/li&gt;
&lt;li&gt;参数校验和过滤&lt;/li&gt;
&lt;/ol&gt;

&lt;h4 id=&quot;article-总结-1&quot;&gt;总结&lt;/h4&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;问题&lt;/th&gt;
&lt;th&gt;根本原因&lt;/th&gt;
&lt;th&gt;核心解决方案&lt;/th&gt;
&lt;th&gt;适用场景&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;缓存击穿&lt;/td&gt;
&lt;td&gt;热点key失效&lt;/td&gt;
&lt;td&gt;互斥锁、singleflight、永不过期&lt;/td&gt;
&lt;td&gt;热点数据、秒杀商品&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;缓存雪崩&lt;/td&gt;
&lt;td&gt;大量key同时失效&lt;/td&gt;
&lt;td&gt;随机TTL、分级缓存、熔断降级&lt;/td&gt;
&lt;td&gt;大促活动、批量缓存&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;缓存穿透&lt;/td&gt;
&lt;td&gt;查询不存在数据&lt;/td&gt;
&lt;td&gt;布隆过滤器、空值缓存、参数校验&lt;/td&gt;
&lt;td&gt;搜索接口、用户输入&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-redis/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>初入Linux：linux基础与WSL2</title><link>https://www.claran-blog.work/posts/linux/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/linux/</guid><description>linux操作系统的基础学习.</description><pubDate>Wed, 03 Dec 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-linux概况-1&quot;&gt;Linux概况&lt;/h2&gt;
&lt;h3 id=&quot;article-简介-1&quot;&gt;简介&lt;/h3&gt;&lt;p&gt;简单来说，linux就是一个自由和开放源码的类 UNIX 操作系统&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;严格来讲，Linux这个词本身只表示Linux内核，但实际上人们已经习惯了用Linux来形容整个基于Linux内核，并且使用GNU 工程各种工具和数据库的操作系统。&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3 id=&quot;article-发行版-1&quot;&gt;发行版&lt;/h3&gt;&lt;p&gt;Linux 的发行版说简单点就是将 Linux 内核与应用软件做一个打包&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/linxu3.jpg&quot; alt=&quot;linxu3.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;目前市面上较知名的发行版有：Ubuntu、RedHat、CentOS、Debian、Fedora、SuSE、OpenSUSE、Arch Linux、SolusOS 等&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/linxu4.jpg&quot; alt=&quot;linxu4.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-文件管理-1&quot;&gt;文件管理&lt;/h3&gt;&lt;p&gt;linux的文件资源结构如下图：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/linxu2.jpg&quot; alt=&quot;linxu2.jpg&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/linux1.png&quot; alt=&quot;linux1.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-与windows的区别-1&quot;&gt;与windows的区别&lt;/h3&gt;&lt;p&gt;目前国内 Linux 更多的是应用于服务器上，而桌面操作系统更多使用的是 Windows。主要区别如下&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;比较&lt;/th&gt;
&lt;th&gt;Windows&lt;/th&gt;
&lt;th&gt;Linux&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;界面&lt;/td&gt;
&lt;td&gt;界面统一，外壳程序固定所有 Windows 程序菜单几乎一致，快捷键也几乎相同&lt;/td&gt;
&lt;td&gt;图形界面风格依发布版不同而不同，可能互不兼容。GNU/Linux 的终端机是从 UNIX 传承下来，基本命令和操作方法也几乎一致。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;驱动程序&lt;/td&gt;
&lt;td&gt;驱动程序丰富，版本更新频繁。默认安装程序里面一般包含有该版本发布时流行的硬件驱动程序，之后所出的新硬件驱动依赖于硬件厂商提供。对于一些老硬件，如果没有了原配的驱动有时很难支持。另外，有时硬件厂商未提供所需版本的 Windows 下的驱动，也会比较头痛。&lt;/td&gt;
&lt;td&gt;由志愿者开发，由 Linux 核心开发小组发布，很多硬件厂商基于版权考虑并未提供驱动程序，尽管多数无需手动安装，但是涉及安装则相对复杂，使得新用户面对驱动程序问题（是否存在和安装方法）会一筹莫展。但是在开源开发模式下，许多老硬件尽管在Windows下很难支持的也容易找到驱动。HP、Intel、AMD 等硬件厂商逐步不同程度支持开源驱动，问题正在得到缓解。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;使用&lt;/td&gt;
&lt;td&gt;使用比较简单，容易入门。图形化界面对没有计算机背景知识的用户使用十分有利。&lt;/td&gt;
&lt;td&gt;图形界面使用简单，容易入门。文字界面，需要学习才能掌握。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;学习&lt;/td&gt;
&lt;td&gt;系统构造复杂、变化频繁，且知识、技能淘汰快，深入学习困难。&lt;/td&gt;
&lt;td&gt;系统构造简单、稳定，且知识、技能传承性好，深入学习相对容易。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;软件&lt;/td&gt;
&lt;td&gt;每一种特定功能可能都需要商业软件的支持，需要购买相应的授权。&lt;/td&gt;
&lt;td&gt;大部分软件都可以自由获取，同样功能的软件选择较少。&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h2 id=&quot;article-wsl2-1&quot;&gt;WSL2&lt;/h2&gt;
&lt;h3 id=&quot;article-简介-2&quot;&gt;简介&lt;/h3&gt;&lt;p&gt;WSL（Windows Subsystem for Linux） 是微软为 Windows 用户提供的一个子系统，它允许你在 Windows 上原生运行 Linux（不是虚拟机，不是双系统），直接使用 Bash、apt、gcc、Python、Node.js 等 Linux 工具&lt;/p&gt;
&lt;p&gt;而WSL2则是微软针对WSL系统的诸多不足进行改进后的一个被大众广为接受和使用的版本，相比WSL使用了真正的 Linux 内核（轻量虚拟机），并且支持Docker&lt;/p&gt;
&lt;p&gt;因此推荐使用 WSL2，兼容性更强，功能更完整&lt;/p&gt;

&lt;h3 id=&quot;article-安装-1&quot;&gt;安装&lt;/h3&gt;&lt;ol&gt;
&lt;li&gt;&lt;p&gt;打开powershell(管理员权限)，输入：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Shell&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;wsl&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; --install&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt; &lt;strong&gt;安装完后，重启一次系统&lt;/strong&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;接着设置默认 WSL 版本为 WSL2&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Shell&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;wsl&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; --set-default-version&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 2&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;然后从 Microsoft Store 安装 Linux 发行版（如 Ubuntu）&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;这样我们就成功安装了WSL2&lt;/p&gt;
&lt;p&gt;接下来我们进行第一次使用linux的初始化：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;启动linux&lt;/li&gt;
&lt;li&gt;输入用户名和密码（此时密码不可见，但是存在）&lt;/li&gt;
&lt;li&gt;完成初始化&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;这样我们就完成了WSL2的安装和初始化&lt;/p&gt;

&lt;h3 id=&quot;article-wsl命令-1&quot;&gt;WSL命令&lt;/h3&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;命令&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;wsl&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;启动默认 Linux&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;wsl --list --verbose&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;查看已安装的发行版和版本&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;wsl --set-version Ubuntu 2&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;设置 Ubuntu 使用 WSL2&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;wsl --install -d Debian&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;安装指定发行版&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;wsl --shutdown&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;关闭所有 WSL 实例&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;wsl -e bash&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;以 Bash 启动 Linux Shell&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h3 id=&quot;article-日常使用指南-1&quot;&gt;日常使用指南&lt;/h3&gt;
&lt;h4 id=&quot;article-如何访问-windows-文件-1&quot;&gt;如何访问 Windows 文件？&lt;/h4&gt;&lt;p&gt;在 WSL 中，Windows 文件挂载在 /mnt/c、/mnt/d 等目录：&lt;/p&gt;
&lt;p&gt;&lt;code&gt;cd /mnt/c/Users/你的用户名/Desktop&lt;/code&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-如何访问-wsl-文件-1&quot;&gt;如何访问 WSL 文件？&lt;/h4&gt;&lt;p&gt;在 Windows 中访问：&lt;/p&gt;
&lt;p&gt;&lt;code&gt;\\wsl$\Ubuntu\home\your_username&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;或者在资源管理器地址栏输入：&lt;code&gt;\\wsl$&lt;/code&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-如何在windows使用linux内核进行日常开发-1&quot;&gt;如何在Windows使用Linux内核进行日常开发？&lt;/h2&gt;&lt;p&gt;只需要在创建项目时将项目文件夹建在&lt;/p&gt;
&lt;p&gt;&lt;code&gt;/home/你的用户名/...&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;即可&lt;/p&gt;
&lt;p&gt;并为项目打上适配Linux的SDK&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/linux6.png&quot; alt=&quot;linux6.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;这样我们就能在Win端使用熟悉的Goland进行基于linux内核的日常开发了！&lt;/p&gt;

&lt;h2 id=&quot;article-更多linux学习-菜鸟教程-1&quot;&gt;更多Linux学习：&lt;a href=&quot;https://www.runoob.com/linux/linux-tutorial.htm&quot;&gt;菜鸟教程&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/linux/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>工具</category><category>底层</category><category>linux</category></item><item><title>Go-项目结构规范&amp;面向接口与依赖注入思想</title><link>https://www.claran-blog.work/posts/go-Newfunc/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-Newfunc/</guid><description>Web后端设计中注入依赖架构的学习.</description><pubDate>Mon, 24 Nov 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-项目结构规范-1&quot;&gt;项目结构规范&lt;/h2&gt;
&lt;h3 id=&quot;article-规范-1&quot;&gt;规范&lt;/h3&gt;&lt;p&gt;一个项目/Demo的不同包应该按照其&lt;strong&gt;不同功能或实现方法/依赖位置&lt;/strong&gt;来进行不同结构的划分&lt;/p&gt;
&lt;p&gt;例如internal存储项目/Demo内部的所有业务逻辑&lt;/p&gt;
&lt;p&gt;二internal内部按照功能可以划分为service（业务逻辑层）、handler（响应处理层）、util（工具层）、middleware（中间件层）、repository（数据仓库层）等&lt;/p&gt;
&lt;p&gt;而util内部可按照不同对象的工具分为jwt_util、user_util等&lt;/p&gt;
&lt;p&gt;repository内部可以按照不同存储方式分为memory（内存存储）、db（数据库存储）等&lt;/p&gt;
&lt;p&gt;handler也可以分为外部处理和保护处理等层&lt;/p&gt;
&lt;p&gt;以下为可能出现的结构（部分）：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;层级/类别&lt;/th&gt;
&lt;th&gt;目录/包名&lt;/th&gt;
&lt;th&gt;核心职责与内容&lt;/th&gt;
&lt;th&gt;关键原则与说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;应用入口层&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/cmd/&amp;lt;appname&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;应用程序的入口点 (&lt;code&gt;main&lt;/code&gt; 包)。每个子目录对应一个可执行文件，如 &lt;code&gt;cmd/api&lt;/code&gt;, &lt;code&gt;cmd/cli&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;保持精简&lt;/strong&gt;。&lt;code&gt;main.go&lt;/code&gt; 应只包含初始化、依赖注入和启动逻辑。业务代码应置于 &lt;code&gt;internal&lt;/code&gt; 或 &lt;code&gt;pkg&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;接口层 (API/HTTP)&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/internal/handler&lt;/code&gt; (或 &lt;code&gt;controller&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;HTTP 请求处理层，负责参数绑定、校验、基本序列化/反序列化&lt;/td&gt;
&lt;td&gt;不应包含业务逻辑，通常调用 &lt;code&gt;service&lt;/code&gt; 层&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;业务逻辑层&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/internal/service&lt;/code&gt; (或 &lt;code&gt;usecase&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;核心业务逻辑和用例流程的实现层。协调多个 &lt;code&gt;repository&lt;/code&gt; 或领域对象完成业务操作&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;基于接口编程&lt;/strong&gt;。通过依赖注入接收 &lt;code&gt;repository&lt;/code&gt; 等依赖，便于测试&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;数据访问层&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/internal/repository&lt;/code&gt; (或 &lt;code&gt;dao&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;负责与数据源（数据库、缓存、外部 API）交互。对上层提供统一的数据操作接口&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;基于接口编程&lt;/strong&gt;。&lt;code&gt;service&lt;/code&gt; 层依赖 &lt;code&gt;Repository&lt;/code&gt; 接口，而非具体实现，实现解耦&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;领域模型层&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/internal/domain&lt;/code&gt; (或 &lt;code&gt;model&lt;/code&gt;, &lt;code&gt;entity&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;定义核心业务数据结构、枚举、领域对象的行为（方法）和业务规则&lt;/td&gt;
&lt;td&gt;应保持 &lt;strong&gt;高内聚、低耦合&lt;/strong&gt;，不包含具体技术（如 DB 注解）的依赖&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;内部共享工具&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/internal/pkg&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;项目内部多个模块共享的、但不想暴露给外部的辅助代码，如项目特定的数据库连接池、内部中间件&lt;/td&gt;
&lt;td&gt;受 &lt;code&gt;internal&lt;/code&gt; 目录的 &lt;strong&gt;Go 编译器强制保护&lt;/strong&gt;，外部项目无法导入&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;公共库代码&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/pkg&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;设计良好、希望被&lt;strong&gt;外部项目&lt;/strong&gt;导入和使用的公共库代码，如 &lt;code&gt;pkg/logger&lt;/code&gt;, &lt;code&gt;pkg/errors&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;需慎重设计公开 API。对于是否使用此目录存在争议，中小型单体项目可酌情简化&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;接口定义&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/api&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;存放 API 契约文件，如 OpenAPI (Swagger) Spec、Protocol Buffers (&lt;code&gt;.proto&lt;/code&gt;) 文件、GraphQL Schema&lt;/td&gt;
&lt;td&gt;将 &lt;strong&gt;接口契约与实现分离&lt;/strong&gt;，便于前后端协作和生成客户端代码&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;配置模板&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/configs&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;配置文件模板或默认配置（如 &lt;code&gt;config.yaml.tmpl&lt;/code&gt;）&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;切勿在此存放含密码、密钥等敏感信息的真实配置文件&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;部署配置&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/deployments&lt;/code&gt; (或 &lt;code&gt;/deploy&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;IaaS、PaaS、容器编排（如 Docker-Compose, Kubernetes/Helm, Terraform）的配置和模板&lt;/td&gt;
&lt;td&gt;将部署逻辑与应用程序代码分离&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;构建与CI&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/build&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;打包和持续集成相关的配置和脚本。通常包含 &lt;code&gt;/build/ci&lt;/code&gt; (CI 配置) 和 &lt;code&gt;/build/package&lt;/code&gt; (系统包配置)&lt;/td&gt;
&lt;td&gt;与 &lt;code&gt;Makefile&lt;/code&gt; 和 &lt;code&gt;scripts&lt;/code&gt; 目录协同工作&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;脚本库&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/scripts&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;用于执行构建、安装、分析等操作的脚本。这些脚本可被根目录的 &lt;code&gt;Makefile&lt;/code&gt; 调用&lt;/td&gt;
&lt;td&gt;复杂项目可在其下建立子目录，如 &lt;code&gt;scripts/make-rules&lt;/code&gt;, &lt;code&gt;scripts/lib&lt;/code&gt; (Shell 库)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;项目工具&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/tools&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;存放本项目专用的支持工具，这些工具可以导入 &lt;code&gt;pkg&lt;/code&gt; 和 &lt;code&gt;internal&lt;/code&gt; 中的代码&lt;/td&gt;
&lt;td&gt;将工具代码与应用程序代码分开管理&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;外部工具与代码&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/third_party&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;外部辅助工具、Fork 的第三方代码或其他第三方应用（如 Swagger UI）&lt;/td&gt;
&lt;td&gt;方便清晰地管理自定义修改的第三方依赖&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;前端资源&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/web&lt;/code&gt; (或 &lt;code&gt;/assets&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;Web 前端静态资源，如 CSS、JavaScript 文件、服务端模板和单页应用 (SPA)&lt;/td&gt;
&lt;td&gt;主要用于全栈 Web 项目&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;项目文档&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/docs&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;设计文档、用户手册、开发指南等（非 Godoc 生成的 API 文档）可按语言细分，如 &lt;code&gt;docs/guide/zh-CN&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;保持文档与代码版本同步&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;代码示例&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/examples&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;为应用程序或公共库提供的使用示例代码，降低使用者上手门槛&lt;/td&gt;
&lt;td&gt;示例应简洁、典型、可运行&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;网站数据&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/website&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;如果不使用 GitHub Pages，可在此存放项目的网站数据&lt;/td&gt;
&lt;td&gt;适用于有独立站点的开源项目&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Git钩子&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/githooks&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;项目相关的 Git 钩子脚本，如 &lt;code&gt;commit-msg&lt;/code&gt; 钩子&lt;/td&gt;
&lt;td&gt;可通过 Git 配置指向此目录来共享钩子&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;测试相关&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/test&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;额外的&lt;/strong&gt;外部测试应用和测试数据。用于集成测试、端到端测试。可包含 &lt;code&gt;/test/testdata&lt;/code&gt;。&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;单元测试&lt;/strong&gt; (&lt;code&gt;_test.go&lt;/code&gt; 文件) 应与被测试代码放在同一包内&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;依赖包&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/vendor&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;项目依赖的第三方库代码（通过 &lt;code&gt;go mod vendor&lt;/code&gt; 生成）。用于固定依赖版本或离线构建&lt;/td&gt;
&lt;td&gt;现代 Go Modules 下通常无需提交至仓库，但特定场景（如保障确定性构建）仍有用&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h3 id=&quot;article-restful-api-1&quot;&gt;RESTful API&lt;/h3&gt;&lt;p&gt;RESTful API 是一种基于 REST架构风格设计的网络应用程序接口，它通过一系列设计原则和约束条件，让网络服务变得更加清晰、简洁且易于维护&lt;/p&gt;

&lt;h4 id=&quot;article-六大核心原则-1&quot;&gt;🔑六大核心原则&lt;/h4&gt;&lt;p&gt;RESTful API 的设计建立在以下六项架构约束之上：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;统一接口&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;这是REST最核心的约束，它确保与API的交互是标准化的。主要体现在：使用URI唯一地标识每个资源；使用标准的HTTP方法（GET, POST, PUT, DELETE等）来操作资源；返回自描述的消息，通常使用JSON或XML格式&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;无状态&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;每个从客户端发往服务器的请求都必须包含理解该请求所需的全部信息。服务器不会存储任何与会话相关的上下文状态。这使得服务器更容易扩展，也简化了系统设计&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;客户端-服务器分离&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;关注点分离。客户端负责用户界面和用户体验，服务器负责数据处理和存储。两者可以独立开发和演化，只要它们之间的接口不变&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;可缓存&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;服务器返回的响应必须明确表明其是否可以被客户端或中间代理缓存。这可以显著提高性能，减少不必要的网络请求&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;分层系统&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;架构可以由多个层次组成（如：负载均衡、应用服务器、数据库）。客户端不需要知道它是在与哪一层交互，这有助于提高系统的可扩展性和安全性&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;按需代码&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;这是一个可选的约束。服务器可以临时将可执行代码（如JavaScript脚本）发送给客户端，以扩展客户端的功能&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-设计规范-1&quot;&gt;📐设计规范&lt;/h4&gt;&lt;p&gt;在实际设计中，上述原则转化为一些非常具体的实践规范&lt;/p&gt;

&lt;h5 id=&quot;article-uri-设计-1&quot;&gt;URI 设计&lt;/h5&gt;&lt;ul&gt;
&lt;li&gt;&lt;p&gt;使用名词而非动词：URI应该标识资源本身，而不是对资源的操作。例如，应使用 /users，而不是 /getUsers&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;使用复数名词：通常建议对资源集合使用复数形式，如 /products比 /product更常见&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;使用连字符-而非下划线_：这主要是为了提升URI的可读性&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;体现层级关系：对于有关联的资源，可以使用嵌套路径，例如 /users/123/orders表示用户ID为123的所有订单&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-http-方法的正确使用-1&quot;&gt;HTTP 方法的正确使用&lt;/h5&gt;&lt;ul&gt;
&lt;li&gt;&lt;p&gt;GET：检索/获取资源。不应改变资源状态&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;POST：创建新资源&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;PUT：完整更新已存在的资源（客户端提供更新后的完整资源）&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;PATCH：部分更新资源（客户端只提供需要改变的字段）&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;DELETE：删除资源&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-使用标准的http状态码-1&quot;&gt;使用标准的HTTP状态码&lt;/h5&gt;&lt;p&gt;API通过状态码告知客户端请求的结果，这构成了通信契约的重要部分&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;200 OK：请求成功。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;201 Created：资源创建成功。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;204 No Content：请求成功，但无返回内容（如删除操作后）。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;400 Bad Request：客户端请求错误（如参数有误）。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;401 Unauthorized：未认证（身份验证失败）。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;403 Forbidden：无权限（认证成功，但无权访问）。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;404 Not Found：请求的资源不存在。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;500 Internal Server Error：服务器内部错误。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-返回统一的响应格式-1&quot;&gt;返回统一的响应格式&lt;/h5&gt;&lt;p&gt;通常使用JSON作为数据交换格式，并保持响应结构的一致性。一个常见的成功响应格式如下&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;code&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;200&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;success&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;data&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;        &quot;id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;        &quot;name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Example&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;而错误响应则可能包含错误信息：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;code&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;404&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Requested resource not found&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-流程规范-1&quot;&gt;流程规范&lt;/h3&gt;&lt;p&gt;以handler为例&lt;/p&gt;
&lt;p&gt;handler:&lt;/p&gt;
&lt;p&gt;创建数据 -&amp;gt; 捕获数据 -&amp;gt; 调用服务层（service）-&amp;gt; 构建响应(model.response) -&amp;gt; 返回响应（response）&lt;/p&gt;
&lt;p&gt;. . . . . . &lt;/p&gt;

&lt;h2 id=&quot;article-面向接口与依赖注入-1&quot;&gt;面向接口与依赖注入&lt;/h2&gt;&lt;ol&gt;
&lt;li&gt;接口定义的位置&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;在Go中，接口由使用方定义是一种最佳实践。这意味着，操作数据的接口（如 UserRepository）应该在调用它的层中定义，而不是在实现它的层中&lt;br /&gt;。&lt;/p&gt;
&lt;p&gt;业务逻辑层（service）定义它需要什么样的数据存取功能（repository接口）。&lt;/p&gt;
&lt;p&gt;数据访问层（repository）负责实现这个接口。&lt;/p&gt;
&lt;p&gt;这样做彻底解耦了业务逻辑和具体的技术实现，使得更换数据库（如从MySQL到PostgreSQL）或为测试提供Mock实现变得非常容易&lt;br /&gt;。&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;依赖注入（Dependency Injection）&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;依赖注入是实现控制反转、连接各层的关键技术。它通常在 main.go或专门的 wire包中完成：&lt;/p&gt;
&lt;p&gt;在入口函数中，初始化所有具体的实现（如数据库连接、第三方SDK）。&lt;/p&gt;
&lt;p&gt;将具体实现实例，注入到需要它们接口的业务组件中（如将 userRepository实例传递给 userService）。&lt;/p&gt;

&lt;h3 id=&quot;article-实例-1&quot;&gt;实例&lt;/h3&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-rule1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://github.com/Claran309/Go-Demo-Login_And_Register&quot;&gt;Demo&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-Newfunc/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>项目</category><category>架构设计</category></item><item><title>随笔.5：为摆烂找点借口</title><link>https://www.claran-blog.work/posts/diary5/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/diary5/</guid><description>大一期中绝赞焦虑中...</description><pubDate>Sun, 23 Nov 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-2025-11-15-1&quot;&gt;2025.11.15&lt;/h2&gt;&lt;p&gt;学go的第一月结束了，目前只学到了MySQL，感觉有点慢了&lt;/p&gt;
&lt;p&gt;但是后续大概还是不会加快速度，因为还是想兼顾一下高数和其他东西（&lt;/p&gt;
&lt;p&gt;估计还是一周一个章节/知识点的龟速吧. . .&lt;/p&gt;
&lt;p&gt;另外，学gin的这段时间搓了个人生中的第一个较大的Demo，看着满屏的代码成就感满满. . .&lt;/p&gt;
&lt;p&gt;嗯 ~ 我对这个“长子”Demo非常满意&lt;/p&gt;

&lt;h2 id=&quot;article-2025-11-22-1&quot;&gt;2025.11.22&lt;/h2&gt;&lt;p&gt;这周基本没学什么新东西（除了协程池），全用来写红蓝作业了。。。。。。。&lt;/p&gt;

&lt;h2 id=&quot;article-2025-11-23-1&quot;&gt;2025.11.23&lt;/h2&gt;&lt;p&gt;感觉有点慢！这周学个Redis和MongoSQL吧，顺便把Linux看看&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;问题是什么？&lt;/p&gt;
&lt;p&gt;我们现在每周的自习时间满打满算：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;周一 13:00 ~ 20:00 &lt;/li&gt;
&lt;li&gt;周二 13:00 ~ 20:00 （旷电子实训、水课）&lt;/li&gt;
&lt;li&gt;周三 19:00 ~ 20:30（下午有高数和按人头坐的英语）&lt;/li&gt;
&lt;li&gt;周四 全天 （旷C、医学、水课）&lt;/li&gt;
&lt;li&gt;周五 没时间（早八高数、英语）&lt;/li&gt;
&lt;li&gt;周末 看情况&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;也就是说，悲观来说，有三天有较长的自习时间&lt;/p&gt;
&lt;p&gt;在这其中，挑一天来总结运用知识并撰写博客，还剩两天&lt;/p&gt;
&lt;p&gt;所以，前面几周我都是用这两天每周学一个技术栈并完成蓝山红岩的作业&lt;/p&gt;
&lt;p&gt;这就是为什么学这么慢！kuso！&lt;/p&gt;
&lt;p&gt;而且已经固定在9204自习了，去九教别的教室会赶出来（）&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;&lt;strong&gt;接下来打算学Redis，MongoSQL，Linux，Docker，预计耗费4周（有期中！），希望最好能在12月中旬学完，然后开始着手于寒假考核qaq&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;另：退赛了CACC，因为和数学期中考重合了&lt;/strong&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-2025-11-24-1&quot;&gt;2025.11.24&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;喜报，主包记错考试时间了，这周得看宋浩了，Redis下周再说&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;另：你妈的不该退赛CACC，记错考试时间了&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;另：不对该退赛CACC，当天体侧最后一天qwq&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/diary5/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>随笔</category><category>杂项</category></item><item><title>项目中合理的错误处理与传递</title><link>https://www.claran-blog.work/posts/go-error/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-error/</guid><description>Go中email包的使用.</description><pubDate>Wed, 19 Nov 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-go语言优雅错误处理指南-1&quot;&gt;Go语言优雅错误处理指南&lt;/h2&gt;
&lt;h3 id=&quot;article-概述-1&quot;&gt;概述&lt;/h3&gt;&lt;p&gt;本文档详细讲解如何在Go语言项目中实现优雅的错误处理机制，特别是在Gin框架的Handler-Service-DAO分层架构中。&lt;/p&gt;

&lt;h3 id=&quot;article-核心原则-1&quot;&gt;核心原则&lt;/h3&gt;
&lt;h4 id=&quot;article-1-错误是值-不是异常-1&quot;&gt;1. 错误是值，不是异常&lt;/h4&gt;&lt;p&gt;Go语言将错误视为普通返回值，这要求开发者显式处理每个可能的错误。&lt;/p&gt;

&lt;h4 id=&quot;article-2-添加上下文信息-1&quot;&gt;2. 添加上下文信息&lt;/h4&gt;&lt;p&gt;错误在传递过程中应该携带足够的上下文信息，便于问题定位。&lt;/p&gt;

&lt;h4 id=&quot;article-3-统一错误响应-1&quot;&gt;3. 统一错误响应&lt;/h4&gt;&lt;p&gt;API应该返回统一格式的错误响应，方便客户端处理。&lt;/p&gt;

&lt;h3 id=&quot;article-分层错误处理架构-1&quot;&gt;分层错误处理架构&lt;/h3&gt;
&lt;h4 id=&quot;article-项目结构-1&quot;&gt;项目结构&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;g&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;project/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── response/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── response.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── errors/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── business.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── handler/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── user_handler.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── service/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── user_service.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── dao/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── user_dao.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;└── model/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;└── user.go&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-为什么需要分层错误处理-1&quot;&gt;为什么需要分层错误处理？&lt;/h3&gt;
&lt;h4 id=&quot;article-各层职责和错误处理策略-1&quot;&gt;各层职责和错误处理策略&lt;/h4&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;层级&lt;/th&gt;
&lt;th&gt;职责&lt;/th&gt;
&lt;th&gt;错误处理策略&lt;/th&gt;
&lt;th&gt;为什么这样设计&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;DAO层&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;数据访问，纯技术操作&lt;/td&gt;
&lt;td&gt;返回原始错误或基础业务错误&lt;/td&gt;
&lt;td&gt;DAO层不应该关心业务逻辑，只负责技术错误&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Service层&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;业务逻辑处理&lt;/td&gt;
&lt;td&gt;将技术错误转换为业务错误，添加业务上下文&lt;/td&gt;
&lt;td&gt;Service层理解业务含义，知道如何包装错误&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Handler层&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;HTTP请求处理&lt;/td&gt;
&lt;td&gt;捕获所有错误，转换为HTTP响应&lt;/td&gt;
&lt;td&gt;Handler层是系统边界，需要统一响应格式&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h4 id=&quot;article-错误传递的哲学-1&quot;&gt;错误传递的哲学&lt;/h4&gt;&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;DAO层保持纯粹&lt;/strong&gt;：只处理数据访问相关错误，不添加业务语义&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Service层添加业务语义&lt;/strong&gt;：将技术错误翻译成业务人员能理解的错误&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Handler层统一格式化&lt;/strong&gt;：将错误转换为客户端能理解的格式&lt;/li&gt;
&lt;/ol&gt;

&lt;h3 id=&quot;article-源码实现-1&quot;&gt;源码实现&lt;/h3&gt;
&lt;h4 id=&quot;article-1-统一响应包-response-response-go-1&quot;&gt;1. 统一响应包 (response/response.go)&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; response&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net/http&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/gin-gonic/gin&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Response&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Code    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;         `json:&quot;code&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Message &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;      `json:&quot;message&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Data    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;`json:&quot;data,omitempty&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Error   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;      `json:&quot;error,omitempty&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Success&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;data&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusOK, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Response&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Code:    &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Message: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;success&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Data:    data,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;code&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;message&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusOK, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Response&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Code:    code,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Message: message,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; InternalError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;err&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusOK, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Response&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Code:    &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;500&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Message: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;内部服务器错误&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; BadRequest&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;message&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusOK, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Response&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Code:    &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;400&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Message: message,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NotFound&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;message&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusOK, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Response&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Code:    &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;404&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Message: message,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;设计理由&lt;/strong&gt;：统一响应格式确保客户端始终收到结构一致的响应，便于错误处理和用户体验优化。&lt;/p&gt;

&lt;h4 id=&quot;article-2-业务错误定义-errors-business-go-1&quot;&gt;2. 业务错误定义 (errors/business.go)&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; errors&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;CodeUserNotFound&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 10001&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;CodeInvalidParam&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 10002&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;CodeDBError&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;      =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 10003&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; BusinessError&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Code    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Message &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Err     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e.Err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;业务错误[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;]: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, 原因: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, e.Code, e.Message, e.Err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;业务错误[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;]: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, e.Code, e.Message)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;e &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unwrap&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; e.Err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewBusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;code&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;message&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Code:    code,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Message: message,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WrapBusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;code&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;message&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;err&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Code:    code,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Message: message,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Err:     err,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ErrUserNotFound &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewBusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(CodeUserNotFound, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户不存在&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ErrInvalidParam &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewBusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(CodeInvalidParam, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;参数错误&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;设计理由&lt;/strong&gt;：自定义错误类型可以携带丰富的上下文信息（错误码、消息、原始错误），支持错误链追踪。&lt;/p&gt;

&lt;h4 id=&quot;article-3-数据模型-model-user-go-1&quot;&gt;3. 数据模型 (model/user.go)&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; model&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; User&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ID     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;  `json:&quot;id&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Name   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;name&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Email  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;email&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Status &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;status&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-4-dao层-dao-user-dao-go-1&quot;&gt;4. DAO层 (dao/user_dao.go)&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; dao&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;database/sql&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your-project/errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your-project/model&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserDAO&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;db &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sql&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DB&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewUserDAO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;db&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sql&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DB&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserDAO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserDAO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{db: db}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;d &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserDAO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetUserByID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;userID&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; query&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;SELECT id, name, email, status FROM users WHERE id = ? AND deleted = 0&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; d.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;QueryRow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(query, userID).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scan&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;user.ID, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;user.Name, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;user.Email, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;user.Status)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sql.ErrNoRows {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.ErrUserNotFound&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;查询用户失败 (ID: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;): &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, userID, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;user, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;d &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserDAO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CreateUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;user&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;const&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; query&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;INSERT INTO users (name, email) VALUES (?, ?)&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    result, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; d.db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exec&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(query, user.Name, user.Email)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;创建用户失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    userID, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LastInsertId&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;获取用户ID失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%w&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    user.ID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;DAO层错误传递策略&lt;/strong&gt;：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;遇到&lt;code&gt;sql.ErrNoRows&lt;/code&gt;时返回业务错误&lt;code&gt;ErrUserNotFound&lt;/code&gt;，因为&quot;用户不存在&quot;是业务逻辑的一部分&lt;/li&gt;
&lt;li&gt;其他数据库错误使用&lt;code&gt;%w&lt;/code&gt;包装，保留原始错误信息但添加上下文&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;不直接返回HTTP状态码&lt;/strong&gt;，因为DAO层不应该知道HTTP协议&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-5-service层-service-user-service-go-1&quot;&gt;5. Service层 (service/user_service.go)&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; service&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your-project/dao&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your-project/errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your-project/model&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserService&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;userDAO &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;dao&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserDAO&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewUserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;userDAO&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;dao&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserDAO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{userDAO: userDAO}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; CreateUserRequest&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Name  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;name&quot; binding:&quot;required&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Email &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;email&quot; binding:&quot;required,email&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;userID&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; userID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WrapBusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;errors.CodeInvalidParam,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户ID必须大于0&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    user, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.userDAO.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetUserByID&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; businessErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errors&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BusinessError&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;As&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;businessErr) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WrapBusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            errors.CodeDBError,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;获取用户信息失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            err,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user.Status &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;banned&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewBusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10004&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户已被封禁&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CreateUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;req&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CreateUserRequest&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; req.Name &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WrapBusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;errors.CodeInvalidParam,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;用户名不能为空&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(req.Name) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 2&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(req.Name) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 20&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WrapBusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            errors.CodeInvalidParam,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;用户名长度必须在2-20个字符之间&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;            nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    user &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Name:  req.Name,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Email: req.Email,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.userDAO.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CreateUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(user); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WrapBusinessError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            errors.CodeDBError,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;创建用户失败&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            err,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;Service层错误传递策略&lt;/strong&gt;：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;进行&lt;strong&gt;业务参数验证&lt;/strong&gt;，将无效参数转换为业务错误&lt;/li&gt;
&lt;li&gt;使用&lt;code&gt;errors.As()&lt;/code&gt;检查错误类型，如果是业务错误直接传递&lt;/li&gt;
&lt;li&gt;将DAO层的技术错误&lt;strong&gt;包装为业务错误&lt;/strong&gt;，添加业务语义&lt;/li&gt;
&lt;li&gt;实现&lt;strong&gt;业务规则验证&lt;/strong&gt;（如用户状态检查）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;不涉及HTTP概念&lt;/strong&gt;，保持业务逻辑的纯粹性&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-6-handler层-handler-user-handler-go-1&quot;&gt;6. Handler层 (handler/user_handler.go)&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; handler&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net/http&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strconv&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/gin-gonic/gin&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your-project/errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your-project/response&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your-project/service&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; UserHandler&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;userService &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewUserHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;userService&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{userService: userService}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;userIDStr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Param&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;userID, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ParseInt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userIDStr, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;response.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BadRequest&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;无效的用户ID&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    user, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.userService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;handleError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    response.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Success&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CreateUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; req &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CreateUserRequest&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ShouldBindJSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;req); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;response.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BadRequest&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;请求参数格式错误&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    user, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; h.userService.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;CreateUser&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;req)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        h.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;handleError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    response.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Success&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;h &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UserHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;handleError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;err&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; businessErr &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errors&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;BusinessError&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;As&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;businessErr) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;response.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, businessErr.Code, businessErr.Message)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    response.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;InternalError&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(c, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;Handler层错误处理策略&lt;/strong&gt;：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;处理&lt;strong&gt;HTTP特定错误&lt;/strong&gt;（参数解析、数据绑定）&lt;/li&gt;
&lt;li&gt;统一的&lt;strong&gt;错误处理入口&lt;/strong&gt;&lt;code&gt;handleError&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;区分&lt;strong&gt;业务错误&lt;/strong&gt;和&lt;strong&gt;系统错误&lt;/strong&gt;，分别处理&lt;/li&gt;
&lt;li&gt;将错误转换为&lt;strong&gt;统一的HTTP响应格式&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;记录错误日志（在生产环境中可能隐藏内部错误细节）&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-7-主程序-main-go-1&quot;&gt;7. 主程序 (main.go)&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;database/sql&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/gin-gonic/gin&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    _ &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/go-sql-driver/mysql&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your-project/dao&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your-project/handler&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;your-project/service&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;db, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sql.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Open&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;mysql&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user:password@/dbname&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;数据库连接失败:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    userDAO &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; dao.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewUserDAO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(db)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    userService &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; service.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewUserService&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userDAO)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    userHandler &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; handler.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewUserHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(userService)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    r &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; gin.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/users/:id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, userHandler.GetUser)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;POST&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/users&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, userHandler.CreateUser)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;服务器启动在 :8080&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Run&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:8080&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-错误处理流程示例-1&quot;&gt;错误处理流程示例&lt;/h3&gt;
&lt;h4 id=&quot;article-成功流程-1&quot;&gt;成功流程&lt;/h4&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;请求: GET /users/123&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ Handler: 解析参数，调用service.GetUser(123)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ Service: 参数验证，调用dao.GetUserByID(123)  &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ DAO: 执行SQL，返回用户数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↑ Service: 返回用户数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↑ Handler: response.Success(c, user)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;响应: { &quot;code&quot;: 0, &quot;message&quot;: &quot;success&quot;, &quot;data&quot;: { ... } }&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-错误流程-用户不存在-1&quot;&gt;错误流程（用户不存在）&lt;/h4&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;请求: GET /users/999&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ Handler: 解析参数，调用service.GetUser(999)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ Service: 参数验证，调用dao.GetUserByID(999)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ DAO: SQL返回ErrNoRows，返回errors.ErrUserNotFound&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↑ Service: 传递errors.ErrUserNotFound&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↑ Handler: h.handleError → response.Error(10001, &quot;用户不存在&quot;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;响应: { &quot;code&quot;: 10001, &quot;message&quot;: &quot;用户不存在&quot; }&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-错误流程-数据库连接失败-1&quot;&gt;错误流程（数据库连接失败）&lt;/h4&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;请求: GET /users/123&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ Handler: 解析参数，调用service.GetUser(123)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ Service: 参数验证，调用dao.GetUserByID(123)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↓ DAO: 数据库连接失败，返回原始错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↑ Service: 包装为业务错误&quot;获取用户信息失败&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;↑ Handler: h.handleError → response.InternalError&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;响应: { &quot;code&quot;: 500, &quot;message&quot;: &quot;内部服务器错误&quot; }&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-各层错误传递的设计哲学-1&quot;&gt;各层错误传递的设计哲学&lt;/h3&gt;
&lt;h4 id=&quot;article-1-关注点分离-separation-of-concerns-1&quot;&gt;1. 关注点分离 (Separation of Concerns)&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;DAO层&lt;/strong&gt;只关心数据访问技术细节&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Service层&lt;/strong&gt;只关心业务逻辑和规则&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Handler层&lt;/strong&gt;只关心HTTP协议和用户交互&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-2-错误信息-enrichment-丰富化-1&quot;&gt;2. 错误信息 enrichment（丰富化）&lt;/h4&gt;&lt;p&gt;错误在向上传递过程中不断添加上下文信息：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;DAO: &quot;查询失败&quot;&lt;/li&gt;
&lt;li&gt;Service: &quot;获取用户信息失败：查询失败&quot;&lt;/li&gt;
&lt;li&gt;Handler: HTTP 500 + 日志记录&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-3-错误类型转换-1&quot;&gt;3. 错误类型转换&lt;/h4&gt;&lt;p&gt;将底层技术错误转换为高层业务概念：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;sql.ErrNoRows&lt;/code&gt; → &lt;code&gt;ErrUserNotFound&lt;/code&gt; → HTTP 404&lt;/li&gt;
&lt;li&gt;&lt;code&gt;sql.ErrConnDone&lt;/code&gt; → &lt;code&gt;ErrDBError&lt;/code&gt; → HTTP 500&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-4-防御性编程-1&quot;&gt;4. 防御性编程&lt;/h4&gt;&lt;p&gt;每层都进行适当的验证，尽早失败，避免错误传播到不合适的层级。&lt;/p&gt;

&lt;h3 id=&quot;article-最佳实践总结-1&quot;&gt;最佳实践总结&lt;/h3&gt;&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;分层处理&lt;/strong&gt;：各司其职，避免层间职责混淆&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;错误包装&lt;/strong&gt;：使用错误链保留完整上下文&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;统一格式&lt;/strong&gt;：客户端友好的错误响应格式&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;适当日志&lt;/strong&gt;：在适当层级记录适当详情的日志&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;错误分类&lt;/strong&gt;：区分可预期业务错误和意外系统错误&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;通过这种架构，可以实现清晰、可维护的错误处理机制，提高代码质量和系统稳定性。&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-error/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>Go并发实践-手搓协程池</title><link>https://www.claran-blog.work/posts/go-goroutine-pool/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-goroutine-pool/</guid><description>基于Go并发控制实现的协程池原理.</description><pubDate>Mon, 17 Nov 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-前置并发知识-1&quot;&gt;前置并发知识&lt;/h2&gt;
&lt;h3 id=&quot;article-并发-1&quot;&gt;并发&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;&lt;a href=&quot;https://www.claran-blog.work/2025/10/27/Go-goroutine%EF%BC%8Cchannel-sync%E5%8C%85/&quot;&gt;goroutine&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-生产者-消费者-模型-1&quot;&gt;生产者&amp;amp;消费者 模型&lt;/h3&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-pool2.png&quot; alt=&quot;Go-pool2.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;生产者-消费者模型是一种经典的并发编程模式，通过缓冲区解耦生产者和消费者，使它们可以独立、异步地工作。&lt;/p&gt;

&lt;h4 id=&quot;article-核心组件-1&quot;&gt;核心组件&lt;/h4&gt;&lt;ol&gt;
&lt;li&gt;&lt;p&gt;生产者（Producer）&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;数据的产生者&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;负责创建任务或数据&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;将数据放入缓冲区&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;消费者（Consumer）&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;数据的处理者&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;从缓冲区获取数据&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;执行具体的业务逻辑&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;缓冲区（Buffer/Queue）&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;生产者和消费者之间的桥梁&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;平衡生产速度和消费速度的差异&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;提供流量控制和数据暂存&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-pool3.png&quot; alt=&quot;Go-pool3.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-任务分发的必要性-1&quot;&gt;任务分发的必要性&lt;/h3&gt;&lt;p&gt;为什么需要任务分发？&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;直接创建Goroutine的问题&lt;/strong&gt;：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ❌ 不推荐：无限制创建goroutine&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 10000&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; processTask&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(i)  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 可能创建过多goroutine！&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;问题分析&lt;/strong&gt;：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;资源耗尽&lt;/strong&gt; - 内存、CPU过载&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;调度开销&lt;/strong&gt; - 上下文切换成本高&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;难以管理&lt;/strong&gt; - 无法控制并发数量&lt;br /&gt;`&lt;/li&gt;
&lt;/ol&gt;

&lt;h2 id=&quot;article-协程池-1&quot;&gt;协程池&lt;/h2&gt;
&lt;h3 id=&quot;article-梗概-1&quot;&gt;梗概&lt;/h3&gt;
&lt;h4 id=&quot;article-什么是协程池-1&quot;&gt;什么是协程池？&lt;/h4&gt;&lt;p&gt;协程池是一种&lt;strong&gt;复用Goroutine&lt;/strong&gt;的技术，通过预先创建固定数量的工作协程，重复使用它们来处理任务，避免频繁创建和销毁的开销。&lt;/p&gt;

&lt;h4 id=&quot;article-核心思想-1&quot;&gt;核心思想&lt;/h4&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-pool1.png&quot; alt=&quot;Go-pool1.png&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;生产者-消费者模型的扩展&lt;/strong&gt;：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;生产者&lt;/strong&gt;：提交任务到任务队列&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;消费者&lt;/strong&gt;：工作协程从队列获取任务执行&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;缓冲区&lt;/strong&gt;：任务队列平衡生产消费速度&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-实现思路-1&quot;&gt;实现思路&lt;/h3&gt;
&lt;h4 id=&quot;article-核心组件设计-1&quot;&gt;核心组件设计&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WorkerPool&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    taskChan    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Task&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;      // 任务通道（缓冲队列）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    resultChan  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Result&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 结果通道&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    stopChan    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 停止信号&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    wg          &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WaitGroup&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 等待组（协调goroutine）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 统计信息（原子操作保证线程安全）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    SubmitSum   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 已提交任务数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    CompleteSum &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 已完成任务数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-工作流程-1&quot;&gt;工作流程&lt;/h4&gt;&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;初始化阶段&lt;/strong&gt;：创建指定数量的worker&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;任务提交&lt;/strong&gt;：生产者向taskChan发送任务&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;任务处理&lt;/strong&gt;：worker从taskChan接收并执行&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;结果收集&lt;/strong&gt;：处理结果发送到resultChan&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;优雅关闭&lt;/strong&gt;：通过stopChan协调关闭&lt;/li&gt;
&lt;/ol&gt;

&lt;h3 id=&quot;article-代码实现-1&quot;&gt;代码实现&lt;/h3&gt;
&lt;h4 id=&quot;article-核心结构定义-1&quot;&gt;核心结构定义&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; workerPool&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;runtime&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync/atomic&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// TaskFunc 任务函数类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; TaskFunc&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Task 任务结构&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Task&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ID   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;      // 任务ID（用于追踪）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Func &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TaskFunc&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 要执行的任务函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// TaskResult 任务执行结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; TaskResult&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ID     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;         // 对应任务ID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 执行结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Err    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;       // 错误信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// WorkerPool 协程池主体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; WorkerPool&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    taskChan    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Task&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;      // 任务通道（缓冲队列）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    resultChan  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; TaskResult&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 结果通道&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    stopChan    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}   &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 停止信号通道&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    wg          &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WaitGroup&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 等待组（协调goroutine生命周期）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 原子操作统计（线程安全）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    SubmitSum   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 已提交任务总数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    CompleteSum &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 已完成任务总数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-初始化协程池-1&quot;&gt;初始化协程池&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// NewWorkerPool 创建新的协程池&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewWorkerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;workerCount&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;queueSize&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WorkerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 参数校验和默认值设置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; workerCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        workerCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; runtime.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NumCPU&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 2&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 默认：CPU核心数×2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; queueSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; workerCount {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        queueSize &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; workerCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 100&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 默认队列大小：worker数×100&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 初始化协程池实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    pool &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WorkerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        taskChan:   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Task&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, queueSize),     &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 带缓冲的任务通道&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        resultChan: &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; TaskResult&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, queueSize), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 带缓冲的结果通道&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        stopChan:   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}),             &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 无缓冲停止信号&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建worker协程&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; workerCount; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        pool.wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        go&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; pool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;worker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 启动worker goroutine&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; pool&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-生产者-提交任务-1&quot;&gt;生产者：提交任务&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Produce 提交任务到协程池（生产者）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WorkerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Produce&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;taskFunc&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; TaskFunc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 封装任务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    task &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Task&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ID:   &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(atomic.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;p.SubmitSum, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 原子操作生成任务ID&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Func: taskFunc,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 非阻塞发送任务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.taskChan &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; task:  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 正常提交&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;p.stopChan:        &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 协程池已关闭&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;New&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;pool stopped&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-消费者-工作协程-1&quot;&gt;消费者：工作协程&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// worker 工作协程（消费者）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WorkerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;worker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Done&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 确保goroutine结束时通知WaitGroup&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; task, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;p.taskChan:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok {  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 通道已关闭且无剩余任务    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;					return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 执行具体任务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                result, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; task.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                // 发送处理结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				p.resultChan &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; TaskResult&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					ID:     task.ID, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					Result: result,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;					Err:    err,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;				// 原子操作更新完成计数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				atomic.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;p.CompleteSum, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;p.stopChan:  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 收到停止信号&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-结果收集和管理-1&quot;&gt;结果收集和管理&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// GetResults 获取结果通道（只读）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WorkerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetResults&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-chan&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; TaskResult&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.resultChan&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// GetInfo 获取统计信息（线程安全）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WorkerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; atomic.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LoadInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;p.SubmitSum), atomic.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LoadInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;p.CompleteSum)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Close 优雅关闭协程池&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WorkerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(p.taskChan)   &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 关闭任务通道（停止接收新任务）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    p.wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Wait&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()         &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 等待所有worker完成任务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(p.resultChan) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 关闭结果通道&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(p.stopChan)   &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 关闭停止信号&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-实战案例-文件关键词搜索-1&quot;&gt;🎯 实战案例：文件关键词搜索&lt;/h3&gt;
&lt;h4 id=&quot;article-业务逻辑层-1&quot;&gt;业务逻辑层&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; service&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;bufio&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync/atomic&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Result 搜索结果结构&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Result&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Path &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;      // 文件路径&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Info []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LineInfo&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 匹配行信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Err  &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;       // 错误信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// LineInfo 行信息结构&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; LineInfo&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Line    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 行号&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Content &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 行内容&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Task 搜索任务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Task&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Path    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 文件路径&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Keyword &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 搜索关键词&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Search 文件搜索函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Search&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;task&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Task&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 打开文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    file, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Open&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(task.Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Path: task.Path,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Err:  fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;无法打开文件: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; file.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; info []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LineInfo&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    scanner &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bufio.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewScanner&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(file)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    lineNum &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 逐行扫描&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scan&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    lineNum&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    line &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Text&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Contains&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(line, task.Keyword) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            info &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(info, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LineInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                Line:    lineNum,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                Content: strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TrimSpace&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(line),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 检查扫描错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scanner.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Err&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Path: task.Path,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        Err:  fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;读取文件错误: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Path: task.Path,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Info: info,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 全局统计（原子操作保证线程安全）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    totalFiles &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 总文件数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    foundFiles &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 包含关键词的文件数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    totalLines &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 总匹配行数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// SetTotal 设置总文件数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; SetTotal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;num&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    atomic.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StoreInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;totalFiles, num)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AddFound 增加找到的文件计数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; AddFound&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;num&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    atomic.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;foundFiles, num)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// AddLines 增加匹配行计数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; AddLines&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;num&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    atomic.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;totalLines, num)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// GetInfo 获取统计信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; GetInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(atomic.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LoadInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;totalFiles)),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(atomic.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LoadInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;foundFiles)),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(atomic.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;LoadInt64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;totalLines))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-主程序入口-1&quot;&gt;主程序入口&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lesson_1/Lanshan-lesson5/service&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lesson_1/Lanshan-lesson5/workerPool&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;io/fs&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;os&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;path/filepath&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;runtime&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sort&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 参数验证&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(os.Args) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;使用方法: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; [目录路径] [搜索关键词]&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, os.Args[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;])&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    dir &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.Args[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    keyword &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.Args[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 目录存在性检查&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Stat&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(dir); os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsNotExist&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;目录 &apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos; 不存在&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, dir)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 初始化配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    workerCount &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; runtime.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NumCPU&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;搜索目录: &apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;, 关键词: &apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, dir, keyword)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    startTime &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 创建协程池&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    pool &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; workerPool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewWorkerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(workerCount, workerCount&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 遍历目录获取文件列表&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    paths, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; walkDirectory&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(dir)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;遍历目录错误: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        os.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    service.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SetTotal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(paths)))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发现文件数: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(paths))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 结果收集通道&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    results &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; workerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TaskResult&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, workerCount&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    done &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动结果收集器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; collectResults&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(results, done, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(paths))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 提交搜索任务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    submittedTasks &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, path &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; paths {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        task &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Task&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Path: path, Keyword: keyword}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; pool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Produce&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;                return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; service.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Search&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(task)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;任务提交失败: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            } &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                submittedTasks&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;成功提交任务数: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, submittedTasks)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 转发结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; forwardResults&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(pool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetResults&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), results)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 等待所有任务完成&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    pool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(results)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;done &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 等待结果收集完成&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 输出统计信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    total, found, lines &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; service.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    elapsed &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Since&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(startTime)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;============= 搜索完成 =============&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;总文件数: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, total)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;包含关键词的文件数: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, found)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;总匹配行数: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, lines)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;耗时: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, elapsed)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    submitted, completed &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; pool.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetInfo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;任务提交数: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, submitted)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;任务完成数: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, completed)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// walkDirectory 遍历目录获取文件列表&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; walkDirectory&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;dir&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) ([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; paths []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; filepath.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WalkDir&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(dir, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;path&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;d&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; fs&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DirEntry&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;err&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;访问错误 &apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, path, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 跳过错误文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;d.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;IsDir&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            paths &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(paths, path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; paths, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// forwardResults 结果转发 &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; forwardResults&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;source&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-chan&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; workerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TaskResult&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;dest&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; chan&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; workerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TaskResult&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; source {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        dest &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// collectResults 收集和处理结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; collectResults&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;results&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-chan&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; workerPool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TaskResult&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;done&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; chan&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;total&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; finalResults []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Result&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    processed &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 处理每个结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; results {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        processed&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 进度显示&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; processed&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;%&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            progress &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; float64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(processed) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; float64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(total) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 100&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;处理进度: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%.2f%%&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, processed, total, progress)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 类型断言获取搜索结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; searchResult, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Result.(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            finalResults &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(finalResults, searchResult)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;            // 更新统计&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(searchResult.Info) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                service.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddFound&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;                service.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AddLines&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(searchResult.Info)))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 输出最终结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;================搜索结果================&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    printResults&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(finalResults)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    done &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// printResults 格式化输出结果&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; printResults&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;results&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Result&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 按文件路径排序&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    sort.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Slice&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(results, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;i&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;j&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; results[i].Path &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; results[j].Path&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; results {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;错误: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; - &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result.Path, result.Err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            continue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(result.Info) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result.Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, info &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result.Info {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;    &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, info.Line, info.Content)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-goroutine-pool/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>走进MySQL、gorm和其他关系型数据库</title><link>https://www.claran-blog.work/posts/go-sql/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-sql/</guid><description>学习数据库SQL操作及Gorm包.</description><pubDate>Thu, 13 Nov 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-数据库-1&quot;&gt;数据库&lt;/h2&gt;
&lt;h3 id=&quot;article-数据库核心概念-1&quot;&gt;📚 数据库核心概念&lt;/h3&gt;
&lt;h4 id=&quot;article-数据库定义-1&quot;&gt;数据库定义&lt;/h4&gt;&lt;p&gt;数据库是用于&lt;strong&gt;长期保存数据、高并发访问数据、快速查询数据&lt;/strong&gt;的系统，是后端的核心基础设施。&lt;/p&gt;

&lt;h4 id=&quot;article-数据库五大特性-1&quot;&gt;数据库五大特性&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;持久化存储&lt;/strong&gt; - 数据写入后不会丢失&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;并发处理能力&lt;/strong&gt; - 多用户同时访问，保证数据正确性&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;高效查询&lt;/strong&gt; - 通过索引、优化器实现快速检索&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;安全与权限控制&lt;/strong&gt; - 精确控制数据访问权限&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;事务一致性&lt;/strong&gt; - 通过ACID保证数据完整性&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-数据库分类-1&quot;&gt;数据库分类&lt;/h3&gt;
&lt;h4 id=&quot;article-关系型数据库-本课重点-1&quot;&gt;关系型数据库（本课重点）&lt;/h4&gt;&lt;p&gt;特点：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;表结构&lt;/li&gt;
&lt;li&gt;SQL标准&lt;/li&gt;
&lt;li&gt;强一致性&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;代表：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;MySQL&lt;/li&gt;
&lt;li&gt;PostgreSQL&lt;/li&gt;
&lt;li&gt;Oracle&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;适用：订单管理、用户系统、业务数据&lt;/p&gt;

&lt;h4 id=&quot;article-非关系型数据库-1&quot;&gt;非关系型数据库&lt;/h4&gt;&lt;p&gt;特点：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;无固定结构&lt;/li&gt;
&lt;li&gt;高扩展性&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;代表：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Redis(键值)&lt;/li&gt;
&lt;li&gt;MongoDB(文档)&lt;/li&gt;
&lt;li&gt;ElasticSearch(搜索)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;适用：缓存、日志、大数据分析&lt;/p&gt;

&lt;h3 id=&quot;article-acid-原则-1&quot;&gt;ACID 原则&lt;/h3&gt;&lt;p&gt;ACID 是数据库事务的四个核心特性，用于确保数据的可靠性和一致性，尤其在关系型数据库（如 MySQL、PostgreSQL）中至关重要：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;A：原子性（Atomicity）​&lt;/p&gt;
&lt;p&gt;  事务被视为一个不可分割的最小单元，事务中的所有操作要么全部成功，要么全部失败回滚，不会停留在中间状态。例如，银行转账必须同时完成扣款和收款，否则回滚到初始状态。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;C：一致性（Consistency）​&lt;/p&gt;
&lt;p&gt;  事务执行前后，数据库必须保持一致性状态，即所有数据约束、规则（如唯一性、外键）都得到遵守。例如，转账前后账户总金额应保持不变。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;I：隔离性（Isolation）​&lt;/p&gt;
&lt;p&gt;  多个并发事务同时执行时，彼此隔离，互不干扰。数据库通过锁或并发控制机制防止脏读、不可重复读等问题。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;D：持久性（Durability）​&lt;/p&gt;
&lt;p&gt;  事务一旦提交，其对数据的修改就是永久性的，即使系统发生故障（如断电）也不会丢失，通常通过持久化存储（如硬盘）实现。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-cap-原则-1&quot;&gt;CAP 原则&lt;/h3&gt;&lt;p&gt;CAP 理论是分布式系统设计的基础理论，由 Eric Brewer 提出，指出在分布式系统中，以下三个特性无法同时完全满足，最多只能实现其中两个：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;C：一致性（Consistency）​&lt;/p&gt;
&lt;p&gt;  在分布式系统的所有节点上，同一时刻读取的数据都是最新的相同版本。例如，用户在任何节点查询数据，都会得到最新的写入结果，否则返回错误。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;A：可用性（Availability）​&lt;/p&gt;
&lt;p&gt;  系统始终能够响应请求（不保证数据最新），即使部分节点故障，每个请求都能获得非错误响应。例如，即使数据未同步，系统也返回当前可用的数据。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;P：分区容错性（Partition Tolerance）​&lt;/p&gt;
&lt;p&gt;  系统在遇到网络分区（即节点之间因网络问题无法通信）时，仍然能够继续运行。这是分布式系统的基本要求，因为网络分区难以避免。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-cap-的权衡-常见于分布式数据库设计-1&quot;&gt;CAP 的权衡（常见于分布式数据库设计）：&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;p&gt;CP 系统：保证一致性和分区容错性，牺牲可用性。例如，发生网络分区时，系统可能拒绝写入或读取以确保数据一致。代表：MongoDB（通常配置为 CP）、HBase。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;AP 系统：保证可用性和分区容错性，牺牲一致性。例如，发生网络分区时，系统仍可读写，但数据可能临时不一致。代表：Cassandra、DynamoDB。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;CA 系统：保证一致性和可用性，牺牲分区容错性。这类系统通常不是真正的分布式系统，如单机关系数据库。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;article-mysql-1&quot;&gt;MySQL&lt;/h2&gt;
&lt;h3 id=&quot;article-数据类型-1&quot;&gt;数据类型&lt;/h3&gt;&lt;p&gt;📊 MySQL数据类型速查&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;类型&lt;/th&gt;
&lt;th&gt;占用空间&lt;/th&gt;
&lt;th&gt;范围&lt;/th&gt;
&lt;th&gt;用途&lt;/th&gt;
&lt;th&gt;注意事项&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;INT&lt;/td&gt;
&lt;td&gt;4字节&lt;/td&gt;
&lt;td&gt;-2^31~2^31-1&lt;/td&gt;
&lt;td&gt;主键、计数&lt;/td&gt;
&lt;td&gt;最常用&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;BIGINT&lt;/td&gt;
&lt;td&gt;8字节&lt;/td&gt;
&lt;td&gt;-2^63~2^63-1&lt;/td&gt;
&lt;td&gt;分布式ID&lt;/td&gt;
&lt;td&gt;雪花ID&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;VARCHAR(n)&lt;/td&gt;
&lt;td&gt;可变&lt;/td&gt;
&lt;td&gt;0~65535字符&lt;/td&gt;
&lt;td&gt;姓名、标题&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;最推荐&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;DECIMAL(10,2)&lt;/td&gt;
&lt;td&gt;可变&lt;/td&gt;
&lt;td&gt;精确小数&lt;/td&gt;
&lt;td&gt;金额、财务&lt;/td&gt;
&lt;td&gt;无精度误差&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;DATETIME&lt;/td&gt;
&lt;td&gt;8字节&lt;/td&gt;
&lt;td&gt;1000~9999年&lt;/td&gt;
&lt;td&gt;创建时间&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;最推荐&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;TIMESTAMP&lt;/td&gt;
&lt;td&gt;4字节&lt;/td&gt;
&lt;td&gt;1970~2038年&lt;/td&gt;
&lt;td&gt;自动时间戳&lt;/td&gt;
&lt;td&gt;2038年问题&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h3 id=&quot;article-基础语法-1&quot;&gt;基础语法&lt;/h3&gt;
&lt;h3 id=&quot;article-sql三大组成部分-1&quot;&gt;SQL三大组成部分&lt;/h3&gt;
&lt;h4 id=&quot;article-ddl-数据定义语言-1&quot;&gt;DDL（数据定义语言）&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;SQL&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 创建数据库&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;CREATE&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; DATABASE&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; school&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; CHARACTER&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; SET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; utf8mb4;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 创建表&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;CREATE&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; TABLE&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; students&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;id &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;INT&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; PRIMARY KEY&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; AUTO_INCREMENT,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; VARCHAR&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;50&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;NOT NULL&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;age &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;INT&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;created_at &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;DATETIME&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; DEFAULT&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; CURRENT_TIMESTAMP&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 修改表结构&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;ALTER&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; TABLE&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; students &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;ADD&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; COLUMN email &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;VARCHAR&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-dml-数据操作语言-1&quot;&gt;DML（数据操作语言）&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;SQL&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 插入数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;INSERT INTO&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; students(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, age) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;VALUES&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;张三&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;18&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 查询数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;SELECT&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; FROM&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; students &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;WHERE&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; age &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 17&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;SELECT&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; FROM&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; students &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;WHERE&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; name&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; LIKE&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &apos;%张%&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 更新数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;UPDATE&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; students &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;SET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; age &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 20&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; WHERE&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; id &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 删除数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;DELETE&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; FROM&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; students &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;WHERE&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; id &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-dcl-权限控制-1&quot;&gt;DCL（权限控制）&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;SQL&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 创建用户&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;CREATE&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; USER&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; &apos;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;username&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;&apos;@&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;localhost&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; IDENTIFIED &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;BY&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &apos;password&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 授权&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;GRANT&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; SELECT&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;INSERT&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; school.&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; TO&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &apos;username&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;@&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;localhost&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 撤销权限&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;REVOKE&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; INSERT&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; school.&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; FROM&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &apos;username&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;@&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;localhost&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-事务-transaction-1&quot;&gt;事务（Transaction）&lt;/h3&gt;
&lt;h4 id=&quot;article-acid原则-1&quot;&gt;ACID原则&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;A&lt;/strong&gt;tomicity（原子性） - 全部成功或全部失败&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;C&lt;/strong&gt;onsistency（一致性） - 数据状态合法转移&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;I&lt;/strong&gt;solation（隔离性） - 事务间互不干扰&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;D&lt;/strong&gt;urability（持久性） - 提交后数据不丢失&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-事务流程-1&quot;&gt;事务流程&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;SQL&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 开启事务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;START TRANSACTION&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 执行多条SQL&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;UPDATE&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; account &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;SET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; balance &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; balance &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 100&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; WHERE&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; id &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;UPDATE&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; account &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;SET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; balance &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; balance &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 100&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; WHERE&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; id &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 提交或回滚&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;COMMIT&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- 成功提交&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;-- ROLLBACK;  -- 失败回滚&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-并发问题与隔离级别-1&quot;&gt;并发问题与隔离级别&lt;/h4&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;隔离级别&lt;/th&gt;
&lt;th&gt;脏读&lt;/th&gt;
&lt;th&gt;不可重复读&lt;/th&gt;
&lt;th&gt;幻读&lt;/th&gt;
&lt;th&gt;MySQL默认&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;读未提交&lt;/td&gt;
&lt;td&gt;✅&lt;/td&gt;
&lt;td&gt;✅&lt;/td&gt;
&lt;td&gt;✅&lt;/td&gt;
&lt;td&gt;❌&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;读已提交&lt;/td&gt;
&lt;td&gt;❌&lt;/td&gt;
&lt;td&gt;✅&lt;/td&gt;
&lt;td&gt;✅&lt;/td&gt;
&lt;td&gt;❌&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;可重复读&lt;/td&gt;
&lt;td&gt;❌&lt;/td&gt;
&lt;td&gt;❌&lt;/td&gt;
&lt;td&gt;✅*&lt;/td&gt;
&lt;td&gt;✅&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;串行化&lt;/td&gt;
&lt;td&gt;❌&lt;/td&gt;
&lt;td&gt;❌&lt;/td&gt;
&lt;td&gt;❌&lt;/td&gt;
&lt;td&gt;❌&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;⚠️ &lt;strong&gt;注意&lt;/strong&gt;：MySQL默认使用**可重复读(Repeatable Read)**级别，是性能与一致性的最佳平衡。&lt;/p&gt;

&lt;h3 id=&quot;article-go操作mysql-1&quot;&gt;Go操作MySQL&lt;/h3&gt;
&lt;h4 id=&quot;article-原生sql方式-1&quot;&gt;原生SQL方式&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 安装驱动&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// go get github.com/go-sql-driver/mysql&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;database/sql&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    _ &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/go-sql-driver/mysql&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 连接数据库&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;dsn &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;root:123456@tcp(127.0.0.1:3306)/school?charset=utf8mb4&amp;amp;parseTime=True&amp;amp;loc=Local&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;db, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sql.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Open&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;mysql&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,dsn)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 插入数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;result, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exec&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;INSERT INTO students(name, age) VALUES (?, ?)&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;王五&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;16&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 查询单条&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; name &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; age &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;QueryRow&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;SELECT name, age FROM students WHERE id = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scan&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;name, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;age)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 查询多条&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;rows, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Query&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;SELECT id, name FROM students WHERE age &amp;gt; ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;15&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rows.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rows.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; id &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; name &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    rows.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scan&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;id, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;name)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(id, name)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 事务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;tx, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Begin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exec&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;UPDATE students SET age = age + 1 WHERE id = 1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Exec&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;INSERT INTO score_log(student_id, change_amount) VALUES (1, 1)&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Commit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 或 tx.Rollback()&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-gorm-1&quot;&gt;Gorm&lt;/h2&gt;
&lt;h3 id=&quot;article-安装与连接-1&quot;&gt;安装与连接&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 安装GORM&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// go get -u gorm.io/gorm&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// go get -u gorm.io/driver/mysql&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gorm.io/driver/mysql&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gorm.io/gorm&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 连接数据库&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;dsn &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;root:123456@tcp(127.0.0.1:3306)/school?charset=utf8mb4&amp;amp;parseTime=True&amp;amp;loc=Local&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;db, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; gorm.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Open&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(mysql.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Open&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(dsn), &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gorm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{})&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-定义模型-1&quot;&gt;定义模型&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Student&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ID        &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;uint&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;      gorm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;primaryKey&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Name      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Age       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Grade     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    CreatedAt &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Time&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 自定义表名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;TableName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;students&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 自动建表&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AutoMigrate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{})&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-crud操作-1&quot;&gt;CRUD操作&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建（Create）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;student &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Student&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Name: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;张三&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, Age: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;18&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, Grade: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;高三&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Create&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;student)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;插入成功，ID: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, student.ID)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 查询单条（Read）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; stu &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;First&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;stu, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)                    &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 按主键查询&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;First&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;stu, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;name = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;张三&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)     &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 按条件查询&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 查询多条&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; students []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;age &amp;gt; ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;17&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Find&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;students)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 更新（Update）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;id = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Update&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;age&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;20&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;id = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Updates&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Age: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;20&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, Grade: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;高三&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 删除（Delete）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Delete&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-链式查询-1&quot;&gt;链式查询&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; list []&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;age &amp;gt; ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;16&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;grade = ?&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;高三&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Order&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;age desc&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Limit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;10&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Find&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;list)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-gorm事务-1&quot;&gt;GORM事务&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 写法1：自动事务（推荐）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Transaction&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;tx&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gorm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DB&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Create&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Name: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;A&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}).Error; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 自动回滚 &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Create&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Name: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;B&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}).Error; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 自动回滚&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 自动提交&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 写法2：手动事务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;tx &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; db.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Begin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Create&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Name: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;A&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Model&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Student&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Where&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;id=1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Update&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;age&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;20&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;tx.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Commit&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 或 tx.Rollback()&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-其他注意事项-1&quot;&gt;其他注意事项&lt;/h3&gt;&lt;ol&gt;
&lt;li&gt;&lt;code&gt;LIKE&lt;/code&gt; 语句支持模糊搜索，语法如下：&lt;ul&gt;
&lt;li&gt;&lt;code&gt;db.Where(&quot;name LIKE ?&quot;,&quot;%&quot;+Name+&quot;%&quot;)&lt;/code&gt; ： 参数 ：%Name只搜索关键字末尾，%Name%不限位置，Name%首关键字&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;SQL注入：攻击者可以通过直接在数据里塞入SQL语句实现非法调用数据库，好在Gorm会自动防范SQL注入，且一般情况下使用？作为索引&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-sql/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>数据库</category></item><item><title>Web编程中如何实现鉴权与JWT的详解</title><link>https://www.claran-blog.work/posts/go-jwt/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-jwt/</guid><description>Go-Web中的JWT中间件和鉴权操作学习.</description><pubDate>Thu, 06 Nov 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-基础知识-1&quot;&gt;基础知识&lt;/h2&gt;
&lt;h3 id=&quot;article-鉴权-1&quot;&gt;鉴权&lt;/h3&gt;&lt;blockquote&gt;
&lt;p&gt;计网和Gin基础知识：&lt;strong&gt;&lt;a href=&quot;https://www.claran-blog.work/go-gin/&quot;&gt;Link&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;我们都知道 HTTP 协议是&lt;strong&gt;无状态&lt;/strong&gt;的，所谓的无状态就是客户端每次想要与服务端通信，都必须重新与服务端链接，意味着请求一次客户端和服务端就连接一次，下一次请求与上一次请求是&lt;strong&gt;没有关系&lt;/strong&gt;的&lt;/p&gt;
&lt;p&gt;这种无状态的方式就会存在一个问题：如何判断两次请求的是同一个人？就好比用户在页面 A 发起请求获取个人信息，然后在另一个页面同样发起请求获取个人信息，我们如何确定这俩个请求是同一个人发的呢？&lt;/p&gt;
&lt;p&gt;为了解决这种问题，我们就迫切需要一种方式知道发起请求的客户端是谁？此时，cookie、token、session 就出现了，它们就可以解决客户端标识的问题，甚至是解决权限问题&lt;/p&gt;

&lt;h3 id=&quot;article-cookie-session-1&quot;&gt;cookie &amp;amp; session&lt;/h3&gt;&lt;p&gt;通常情况下，cookie 和 session 都是结合着来用&lt;/p&gt;
&lt;p&gt;因此，这里我们就将 cookie 和 session 结合着来用&lt;/p&gt;

&lt;h4 id=&quot;article-cookie-1&quot;&gt;cookie&lt;/h4&gt;
&lt;h5 id=&quot;article-概述-1&quot;&gt;概述&lt;/h5&gt;&lt;p&gt;Cookie 是一种在客户端存储数据的技术，它是由服务器发送给客户端的小型文本文件，存储在客户端的浏览器中,大小限制大致在 4KB 左右&lt;/p&gt;
&lt;p&gt;在客户端发送请求时，浏览器会自动将相应的 Cookie 信息发送给服务器，服务器通过读取 Cookie 信息，就可以判断该请求来自哪个客户端&lt;/p&gt;
&lt;p&gt;因此，Cookie 可以用于存储用户的登录状态、购物车信息等&lt;/p&gt;
&lt;p&gt;在以前很多开发人员通常用 cookie 来存储各种数据，后来随着更多浏览器存储方案的出现，cookie 存储数据这种方式逐渐被取代，主要原因有如下:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;cookie 有存储大小限制，4KB 左右&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;字符编码为 Unicode，不支持直接存储中文&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;数据可以被轻易查看&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;h5 id=&quot;article-流程图-1&quot;&gt;流程图&lt;/h5&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-JWT1.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-session-1&quot;&gt;session&lt;/h4&gt;
&lt;h5 id=&quot;article-概述-2&quot;&gt;概述&lt;/h5&gt;&lt;p&gt;session 由服务端创建&lt;/p&gt;
&lt;p&gt;当一个请求发送到服务端时，服务器会检索该请求里面有没有包含 sessionId 标识，如果包含了 sessionId，则代表服务端已经和客户端创建过 session，然后就通过这个 sessionId 去查找真正的 session，如果没找到，则为客户端创建一个新的 session，并生成一个新的 sessionId 与 session 对应，然后在响应的时候将 sessionId 给客户端，通常是存储在 cookie 中。如果在请求中找到了真正的 session，验证通过，正常处理该请求&lt;/p&gt;
&lt;p&gt;每一个客户端与服务端连接，服务端都会为该客户端创建一个 session，并将 session 的唯一标识 sessionId 通过设置 Set-Cookie 头的方式响应给客户端，客户端将 sessionId 存到 cookie 中。&lt;/p&gt;

&lt;h5 id=&quot;article-流程图-2&quot;&gt;流程图&lt;/h5&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-JWT2.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-token-1&quot;&gt;token&lt;/h3&gt;
&lt;h5 id=&quot;article-概述-3&quot;&gt;概述&lt;/h5&gt;&lt;p&gt;Token 是一种在客户端和服务端之间传递身份信息的方式&lt;/p&gt;
&lt;p&gt;当用户登录成功后，服务端会生成一个 Token，将其发送给客户端&lt;/p&gt;
&lt;p&gt;客户端在后续的请求中，需要将 Token 携带在请求头或请求参数中&lt;/p&gt;
&lt;p&gt;服务端通过验证 Token 的合法性，就可以确定该请求来自哪个用户，并且可以根据用户的权限进行相应的操作&lt;/p&gt;

&lt;h4 id=&quot;article-组成-1&quot;&gt;组成&lt;/h4&gt;&lt;p&gt;Token是一个由一串字符组成的令牌，用于在计算机系统中进行身份验证和授权&lt;/p&gt;
&lt;p&gt;token通常由三个部分组成：标头、有效载荷、签名&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;标头（Header）：包含了加密算法和类型，用于指定如何对有效载荷进行编码和签名。常用的算法有HMAC、RSA、SHA等&lt;/li&gt;
&lt;li&gt;有效载荷（Payload）：包含了一些信息，如用户ID、角色、权限等，用于验证身份和授权。有效载荷可以是加密的，也可以是明文的&lt;/li&gt;
&lt;li&gt;签名（Signature）：是对标头和有效载荷进行密钥签名后得到的值，用于验证token的完整性和真实性&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;一个完整的token包含了标头、有效载荷和签名三个部分，它们一起构成了一个安全的令牌，用于进行身份验证和授权。&lt;/p&gt;

&lt;h4 id=&quot;article-认证流程-access-token-1&quot;&gt;认证流程（Access token）&lt;/h4&gt;&lt;ol&gt;
&lt;li&gt;客户端使用用户名跟密码请求登录&lt;/li&gt;
&lt;li&gt;服务端收到请求，去验证用户名与密码&lt;/li&gt;
&lt;li&gt;验证成功后，服务端会签发一个 token 并把这个 token 发送给客户端&lt;/li&gt;
&lt;li&gt;客户端收到 token 以后，会把它存储起来，比如放在 localStorage 里&lt;/li&gt;
&lt;li&gt;客户端每次发起请求的时候需要把 token 放到请求的 Header 里传给服务端&lt;/li&gt;
&lt;li&gt;服务端收到请求，然后去验证客户端请求里面带着的 token ，如果验证成功，就向客户端返回请求的数据&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-JWT3.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-refresh-token-1&quot;&gt;Refresh Token&lt;/h4&gt;&lt;p&gt;另外一种 token——refresh token&lt;/p&gt;
&lt;p&gt;refresh token 是专用于刷新 access token 的 token。如果没有 refresh token，也可以刷新 access token，但每次刷新都要用户输入登录用户名与密码，会很麻烦。有了 refresh token，可以减少这个麻烦，客户端直接用 refresh token 去更新 access token，无需用户进行额外的操作&lt;/p&gt;
&lt;p&gt;Access Token 的有效期比较短，当 Acesss Token 由于过期而失效时，使用 Refresh Token 就可以获取到新的 Token，如果 Refresh Token 也失效了，用户就只能重新登录了&lt;/p&gt;
&lt;p&gt;Refresh Token 及过期时间是存储在服务器的数据库中，只有在申请新的 Acesss Token 时才会验证，不会对业务接口响应时间造成影响，也不需要向 Session 一样一直保持在内存中以应对大量的请求&lt;/p&gt;

&lt;h3 id=&quot;article-jwt-1&quot;&gt;JWT&lt;/h3&gt;
&lt;h4 id=&quot;article-概述-4&quot;&gt;概述&lt;/h4&gt;&lt;p&gt;JSON Web Token（简称 JWT）是目前最流行的跨域认证解决方案，是一种认证授权机制，是token的一种实现形式&lt;/p&gt;
&lt;p&gt;JWT 是为了在网络应用环境间传递声明而执行的一种基于 JSON 的开放标准。、&lt;/p&gt;
&lt;p&gt;JWT 的声明一般被用来在身份提供者和服务提供者间传递被认证的用户身份信息，以便于从资源服务器获取资源&lt;/p&gt;
&lt;p&gt;比如用在用户登录上。 可以使用 HMAC 算法或者是 RSA 的公/私秘钥对 JWT 进行签名&lt;/p&gt;
&lt;p&gt;因为数字签名的存在，这些传递的信息是可信的。&lt;/p&gt;

&lt;h4 id=&quot;article-流程图-3&quot;&gt;流程图&lt;/h4&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-JWT4.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-JWT6.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-组成-2&quot;&gt;组成&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;JWT 生成示例：&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Header:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;alg&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;HS256&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;typ&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;JWT&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Payload:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;114514&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;role&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;admin&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;  &quot;exp&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1716579600&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-JWT5.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;生成的 JWT：&lt;/strong&gt;&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;eyJ1c2VyX2lkIjoxMjMsInJvbGUiOiJhZG1pbiIsImV4cCI6MTcxNjU3OTYwMH0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;.&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;abc123signature&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;客户端：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;接收到服务器返回的 JWT，将其存储在客户端（通常是 &lt;code&gt;localStorage&lt;/code&gt; 或 &lt;code&gt;sessionStorage&lt;/code&gt;也可以是cookie）&lt;/li&gt;
&lt;li&gt;后续请求中，客户端会将 JWT 作为凭证发送给服务器&lt;/li&gt;
&lt;li&gt;在请求受保护资源时，客户端通过 HTTP 请求头将 JWT 发送到服务器&lt;/li&gt;
&lt;li&gt;请求头中通常使用 &lt;code&gt;Authorization: Bearer &amp;lt;token&amp;gt;&lt;/code&gt; 格式&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;服务端&lt;/strong&gt;：&lt;/p&gt;
&lt;p&gt;1.检查请求头中的 &lt;code&gt;Authorization&lt;/code&gt; 是否包含 JWT。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;Authorization: Bearer &amp;lt;具体的token字符串&amp;gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;2.提取 JWT 并验证：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;**签名验证：**使用密钥验证签名是否正确，确保 Token 未被篡改。&lt;/li&gt;
&lt;li&gt;**过期时间验证：**检查 &lt;code&gt;exp&lt;/code&gt; 字段是否未过期。&lt;/li&gt;
&lt;li&gt;**其他验证：**检查 &lt;code&gt;iss&lt;/code&gt;（发行者）和 &lt;code&gt;aud&lt;/code&gt;（受众）是否匹配。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;验证成功后，解析 &lt;code&gt;Payload&lt;/code&gt;，提取用户信息和权限。&lt;/p&gt;
&lt;p&gt;如果 Token 无效或过期，返回 401 Unauthorized 错误&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;因为 JWT 是自包含的（内部包含了一些会话信息），因此减少了需要查询数据库的需要&lt;/p&gt;
&lt;p&gt;因为用户的状态不再存储在服务端的内存中，所以这是一种无状态的认证机制生成&lt;/p&gt;

&lt;h2 id=&quot;article-jwt代码实现-1&quot;&gt;JWT代码实现&lt;/h2&gt;
&lt;h3 id=&quot;article-依赖-1&quot;&gt;依赖：&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;gin框架: &lt;code&gt;go get -u github.com/gin-gonic/gin&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;JWT: &lt;code&gt;go get -u github.com/golang-jwt/jwt/v4&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;time包（存储Expiration过期时间）&lt;/li&gt;
&lt;li&gt;strings包（分解请求头信息）&lt;/li&gt;
&lt;li&gt;errors包（返回错误信息）&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-基础知识-2&quot;&gt;基础知识&lt;/h3&gt;
&lt;h4 id=&quot;article-声明-claims-1&quot;&gt;声明（Claims）&lt;/h4&gt;&lt;p&gt;JWT声明默认信息如下：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;声明简称&lt;/th&gt;
&lt;th&gt;英文全称&lt;/th&gt;
&lt;th&gt;含义与作用&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;iss&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Issuer&lt;/td&gt;
&lt;td&gt;JWT的签发者，标识创建并签发该令牌的实体（例如某个认证服务器或服务）。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;sub&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Subject&lt;/td&gt;
&lt;td&gt;JWT的主题，标识该令牌所指向的主体（通常是用户ID），即令牌是关于谁的。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;aud&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Audience&lt;/td&gt;
&lt;td&gt;JWT的受众，指定该令牌意图提供给哪个或哪些接收方使用，接收方需验证自身是否在受众列表中。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;exp&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Expiration Time&lt;/td&gt;
&lt;td&gt;JWT的过期时间，一个Unix时间戳，超过此时间后令牌应被视为无效。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;nbf&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Not Before&lt;/td&gt;
&lt;td&gt;JWT的生效时间，一个Unix时间戳，在此时间之前令牌应被视为无效。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;iat&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Issued At&lt;/td&gt;
&lt;td&gt;JWT的签发时间，标识令牌是何时被创建的。&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;jti&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;JWT ID&lt;/td&gt;
&lt;td&gt;JWT的唯一标识符，为令牌提供一个唯一标识，常用于防止同一令牌被重复使用（重放攻击）。&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h4 id=&quot;article-type-token-1&quot;&gt;type token:&lt;/h4&gt;&lt;p&gt;在jwt中，jwt.token是一种数据类型，用于储存token信息，详细数据如下：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Token&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Raw       &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                 // 原始 Token 字符串&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Method    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SigningMethod&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;          // 签名方法&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Header    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 头部信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Claims    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Claims&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                 // 声明信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Signature []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                 // 签名部分&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Valid     &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;                   // 是否验证通过&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-实现流程-1&quot;&gt;实现流程&lt;/h3&gt;
&lt;h4 id=&quot;article-1-设置jwt默认配置-1&quot;&gt;1. 设置JWT默认配置&lt;/h4&gt;&lt;p&gt;在&lt;code&gt;config&lt;/code&gt;包下：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; config&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// JWTConfig JWT配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; JWTConfig&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	SecretKey      &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Issuer         &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ExpirationTime &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Duration&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// DefaultJWTConfig 默认的JWT配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; DefaultJWTConfig &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; JWTConfig&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	SecretKey:      &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;this_is_secret_key&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 秘钥，一般不保存在源代码中&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Issuer:         &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;jwt_study_demo&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,     &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 签发者&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	ExpirationTime: time.Hour &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 24&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 7&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,   &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 七天有效期&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;以上代码设置了JWT的默认配置DefaultJWTConfig，用于后续JWT配置的使用&lt;/p&gt;

&lt;h4 id=&quot;article-2-设置jwt具体方法-1&quot;&gt;2. 设置JWT具体方法&lt;/h4&gt;&lt;p&gt;在&lt;code&gt;util&lt;/code&gt;包下：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; utils&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GoGin/JWT/config&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/golang-jwt/jwt/v5&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// GenerateToken 生成 tokenString&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; GenerateToken&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;userID&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;username&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//获取默认JWT配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	jwtConfig &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; config.DefaultJWTConfig&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	//创建JWT声明&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	claims &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; jwt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MapClaims&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;iss&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:      jwtConfig.Issuer,                                &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 签发者&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;sub&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:      userID,                                          &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 指向主体&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;iat&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:      time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),                               &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// issued At -- 签发时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;exp&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:      time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(jwtConfig.ExpirationTime).&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 有效期&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;nbf&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:      time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(),&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;		&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: username, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: userID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//&quot;aud&quot; : ... // 受众&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//&quot;jti&quot; : ... // 唯一标识符&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 生成Token，算法：HS256&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	token &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; jwt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewWithClaims&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(jwt.SigningMethodHS256, claims) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// jwt.NewWithClaims - 利用某算法为claims生成token&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 对token签名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	tokenString, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; token.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SignedString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(jwtConfig.SecretKey)) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// token.SignedString(key) - 为token进行密钥key签名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tokenString, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ValidateTokenString 验证 JWT Token&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ValidateTokenString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;tokenString&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;jwt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Token&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// *jwt.Token - 一种数据类型，表示token类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 获取token&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	token, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; jwt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Parse&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tokenString, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;token&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;jwt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Token&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// jwt.Parse(tokenString,key) - 用密钥key解析并验证JWT，此处func为验证获取密钥&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 验证签名方式是否正确&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; _, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; token.Method.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;jwt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SigningMethodHMAC&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Method为类型token的内部变量，表示签名方法   此处为类型断言，判断是否为HMAC方法&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, jwt.ErrSignatureInvalid &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 返回错误：签名验证失败&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 返回密钥&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(config.DefaultJWTConfig.SecretKey), &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; token, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ExtractClaims 提取 JWT 声明信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ExtractClaims&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;token&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;jwt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Token&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;jwt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MapClaims&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; claims, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; token.Claims.(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;jwt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MapClaims&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;); ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; token.Valid { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// token.Claims.(jwt.MapClaims) 表示对token的声明信息进行类型断言; token.Valid 表示验证是否通过&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; claims, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 通过&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	} &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;else&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, jwt.ErrTokenInvalidClaims &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 返回错误：jwt声明信息无效&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;以上代码创建了三个JWT方法：生成 tokenString、验证 JWT Token和提取 JWT 声明信息，注意这三个方法的参数以及返回值&lt;/p&gt;

&lt;h4 id=&quot;article-3-创建jwt认证中间件-1&quot;&gt;3. 创建JWT认证中间件&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; middleware&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GoGin/JWT/utils&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;errors&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/gin-gonic/gin&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/golang-jwt/jwt/v5&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net/http&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strings&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; JWTAuthMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HandlerFunc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 获取请求头中的Authorization字段，err：无该字段&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		authHeader &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetHeader&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Authorization&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 从请求头获取Authorization字段&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; authHeader &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {                      &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 无该字段&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusUnauthorized, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				&quot;error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Authorization required&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Abort&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 解析，获取token，err：格式不合法&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		parts &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SplitN&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(authHeader, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot; &quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 将Authorization: Bearer  &amp;lt;token&amp;gt; 提取为[0]{Bearer}和[1]{&amp;lt;token&amp;gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; parts[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;Bearer&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ||&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(parts) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Authorization 信息格式不合法&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusUnauthorized, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				&quot;error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;invalid authorization header format&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Abort&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		tokenString &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; parts[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 验证token，err：过期 / 非法&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		token, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; utils.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ValidateTokenString&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tokenString) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 验证tokenString&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; errors.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Is&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err, jwt.ErrTokenExpired) { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 错误：过期&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusUnauthorized, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;					&quot;error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;token is expired&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;				c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Abort&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;				return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusUnauthorized, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{ &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 错误：非法&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				&quot;error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;invalid token&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Abort&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//提取声明信息，err：claims失败&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		claims, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; utils.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ExtractClaims&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(token)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusInternalServerError, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;				&quot;error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;extract claims failed&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Abort&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		// 保存claims到上下文&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Set&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, claims[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;])&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Set&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, claims[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;])&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//c.nest&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;以上代码创建了一个JWT认证中间件JWTAuthMiddleware，路由注册该中间件后，对该路由的请求会流过该中间件，验证请求头中是否含有token以及token是否合法&lt;/p&gt;

&lt;h4 id=&quot;article-4-为受保护的路由注册中间件-1&quot;&gt;4. 为受保护的路由注册中间件&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; routes&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GoGin/JWT/middleware&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/gin-gonic/gin&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GoGin/JWT/handler&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; InitRouter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	r &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; gin.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 登录路由&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;POST&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/login&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, handler.LoginHandler)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 受保护的路由组&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	protected &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Group&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/api&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	protected.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Use&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(middleware.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JWTAuthMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		protected.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/info&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, handler.InfoHandler)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;现在访问&lt;code&gt;http://localhost:8080/api/info&lt;/code&gt; 会验证JWT&lt;/p&gt;

&lt;h3 id=&quot;article-实现效果-1&quot;&gt;实现效果&lt;/h3&gt;&lt;p&gt;Demo：&lt;a href=&quot;https://github.com/Claran309/Go-Demo-Login_And_Register&quot;&gt;Github&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;Article：&lt;a href=&quot;https://www.claran-blog.work/2025/11/04/Go-Demo%EF%BC%9A%E7%94%A8%E6%88%B7%E6%B3%A8%E5%86%8C%E4%B8%8E%E7%99%BB%E5%BD%95%E7%B3%BB%E7%BB%9F/&quot;&gt;My-Blog&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;使用Postman测试api后：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Web6.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Web7.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-jwt/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>Go-Demo：用户注册与登录系统</title><link>https://www.claran-blog.work/posts/go-user-demo/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-user-demo/</guid><description>学习过程中写的一个用户相关的CRUD基础Demo.</description><pubDate>Tue, 04 Nov 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-github-1&quot;&gt;&lt;a href=&quot;https://github.com/Claran309/Go-My_Demo_1&quot;&gt;Github&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;h3 id=&quot;article-版本演进历程-1&quot;&gt;版本演进历程&lt;/h3&gt;
&lt;h4 id=&quot;article-v1-基础版本-1&quot;&gt;V1 - 基础版本&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;基于内存的临时数据存储&lt;/li&gt;
&lt;li&gt;外层并发锁保证线程安全&lt;/li&gt;
&lt;li&gt;基础的username/email注册登录系统&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-项目结构-1&quot;&gt;项目结构&lt;/h5&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Web3.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;hr /&gt;

&lt;h4 id=&quot;article-v2-认证升级-1&quot;&gt;V2 - 认证升级&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;数据格式从前端表单升级为JSON&lt;/li&gt;
&lt;li&gt;新增user_id作为唯一用户标识&lt;/li&gt;
&lt;li&gt;引入JWT认证机制&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-项目结构-2&quot;&gt;项目结构&lt;/h5&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Web5.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h5 id=&quot;article-postman-1&quot;&gt;Postman&lt;/h5&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Web6.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Web7.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;hr /&gt;

&lt;h4 id=&quot;article-v2-1-架构优化-1&quot;&gt;V2.1 - 架构优化&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;重构项目结构，提升代码规范性&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;

&lt;h4 id=&quot;article-v3-设计模式升级-1&quot;&gt;V3 - 设计模式升级&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;采用面向接口编程思想&lt;/li&gt;
&lt;li&gt;实现依赖注入架构&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-项目结构-3&quot;&gt;项目结构&lt;/h5&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Demo1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;hr /&gt;

&lt;h4 id=&quot;article-v4-数据持久化-1&quot;&gt;V4 - 数据持久化&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;数据存储层重构：内存存储 → MySQL持久化存储&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-项目结构-4&quot;&gt;项目结构&lt;/h5&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Demo2.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-v4-1-安全增强-1&quot;&gt;V4.1 - 安全增强&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;敏感信息配置化，使用.env文件管理&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;

&lt;h4 id=&quot;article-v5-业务功能扩展-1&quot;&gt;V5 - 业务功能扩展&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;支持refresh_token机制&lt;/li&gt;
&lt;li&gt;基于jwt_role的身份鉴权系统&lt;/li&gt;
&lt;li&gt;新增完整的选课系统功能：&lt;ul&gt;
&lt;li&gt;选课/退课操作&lt;/li&gt;
&lt;li&gt;课程列表查询&lt;/li&gt;
&lt;li&gt;已选课程查询&lt;/li&gt;
&lt;li&gt;管理员课程添加权限&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-项目结构-5&quot;&gt;项目结构&lt;/h5&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Demo3.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;hr /&gt;

&lt;h4 id=&quot;article-v6-安全与功能完善-1&quot;&gt;V6 - 安全与功能完善&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;密码加密/解密（bcrypt算法）&lt;/li&gt;
&lt;li&gt;新增To-do-list功能模块：&lt;ul&gt;
&lt;li&gt;新建待办事项&lt;/li&gt;
&lt;li&gt;标记完成并删除&lt;/li&gt;
&lt;li&gt;直接删除事项&lt;/li&gt;
&lt;li&gt;获取已完成/未完成清单&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;

&lt;h4 id=&quot;article-v7-性能优化-1&quot;&gt;V7 - 性能优化&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;引入Redis缓存层，提升系统性能&lt;/li&gt;
&lt;/ul&gt;

&lt;h5 id=&quot;article-项目结构-6&quot;&gt;项目结构&lt;/h5&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;GinProject_Logging&amp;amp;Registering/&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── api/                    # API层代码&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── dao/               # 数据访问层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   ├── cache/         # 缓存实现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │   ├── interface.go    # 缓存接口定义&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │   └── redis.go        # Redis缓存实现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   ├── memory/        # 内存存储实现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   │   └── database.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   └── mysql/         # MySQL存储实现&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       ├── courses_mysql.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       ├── database.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       ├── todo_mysql.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │       └── user_mysql.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── handlers/          # HTTP处理器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   ├── courses_handlers.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   ├── todo_handlers.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   └── user_handlers.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── services/          # 业务逻辑层&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       ├── courses.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       ├── todo.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       └── user.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── cmd/                   # 应用入口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── main.go           # 主程序入口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── internal/              # 内部包&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── config/           # 配置管理&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   └── config.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── middleware/       # 中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   └── JWTMiddleware.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   ├── model/                # 数据模型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   ├── courses.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   ├── jwt.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   ├── request.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   ├── todo.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   │   └── user.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│   └── util/                 # 工具包&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│       └── jwt_util/        # JWT工具&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│           ├── interface.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│           ├── util.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│           ├── password.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;│           └── response.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── .env                  # 环境变量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── .gitignore           # Git忽略文件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── go.mod               # Go模块定义&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── go.sum              # Go模块校验和&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;└── README.md           #项目说明文档&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-user-demo/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category><category>项目</category></item><item><title>随笔.4：第一个期中</title><link>https://www.claran-blog.work/posts/diary4/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/diary4/</guid><description>来到大学的第一个期中.</description><pubDate>Mon, 03 Nov 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;好久没写随笔了&lt;/p&gt;
&lt;p&gt;这段时间有一个很明显的感觉就是，觉得自己学得太慢了&lt;/p&gt;
&lt;p&gt;上周一周5天时间只学了go的并发基础(goroutine,channel,sync等)和http与Gin框架的一部分&lt;/p&gt;
&lt;p&gt;感觉学得太慢了，但是又不可能学快&lt;/p&gt;
&lt;p&gt;而且Leetcode每日一题进度还断了一天. . .&lt;/p&gt;
&lt;p&gt;不过问题不大&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;cyjj之前推了个重邮极客群给我&lt;/p&gt;
&lt;p&gt;感谢学姐&lt;/p&gt;
&lt;p&gt;今天也是进群了，全是大佬，太恐怖了&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;今天把Gin学完了，然后自己搓了一个本地Web小项目&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;有在“开发”,而不是”做题“的感觉了~&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;现在终于搞懂了，后端开发大概就是写Web接口-部署数据库等等的一系列操作&lt;/p&gt;
&lt;p&gt;哎呀说不清楚，反正就是对“开发”这个东西醍醐灌顶！&lt;/p&gt;
&lt;p&gt;爽！&lt;/p&gt;
&lt;p&gt;但是随之而来的问题就是&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;“学的越多，不会的越多，要学的就越多”&lt;/strong&gt;&lt;/p&gt;
&lt;hr /&gt;
&lt;p&gt;一刻都没有为开学而哀悼，紧随其后是&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;期中周！&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;马上要期中考试了！！！！！！&lt;/p&gt;
&lt;p&gt;能请代考吗qwq&lt;/p&gt;
&lt;p&gt;不是只有期末周才狠狠补习吗qwq&lt;/p&gt;
&lt;p&gt;期中考怎么办啊qwq&lt;/p&gt;
&lt;p&gt;校园跑也一次没跑. . .&lt;/p&gt;
&lt;p&gt;嘛，找个时间问问学姐们虚拟机跑校园跑怎么操作好了. . .&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/diary4/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>随笔</category><category>杂项</category></item><item><title>初入Web编程：计网，http，JSON和Gin框架</title><link>https://www.claran-blog.work/posts/go-gin/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-gin/</guid><description>开始正式步入Go-Web编程.</description><pubDate>Sat, 01 Nov 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-计网-基础-1&quot;&gt;计网（基础）&lt;/h2&gt;
&lt;h3 id=&quot;article-5层网络模型-1&quot;&gt;5层网络模型&lt;/h3&gt;&lt;p&gt;在计算机网络中，一般由5层网络模型提供网络服务：&lt;/p&gt;
&lt;p&gt;5层网络模型是计算机网络的经典分层架构，每层负责不同的功能：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;物理层&lt;/strong&gt; - 最底层，定义物理介质上的比特流传输。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;数据链路层&lt;/strong&gt; - 管理相邻节点之间的数据传输，确保物理链路上的可靠性。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;网络层&lt;/strong&gt; - 处理网络间路由和寻址，将数据从源主机发送到目的主机。核心协议是IP协议。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;传输层&lt;/strong&gt; - 负责端到端的通信，确保数据可靠传输。主要协议有TCP（可靠连接）和UDP（无连接服务）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;应用层&lt;/strong&gt; - 最上层，直接面向用户应用程序，提供网络服务接口。常见协议包括HTTP（用于网页浏览）、FTP（文件传输）、DNS（域名解析）等。&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Web1.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-socket协议-1&quot;&gt;Socket协议&lt;/h3&gt;
&lt;h4 id=&quot;article-服务器监听及响应的过程-1&quot;&gt;服务器监听及响应的过程&lt;/h4&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Web2.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;socket : 创建网络通讯起点（监听嵌套字）&lt;/p&gt;
&lt;p&gt;bind : 将socket绑定到特定的地址和端口&lt;/p&gt;
&lt;p&gt;listen : 进入监听状态&lt;/p&gt;

&lt;h4 id=&quot;article-三次握手建立连接-1&quot;&gt;三次握手建立连接&lt;/h4&gt;&lt;p&gt;三次握手是TCP建立可靠连接的过程：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;第一次握手&lt;/strong&gt;：客户端发送SYN=1和序列号seq=x&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;em&gt;目的&lt;/em&gt;：发起连接请求，表示&quot;我想和你建立连接&quot;&lt;/li&gt;
&lt;li&gt;&lt;em&gt;意义&lt;/em&gt;：检查客户端能否正常发送数据，防止无效请求&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;第二次握手&lt;/strong&gt;：服务端响应SYN=1、ACK=1、seq=y、ack=x+1&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;em&gt;目的&lt;/em&gt;：确认收到请求，并同步自己的状态&lt;/li&gt;
&lt;li&gt;&lt;em&gt;意义&lt;/em&gt;：确保服务端活跃且愿意通信&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;第三次握手&lt;/strong&gt;：客户端发送ACK=1、seq=x+1、ack=y+1&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;em&gt;目的&lt;/em&gt;：最终确认连接&lt;/li&gt;
&lt;li&gt;&lt;em&gt;意义&lt;/em&gt;：防止已失效的请求突然到达，建立可靠连接&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;h4 id=&quot;article-四次挥手关闭连接-1&quot;&gt;四次挥手关闭连接&lt;/h4&gt;&lt;p&gt;四次挥手是TCP安全关闭连接的过程：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;第一次挥手&lt;/strong&gt;：主动方发送FIN=1、seq=u&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;em&gt;目的&lt;/em&gt;：请求关闭连接&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;第二次挥手&lt;/strong&gt;：被动方响应ACK=1、ack=u+1&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;em&gt;目的&lt;/em&gt;：确认关闭请求，但可能还有数据要发送&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;第三次挥手&lt;/strong&gt;：被动方发送FIN=1、ACK=1、seq=w、ack=u+1&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;em&gt;目的&lt;/em&gt;：被动方也准备关闭&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;第四次挥手&lt;/strong&gt;：主动方响应ACK=1、ack=w+1&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;em&gt;目的&lt;/em&gt;：最终确认完全关闭&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;h3 id=&quot;article-url-uri-1&quot;&gt;URL/URI&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;URI&lt;/strong&gt;（统一资源标识符）：资源的完整标识，如身份证号&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;URL&lt;/strong&gt;（统一资源定位符）：URI的子集，提供资源位置，如家庭地址&lt;/li&gt;
&lt;li&gt;格式：&lt;code&gt;协议://主机:端口/路径?查询参数#片段&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;article-http基础-1&quot;&gt;HTTP基础&lt;/h2&gt;&lt;p&gt;包：&lt;code&gt;net/http&lt;/code&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-http报文与请求-响应模型-1&quot;&gt;HTTP报文与请求-响应模型&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;请求-响应模型&lt;/strong&gt;是HTTP通信的核心机制：客户端发送请求报文，服务器处理后返回响应报文&lt;/p&gt;

&lt;h4 id=&quot;article-http请求报文-1&quot;&gt;http请求报文&lt;/h4&gt;&lt;p&gt;一个HTTP请求报文由请求行（request line） 、请求头部（header）、空行和请求数据4个部分组成。&lt;/p&gt;

&lt;h5 id=&quot;article-1-请求行-1&quot;&gt;（1）请求行&lt;/h5&gt;&lt;p&gt;请求行是请求报文的起始部分，包含以下内容：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;HTTP方法&lt;/strong&gt;：描述请求的动作（如GET、POST、PUT等）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;目标路径（URI）&lt;/strong&gt;：资源的标识符，不包括域名。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;HTTP版本&lt;/strong&gt;：使用的HTTP协议版本（如HTTP/1.1）。&lt;/li&gt;
&lt;/ul&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;strong&gt;方法&lt;/strong&gt;&lt;/th&gt;
&lt;th&gt;&lt;strong&gt;功能&lt;/strong&gt;&lt;/th&gt;
&lt;th&gt;&lt;strong&gt;是否幂等&lt;/strong&gt;&lt;/th&gt;
&lt;th&gt;&lt;strong&gt;特点&lt;/strong&gt;&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;GET&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;获取服务器上的资源（数据或页面）。&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;- 数据通过 URL 传递&lt;br /&gt;- 不应修改服务器状态&lt;br /&gt;- 适合只读操作&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;POST&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;向服务器发送数据以创建资源或触发操作。&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;- 数据在请求体中&lt;br /&gt;- 用于表单提交、创建资源或触发逻辑&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;PUT&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;更新或创建服务器上的资源（完全替换目标资源）。&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;- 数据在请求体中&lt;br /&gt;- 更新时完全覆盖资源&lt;br /&gt;- 常用于资源的创建或更新操作&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;DELETE&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;删除服务器上的指定资源。&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;- 删除操作&lt;br /&gt;- 调用多次对结果无影响&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;PATCH&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;更新服务器上的资源（部分更新）。&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;- 对资源的部分字段进行修改&lt;br /&gt;- 非幂等（取决于实现方式）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;HEAD&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;类似 GET，但不返回响应体，仅返回响应头。&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;- 用于检查资源是否存在或获取元信息&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;OPTIONS&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;返回服务器支持的 HTTP 方法和选项。&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;- 用于探测服务器支持的能力&lt;br /&gt;- 不对资源状态产生影响&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;TRACE&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;回显收到的请求，主要用于调试和诊断。&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;td&gt;- 直接返回请求内容&lt;br /&gt;- 不常用，可能存在安全隐患&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;CONNECT&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;用于建立隧道连接，通常用于 HTTPS。&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;td&gt;- 用于代理服务器，主要处理加密的 SSL/TLS 隧道&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;blockquote&gt;
&lt;p&gt;幂等操作的效果在执行一次和多次时是相同的&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h5 id=&quot;article-2-请求头-1&quot;&gt;（2）请求头&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;请求头部由关键字/值对组成，每行一对&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;典型的请求头有：&lt;/p&gt;
&lt;p&gt;● Host：请求的主机名，允许多个域名同处一个IP 地址，即虚拟主机;&lt;/p&gt;
&lt;p&gt;● connection：连接方式(close 或 keepalive);&lt;/p&gt;
&lt;p&gt;● Cookie：存储于客户端扩展字段，向同一域名的服务端发送属于该域的cookie;&lt;/p&gt;

&lt;h5 id=&quot;article-3-空行-1&quot;&gt;(3) 空行&lt;/h5&gt;&lt;p&gt;空行用于分隔请求头和请求体。如果没有请求体，空行直接结束报文。&lt;/p&gt;

&lt;h5 id=&quot;article-4-请求体-可选-1&quot;&gt;(4) 请求体（可选）&lt;/h5&gt;&lt;p&gt;请求体包含请求发送的数据，在某些方法（如POST、PUT）中使用。可以是表单数据，JSON数据或上传文件。&lt;/p&gt;

&lt;h4 id=&quot;article-http响应报文-1&quot;&gt;http响应报文&lt;/h4&gt;&lt;p&gt;响应报文由状态行，响应头，空行，响应体组成&lt;/p&gt;

&lt;h5 id=&quot;article-1-状态行-1&quot;&gt;（1）状态行&lt;/h5&gt;&lt;p&gt;状态行是响应报文的起始部分，包含以下内容：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;HTTP版本&lt;/strong&gt;：服务器使用的HTTP版本（如HTTP/1.1）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;状态码&lt;/strong&gt;：用数字表示请求的处理结果（如200、404）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;状态文本&lt;/strong&gt;：对状态码的简短描述（如OK、Not Found）。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;状态码：由3位数字组成，第一个数字定义了响应的类别&lt;/p&gt;

&lt;h6 id=&quot;article-状态码总结表-1&quot;&gt;状态码总结表&lt;/h6&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;类别&lt;/th&gt;
&lt;th&gt;含义&lt;/th&gt;
&lt;th&gt;常见状态码及描述&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;1xx&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;信息性响应&lt;/td&gt;
&lt;td&gt;100 Continue, 101 Switching Protocols&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;2xx&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;成功&lt;/td&gt;
&lt;td&gt;200 OK, 201 Created, 204 No Content&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;3xx&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;重定向&lt;/td&gt;
&lt;td&gt;301 Moved Permanently, 302 Found, 304 Not Modified&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;4xx&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;客户端错误&lt;/td&gt;
&lt;td&gt;400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;5xx&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;服务器错误&lt;/td&gt;
&lt;td&gt;500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h5 id=&quot;article-2-响应头-1&quot;&gt;(2) 响应头&lt;/h5&gt;&lt;p&gt;常见响应头&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Date：消息产生的时间&lt;/li&gt;
&lt;li&gt;Age:（从最初创建开始）响应持续时间&lt;/li&gt;
&lt;li&gt;Server: 向客户端标明服务器程序名称和版本&lt;/li&gt;
&lt;/ul&gt;

&lt;h6 id=&quot;article-3-空行-2&quot;&gt;(3) 空行&lt;/h6&gt;&lt;p&gt;空行用于分隔响应头和响应体。如果没有响应体，空行直接结束报文。&lt;/p&gt;

&lt;h6 id=&quot;article-4-响应体-可选-1&quot;&gt;(4) 响应体（可选）&lt;/h6&gt;&lt;p&gt;响应体包含返回的数据内容，例如HTML页面、JSON数据或文件内容。&lt;/p&gt;

&lt;h4 id=&quot;article-代码实现-了解-1&quot;&gt;代码实现（了解）&lt;/h4&gt;&lt;p&gt;了解完基本概念之后，我们可以从go语言中的http/tcp包来讲讲怎么启动一个服务器&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net/http&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// PingHandler 是一个独立封装的处理函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; PingHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;w&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; http&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ResponseWriter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;r&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;http&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Request&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.Method &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; http.MethodGet {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		http.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(w, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Method Not Allowed&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, http.StatusMethodNotAllowed)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//判断请求方法是否是GET&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	w.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Write&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;pong&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// HelloHandler 返回 &quot;Hello, World!&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; HelloHandler&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;w&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; http&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ResponseWriter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;r&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;http&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Request&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	w.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Write&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Hello, World!&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建自定义的多路复用器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	mux &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; http.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;NewServeMux&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 注册路由，使用封装的处理函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	mux.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HandleFunc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/ping&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, PingHandler)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	mux.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HandleFunc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/hello&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, HelloHandler)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 创建自定义的 HTTP 服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	server &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;http&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Server&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Addr:    &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:8080&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 监听地址和端口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		Handler: mux,     &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 使用自定义的多路复用器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 启动服务器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Server is running at http://localhost:8080&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; server.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ListenAndServe&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Error starting server:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-json基础-1&quot;&gt;JSON基础&lt;/h2&gt;
&lt;h3 id=&quot;article-简介-1&quot;&gt;简介&lt;/h3&gt;&lt;p&gt;JSON 指的是 JavaScript 对象表示法（JavaScript Object Notation）&lt;/p&gt;
&lt;p&gt;其为一种轻量级的数据交换格式&lt;/p&gt;
&lt;p&gt;可以被使用在多种编程语言中，且常用于前后端之间的数据传输&lt;/p&gt;
&lt;p&gt;我们主要学习JSON文本信息存储格式&lt;/p&gt;

&lt;h3 id=&quot;article-语法-1&quot;&gt;语法&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;数据在&lt;code&gt;键/值&lt;/code&gt;对中&lt;/li&gt;
&lt;li&gt;数据由逗号 &lt;code&gt;,&lt;/code&gt; 分隔&lt;/li&gt;
&lt;li&gt;使用斜杆 &lt;code&gt;\&lt;/code&gt; 来转义字符&lt;/li&gt;
&lt;li&gt;大括号 &lt;code&gt;{}&lt;/code&gt; 保存对象&lt;/li&gt;
&lt;li&gt;中括号 &lt;code&gt;[]&lt;/code&gt; 保存数组，数组可以包含多个对象&lt;/li&gt;
&lt;/ul&gt;

&lt;h4 id=&quot;article-json-的两种结构-1&quot;&gt;JSON 的两种结构：&lt;/h4&gt;&lt;ol&gt;
&lt;li&gt;对象：大括号 &lt;code&gt;{}&lt;/code&gt; 保存的对象是一个无序的&lt;code&gt;名称/值&lt;/code&gt;对集合。一个对象以左括号 &lt;code&gt;{&lt;/code&gt; 开始， 右括号 &lt;code&gt;}&lt;/code&gt; 结束。每个&quot;键&quot;后跟一个冒号 &lt;code&gt;:&lt;/code&gt;，&lt;code&gt;名称/值&lt;/code&gt;对使用逗号 &lt;code&gt;,&lt;/code&gt; 分隔。&lt;/li&gt;
&lt;li&gt;数组：中括号 &lt;code&gt;[]&lt;/code&gt; 保存的数组是值（value）的有序集合。一个数组以左中括号 &lt;code&gt;[&lt;/code&gt; 开始， 右中括号 &lt;code&gt;]&lt;/code&gt; 结束，值之间使用逗号 &lt;code&gt;,&lt;/code&gt; 分隔。&lt;/li&gt;
&lt;/ol&gt;

&lt;h4 id=&quot;article-代码示例-1&quot;&gt;代码示例&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//对象&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{   &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;name&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Claran&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;age&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;18&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;university&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;cqupt&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//数组&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[ &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Blue_Archive&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Senren*Banka&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Valorant&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ]&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-gin框架-1&quot;&gt;Gin框架&lt;/h2&gt;&lt;p&gt;尽管&lt;code&gt;http&lt;/code&gt; 包虽然功能齐全，但编写完整的 Web 应用需要重复写大量的基础代码，Web框架对其进行了封装，提供了：&lt;/p&gt;
&lt;p&gt;更强大的路由功能，更简洁的api，更方便的中间件支持，更快的开发效率&lt;/p&gt;

&lt;h3 id=&quot;article-基础语法-1&quot;&gt;基础语法&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;code&gt;gin.Default()&lt;/code&gt;: 创建一个包含基础中间件 (Logger, Recovery) 的 Gin 引擎。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;r.GET(path, handler)&lt;/code&gt;: 定义一个处理 GET 请求的路由。path 是路径，handler 是一个 func(c *gin.Context) 类型的函数。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;c *gin.Context&lt;/code&gt;: 这是 Gin 的核心！它包含了请求和响应的所有信息和方法。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;c.JSON(httpStatus, data)&lt;/code&gt;: 以 JSON 格式返回响应。http.StatusOK 是 200。gin.H 是创建 map[string]interface{} 的便捷方式。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;r.Run()&lt;/code&gt;: 启动 Web 服务器。&lt;/li&gt;
&lt;/ul&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net/http&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 引入 net/http 标准库，用于 HTTP 状态码常量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/gin-gonic/gin&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 1. 创建一个默认的路由引擎&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // Default() 包含了 Logger 和 Recovery 中间件，方便调试和异常恢复&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    r &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; gin.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 2. 定义一个 GET 路由 和对应的处理函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 当访问 /ping 时，会执行后面的匿名函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/ping&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 3. 使用 c.JSON 返回 JSON 格式的响应&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 参数：HTTP 状态码，响应数据 (gin.H 是 map[string]interface{} 的快捷方式)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusOK, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;pong!&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:  &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;ok&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 4. 启动 HTTP 服务，默认监听在 0.0.0.0:8080&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 你也可以指定端口，例如 r.Run(&quot;:9090&quot;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Run&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;       panic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Failed to start Gin server: &quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; +&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;运行后，打开浏览器或使用 curl 访问 ( &lt;a href=&quot;http://localhost:8080/ping&quot;&gt;http://localhost:8080/ping&lt;span&gt;&lt;/span&gt;&lt;/a&gt; ) &lt;/p&gt;
&lt;p&gt;你应该会看到：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;JSON&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;pong!&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;    &quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;ok&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-路由-1&quot;&gt;路由&lt;/h3&gt;&lt;p&gt;路由是 Web 框架的基础，Gin 提供了非常灵活强大的路由功能&lt;/p&gt;

&lt;h4 id=&quot;article-基础-http-方法-1&quot;&gt;基础 HTTP 方法&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/someGet&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, getting)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;POST&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/somePost&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, posting)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PUT&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/somePut&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, putting)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DELETE&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/someDelete&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, deleting)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PATCH&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/somePatch&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, patching)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HEAD&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/someHead&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, head)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;OPTIONS&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/someOptions&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, options)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ...对应的处理函数 getting, posting 等需要自行定义&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getting&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;/* ... */&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; posting&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;/* ... */&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-路由参数-1&quot;&gt;路由参数&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 匹配 /users/john, /users/123 等&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/users/:id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 使用 c.Param() 获取路径参数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    userID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Param&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusOK, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: userID})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 也可以有多个参数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/articles/:category/:article_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    category &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Param&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;category&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    articleID &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Param&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;article_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusOK, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;category&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:   category,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;        &quot;article_id&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: articleID,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;访问 &lt;code&gt;http://localhost:8080/users/Claran&lt;/code&gt; 会得到 &lt;code&gt;{&quot;user_id&quot;:&quot;Claran&quot;}&lt;/code&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-查询参数-1&quot;&gt;查询参数&lt;/h4&gt;&lt;p&gt;查询参数是 URL &lt;code&gt;?&lt;/code&gt; 后面的键值对，例如 &lt;code&gt;/search?query=gin&amp;amp;page=1&lt;/code&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net/http&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/gin-gonic/gin&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	r &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; gin.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/search&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		page &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Query&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;page&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		information &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DefaultQuery&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;information&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;none&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		extra, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GetQuery&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;extra&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ok {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			extra &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;none&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusOK, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;page&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:        page,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;information&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: information,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;extra&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:       extra,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Run&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;:8080&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		panic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// http://localhost:8080/search?page=3&amp;amp;information=%E9%87%8D%E5%BA%86%E9%82%AE%E7%94%B5%E5%A4%A7%E5%AD%A6&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;&lt;code&gt;http://localhost:8080/search?page=3&amp;amp;information=%E9%87%8D%E5%BA%86%E9%82%AE%E7%94%B5%E5%A4%A7%E5%AD%A6&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;会得到 &lt;code&gt;{&quot;extra&quot;:&quot;none&quot;,&quot;page&quot;:&quot;3&quot;,&quot;information&quot;:&quot;重庆邮电大学&quot;}&lt;/code&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-路由分组-1&quot;&gt;路由分组&lt;/h4&gt;&lt;p&gt;当有多个路由共享相同的前缀（例如 API 版本 &lt;code&gt;/api/v1&lt;/code&gt;）或需要应用相同的中间件时，路由分组非常有用&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建一个 /api/v1 的路由组&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;v1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Group&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/api/v1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{ &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 可以用花括号增加可读性&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    v1.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/users&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;/* 获取用户列表 */&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusOK, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;users&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;user2&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    v1.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;POST&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/users&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;/* 创建用户 */&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusCreated, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;message&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;User created&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 可以在分组上应用中间件 (后面会讲)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // v1.Use(AuthMiddleware())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 另一个分组&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;v2 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Group&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/api/v2&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    v2.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/products&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;/* ... */&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;现在可以通过 &lt;code&gt;/api/v1/users&lt;/code&gt; 访问用户相关接口了&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3 id=&quot;article-请求处理-1&quot;&gt;请求处理&lt;/h3&gt;
&lt;h4 id=&quot;article-获取表单数据-form-data-1&quot;&gt;获取表单数据（form-data）&lt;/h4&gt;&lt;p&gt;表单，是一个用于手机用户输入信息并将其提交给服务器的数据格式&lt;/p&gt;
&lt;p&gt;例如：&lt;code&gt;username=Claran&amp;amp;password=123456&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;这个表单储存了username和password的信息&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;content-type&lt;/strong&gt; :&lt;code&gt;application/x-www-form-urlencoded 或 multipart/form-data&lt;/code&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;在Gin框架中获取表单数据：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net/http&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/gin-gonic/gin&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	r &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; gin.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;POST&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/login&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		username &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;PostForm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		password &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;DefaultPostForm&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;password&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;none&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//若没检索到则为none&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;		//c.GetPostForm返回两个值，value和ok&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusOK, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;status&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:   &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;logged in&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;password&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: password,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Run&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		panic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//curl.exe -X POST http://localhost:8080/login -d &quot;username=Claran&amp;amp;password=12345679&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-json数据转换-1&quot;&gt;JSON数据转换&lt;/h4&gt;&lt;p&gt;Gin 可以轻松地将请求体中的 JSON 绑定到 Go 结构体&lt;/p&gt;
&lt;p&gt;在结构体中，使用 json tag 指定 JSON 字段名，使用 binding tag 添加校验规则（ 需要引入 &lt;code&gt;go-playground/validator&lt;/code&gt;）&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;net/http&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;	&quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;github.com/gin-gonic/gin&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; User&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Username &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;username&quot; binding:&quot;required&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Password &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;password&quot; binding:&quot;required&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	Email    &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; `json:&quot;email&quot; binding:&quot;required,email&quot;`&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	r &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; gin.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;POST&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/register&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; user &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;User&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ShouldBindJSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;user); err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;			c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusBadRequest, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;error&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: err.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;			return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;JSON&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(http.StatusOK, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;H&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;username&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: user.Username,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;password&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: user.Password,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;			&quot;email&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:    user.Email,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	})&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Run&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;		panic&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-中间件middleware-1&quot;&gt;中间件Middleware&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;为web项目的路由注册中间件，则在被注册路由提交请求/返回响应时，请求/响应数据会自动流过中间件，执行其中的方法&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;常见中间件比如：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;日志记录&lt;/li&gt;
&lt;li&gt;错误处理&lt;/li&gt;
&lt;li&gt;鉴权&lt;/li&gt;
&lt;li&gt;. . .&lt;/li&gt;
&lt;/ul&gt;
&lt;blockquote&gt;
&lt;p&gt;注：&lt;code&gt;gin.Default()&lt;/code&gt;默认使用&lt;code&gt;gin.Logger()&lt;/code&gt;和&lt;code&gt;gin.Recovery()&lt;/code&gt;中间件&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;使用中间件：&lt;/p&gt;

&lt;h4 id=&quot;article-全局使用-1&quot;&gt;全局使用&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; gin.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 在这里添加你的全局中间件&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Use&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;MyGlobalMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ... 定义路由 ...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-路由组使用-1&quot;&gt;路由组使用&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;adminGroup &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Group&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/admin&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 只对 /admin/* 路由应用 AuthMiddleware&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;adminGroup.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Use&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AuthMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    adminGroup.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/dashboard&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    adminGroup.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;POST&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/settings&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-单个路由使用-1&quot;&gt;单个路由使用&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;r.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;GET&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;/special&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;AnotherMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(), &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;/* ... */&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; })&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-自定义中间件-1&quot;&gt;自定义中间件&lt;/h4&gt;&lt;p&gt;中间件函数必须返回 gin.HandlerFunc 类型&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 一个简单的自定义日志中间件示例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; LoggerMiddleware&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;HandlerFunc&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;gin&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Context&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Before request: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; %s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, c.Request.Method, c.Request.URL.Path)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 调用链中的下一个处理函数 (可能是另一个中间件或最终的 Handler)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        c.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Next&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// &amp;lt;--- 重要！&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 在请求处理完成后执行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        statusCode &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.Writer.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Status&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;After request: Status &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, statusCode)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-中间件方法-1&quot;&gt;中间件方法&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;&lt;code&gt;c.Next&lt;/code&gt; : 阻塞当前中间件，调用后续的处理函数&lt;/li&gt;
&lt;li&gt;&lt;code&gt;c.Abort&lt;/code&gt; : 中止执行，后续中间件和&lt;/li&gt;
&lt;li&gt;&lt;code&gt;c.AbortWithStatusJSON&lt;/code&gt; : 终止并直接返回一个 JSON 响应&lt;/li&gt;
&lt;li&gt;&lt;code&gt;c.Set(key, value)&lt;/code&gt; 和 &lt;code&gt;c.Get(key)&lt;/code&gt; : 在不同中间件中通过定义键值对传递数据&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-项目结构-1&quot;&gt;项目结构&lt;/h3&gt;&lt;p&gt;在编写Web项目时，代码和逻辑会很复杂，需要做好结构管理使内容条目清晰&lt;/p&gt;
&lt;p&gt;以 Register&amp;amp;Login 简单项目举例：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;├── README.md&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── api&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── dao&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── go.mod&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;├── model&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;└── utils&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;ul&gt;
&lt;li&gt;README.md：项目的说明文档&lt;/li&gt;
&lt;li&gt;api：接口层，在里面是详细的逻辑实现以及路由。&lt;/li&gt;
&lt;li&gt;dao：全名为 data access object，进行数据库操作。&lt;/li&gt;
&lt;li&gt;model：模型层，主要放数据库实例的结构体。&lt;/li&gt;
&lt;li&gt;utils：一些常用的工具函数，封装在这里减少代码的重复使用。&lt;/li&gt;
&lt;li&gt;go.mod：依赖管理&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;例如：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Web3.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-使用postman测试api接口-1&quot;&gt;使用Postman测试API接口&lt;/h2&gt;&lt;p&gt;postman是一款便捷的用于测试api接口的工具，可向url发送post/get等多种type的数据&lt;/p&gt;
&lt;p&gt;这部分很简单，用一次就会了&lt;/p&gt;
&lt;p&gt;如：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-Web4.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;br /&gt;该操作向 &lt;code&gt;http://localhost:8080/regitser&lt;/code&gt; 发送了表单数据：&lt;code&gt;username=Claran&amp;amp;password=chr070309&amp;amp;email=big_fell_sans@163.com&lt;/code&gt;数据&lt;br /&gt;并得到返回JSON数据：&lt;code&gt;{&quot;status&quot;:200,&quot;msg&quot;:&quot;User registered successfully&quot;}&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-gin/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>Go并发基础-goroutine，channel &amp; sync包</title><link>https://www.claran-blog.work/posts/go-goroutine/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-goroutine/</guid><description>Go的并发基础学习.</description><pubDate>Mon, 27 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-并发-1&quot;&gt;并发&lt;/h2&gt;
&lt;h5 id=&quot;article-五种执行模式定义-1&quot;&gt;📚 五种执行模式定义&lt;/h5&gt;&lt;p&gt;&lt;strong&gt;1. 同步 (Synchronous)&lt;/strong&gt; - 调用后等待结果返回&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;2. 异步 (Asynchronous)&lt;/strong&gt; - 调用后立即返回,不等待&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;3. 串行 (Serial)&lt;/strong&gt; - 任务一个接一个顺序执行&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;4. 并发 (Concurrency)&lt;/strong&gt; - 多任务交替执行,逻辑上同时&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;5. 并行 (Parallelism)&lt;/strong&gt; - 多任务真正同时执行,物理上同时&lt;/p&gt;

&lt;h2 id=&quot;article-goroutine-go-1&quot;&gt;Goroutine (go)&lt;/h2&gt;&lt;p&gt;创建一个额外线程执行相应内容&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;内存占用极小（2kb），Go的特有优势&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; sayHello&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Hello &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;! (&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, name, i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Millisecond)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 普通调用:同步执行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    sayHello&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;同步&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 加 go:异步执行&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; sayHello&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;异步1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; sayHello&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;异步2&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 等待 goroutine 完成&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 可能的输出(顺序不确定):&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Hello 同步! (1)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Hello 同步! (2)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Hello 同步! (3)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Hello 异步1! (1)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Hello 异步2! (1)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Hello 异步1! (2)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Hello 异步2! (2)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;那么为什么会不同步呢？&lt;/p&gt;
&lt;p&gt;因为Go的底层逻辑是跟一个复杂的调度器有关，因此go的执行顺序与代码内容无关&lt;/p&gt;
&lt;p&gt;所以最后的time.Sleep就是在等待其他线程都执行完再结束主函数&lt;/p&gt;
&lt;p&gt;那我们该怎么控制不同线程呢？这就是sync包会讲的内容&lt;/p&gt;
&lt;p&gt;在此之前，先让我们认识一下Channel&lt;/p&gt;

&lt;h2 id=&quot;article-channel-1&quot;&gt;Channel&lt;/h2&gt;&lt;p&gt;channel就是不同线程间传输数据的通道&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-%E5%B9%B6%E5%8F%91%EF%BC%9AGo%EF%BC%8CChannel&amp;amp;sync%E5%8C%851.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;这就涉及到了Go的设计哲学💡：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;&quot;不要通过共享内存来通信,而要通过通信来共享内存&quot;&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;这是Go并发编程的核心思想!&lt;/p&gt;

&lt;h4 id=&quot;article-基本操作-1&quot;&gt;基本操作&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 1. 创建 channel&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)          &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 无缓冲&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;buffered &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 有缓冲(容量5)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 2. 发送数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 42&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 3. 接收数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;value &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 4. 关闭 channel&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;close&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ch)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 5. 遍历 channel&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; value &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ch {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(value)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-有-无缓冲-1&quot;&gt;有/无缓冲&lt;/h4&gt;&lt;p&gt;&lt;strong&gt;无缓冲 Channel&lt;/strong&gt;:必须有人接收,发送才能成功&lt;/p&gt;
&lt;p&gt;在无人接收时，Channel会阻塞当前节点（无法进行下一行内容），直到有人接收&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 容量为0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 42&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;  // 会阻塞,直到有人接收&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送成功&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;value &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 接收,上面的发送才能完成&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;收到:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, value)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;有缓冲 Channel&lt;/strong&gt;:可以先放进去,后面再取&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 容量为3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 可以连续发送3个,不会阻塞&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;发送了3个值&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 后面再接收&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch)  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch)  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch)  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 3&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-只接收-只发送-1&quot;&gt;只接收/只发送&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;&lt;code&gt;chan&amp;lt;- int&lt;/code&gt;:只能发送的channel(防止你误接收)&lt;/li&gt;
&lt;li&gt;&lt;code&gt;&amp;lt;-chan int&lt;/code&gt;:只能接收的channel(防止你误发送)&lt;/li&gt;
&lt;li&gt;这是类型安全的保护!体现了Go&quot;在编译期发现问题&quot;的设计&lt;/li&gt;
&lt;/ul&gt;

&lt;h2 id=&quot;article-select-1&quot;&gt;Select&lt;/h2&gt;&lt;p&gt;select用于同时监听多个channel，用default实现非阻塞操作&lt;/p&gt;
&lt;p&gt;在select内部可以包含多个channel case，哪个channel先准备好，哪个case就先执行&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-%E5%B9%B6%E5%8F%91%EF%BC%9AGo%EF%BC%8CChannel&amp;amp;sync%E5%8C%852.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;比如：超时控制：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; fetchData&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;ch&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; chan&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second)  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 模拟耗时操作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;数据获取成功&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ch &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; fetchData&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ch)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 设置1秒超时&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(result)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;After&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second):&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;超时!操作耗时过长&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出: 超时!操作耗时过长&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;多重监听：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ch1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ch2 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    quit &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;chan&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 1秒后发送&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ch1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;消息1&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 2秒后发送&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ch2 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;消息2&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 3秒后发送退出信号&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        quit &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 持续监听&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        select&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch1:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;收到:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, msg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; msg &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;ch2:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;收到:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, msg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;lt;-&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;quit:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;退出!&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            return&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 收到: 消息1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 收到: 消息2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 退出!&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-sync包-1&quot;&gt;sync包&lt;/h2&gt;&lt;p&gt;包含多个方法控制线程：WaitGroup/Mutex/Once/RWMutex&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;适用场景对比:&lt;/strong&gt;&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;场景&lt;/th&gt;
&lt;th&gt;推荐方案&lt;/th&gt;
&lt;th&gt;原因&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;传递数据&lt;/td&gt;
&lt;td&gt;Channel&lt;/td&gt;
&lt;td&gt;Go 的设计哲学&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;等待一组任务完成&lt;/td&gt;
&lt;td&gt;sync.WaitGroup&lt;/td&gt;
&lt;td&gt;简单直接&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;保护共享资源&lt;/td&gt;
&lt;td&gt;sync.Mutex&lt;/td&gt;
&lt;td&gt;传统且高效&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;只读一次的配置&lt;/td&gt;
&lt;td&gt;sync.Once&lt;/td&gt;
&lt;td&gt;保证单次执行&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;高并发读多写少&lt;/td&gt;
&lt;td&gt;sync.RWMutex&lt;/td&gt;
&lt;td&gt;性能优化&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h3 id=&quot;article-sync-waitgroup-1&quot;&gt;sync.WaitGroup&lt;/h3&gt;&lt;p&gt;可以精确等待某线程执行完毕&lt;/p&gt;
&lt;p&gt;可以通过此方法调控go并发的执行顺序&lt;/p&gt;
&lt;p&gt;核心方法：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wg &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WaitGroup&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 创建WaitGroup实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(n)    &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 计数器 +n (启动 goroutine 前调用)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Done&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()    &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 计数器 -1 (goroutine 结束时调用)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Wait&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()    &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 阻塞,直到计数器为 0&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;代码示例：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; worker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;wg&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WaitGroup&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Done&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 完成时通知 WaitGroup(推荐用defer)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Worker &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 开始工作&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, id)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(time.Second)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Worker &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 完成工作&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, id)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wg &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WaitGroup&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 启动5个 worker&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 计数器 +1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        go&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; worker&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(i, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;wg)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Wait&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 阻塞,直到计数器归零&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;所有 worker 完成!&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出(顺序可能不同):&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Worker 1 开始工作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Worker 5 开始工作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Worker 2 开始工作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Worker 3 开始工作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Worker 4 开始工作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Worker 1 完成工作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Worker 3 完成工作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 所有 worker 完成!&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-sync-mutex-1&quot;&gt;sync.Mutex&lt;/h3&gt;&lt;p&gt;当多个 goroutine 同时修改同一个变量会出现&lt;strong&gt;竞态条件&lt;/strong&gt;(race condition),导致结果错误!&lt;/p&gt;
&lt;p&gt;于是，我们可以使用 &lt;code&gt;sync.Mutex&lt;/code&gt; 互斥锁保护共享资源&lt;/p&gt;
&lt;p&gt;&lt;code&gt;sync.Mutex&lt;/code&gt; 可以保护数据同时只被一项进程读写：&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-%E5%B9%B6%E5%8F%91%EF%BC%9AGo%EF%BC%8CChannel&amp;amp;sync%E5%8C%853.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;核心方法：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; mu &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Mutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()    &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 加锁(阻塞,直到获得锁)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 解锁&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;基本使用：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; SafeCounter&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mu    &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Mutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    count &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SafeCounter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Increment&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    c.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()         &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 加锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    c.count&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;           // 安全修改&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    c.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()       &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 解锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;SafeCounter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Value&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    c.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()         &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 读取也要加锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// defer 确保一定会解锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.count&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    counter &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; SafeCounter&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wg &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WaitGroup&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 1000 个 goroutine 同时累加&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1000&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Done&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            counter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Increment&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Wait&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;最终值:&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, counter.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Value&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 总是 1000(正确!)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-sync-rwmutex-1&quot;&gt;sync.RWMutex&lt;/h3&gt;&lt;p&gt;我们知道&lt;code&gt;sync.Mutex&lt;/code&gt; 不区分读和写,即使只是读取数据也要加锁,效率低&lt;/p&gt;
&lt;p&gt;于是我们可以使用&lt;code&gt;RWMutex&lt;/code&gt; 允许多个 goroutine 同时读,但写时独占&lt;/p&gt;
&lt;p&gt;核心方法：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; mu &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RWMutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 读操作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RLock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()    &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 加读锁(可以有多个)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RUnlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()  &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 释放读锁&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 写操作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()     &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 加写锁(独占)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()   &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 释放写锁&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;基本使用：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Config&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    mu   &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RWMutex&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    data &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 读配置(多个协程可以同时读)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Get&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;key&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    c.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RLock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;RUnlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.data[key]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 写配置(独占,其他人不能读也不能写)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Set&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;key&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;value&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    c.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Lock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; c.mu.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unlock&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    c.data[key] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; value&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;更新配置: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; = &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, key, value)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    config &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Config&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        data: &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;host&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;localhost&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;            &quot;port&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;8080&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        },&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wg &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WaitGroup&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 10 个协程读取配置(可以并发)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 10&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Done&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            host &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; config.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Get&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;host&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;协程 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 读取: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, id, host)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(time.Millisecond &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }(i)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 1 个协程更新配置&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Done&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sleep&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(time.Millisecond &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 50&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        config.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Set&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;host&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;127.0.0.1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Wait&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-sync-once-1&quot;&gt;sync.Once&lt;/h3&gt;&lt;p&gt;某些初始化操作(如加载配置、建立连接)只能执行一次&lt;/p&gt;
&lt;p&gt;于是我们可以使用&lt;code&gt;sync.Once&lt;/code&gt; 保证函数只执行一次,即使被多次调用也只执行一次&lt;/p&gt;
&lt;p&gt;核心方法：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; once &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Once&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;once.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Do&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 这个函数只会执行一次&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 即使 Do 被多次调用&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;})&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;基本使用：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    instance &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Database&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    once     &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Once&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Database&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    Connection &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 单例模式:只初始化一次&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; GetDatabase&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Database&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    once.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Do&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;初始化数据库连接...&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        instance &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Database&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            Connection: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;localhost:5432&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    })&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; instance&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wg &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;sync&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;WaitGroup&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 10 个 goroutine 同时获取数据库实例&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 10&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        go&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;            defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Done&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            db &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; GetDatabase&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;            fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;协程 &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; 获得实例: &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%p\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, id, db)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        }(i)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    wg.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Wait&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 初始化数据库连接...  (只输出一次!)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 协程 1 获得实例: 0xc0000a4000&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 协程 2 获得实例: 0xc0000a4000  (地址相同!)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 协程 3 获得实例: 0xc0000a4000&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// ...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-总结-1&quot;&gt;总结&lt;/h3&gt;&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-%E5%B9%B6%E5%8F%91%EF%BC%9AGo%EF%BC%8CChannel&amp;amp;sync%E5%8C%854.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-goroutine/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>项目实践中的测试与常见异常</title><link>https://www.claran-blog.work/posts/go-test/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-test/</guid><description>Go的测试代码和常见异常学习.</description><pubDate>Fri, 24 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-测试-testing-1&quot;&gt;测试（Testing）&lt;/h2&gt;&lt;p&gt;测试，顾名思义就是对于已有程序/项目的测试/检验&lt;/p&gt;
&lt;p&gt;测试分为以下三类：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;功能测试（test）&lt;/li&gt;
&lt;li&gt;基准测试（benchmark，也称性能测试）&lt;/li&gt;
&lt;li&gt;示例测试（example）&lt;/li&gt;
&lt;/ul&gt;
&lt;blockquote&gt;
&lt;p&gt;编写测试文件，我们会用到 &lt;code&gt;&quot;testint&quot;&lt;/code&gt; 包&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3 id=&quot;article-功能测试-1&quot;&gt;功能测试：&lt;/h3&gt;&lt;p&gt;测试某函数/方法是否正常工作&lt;/p&gt;

&lt;h4 id=&quot;article-基本写法-1&quot;&gt;基本写法&lt;/h4&gt;&lt;p&gt;以测试函数(a+b)为例：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; TestAdd&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;t&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;testing&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;T&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// t 就是 *testing.T 类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;        // 调用 T 的方法来报告测试失败&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        t.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Add(2, 3) = &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;; want 5&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-testing-t-结构体的主要方法-1&quot;&gt;testing.T 结构体的主要方法&lt;/h4&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;方法&lt;/th&gt;
&lt;th&gt;作用&lt;/th&gt;
&lt;th&gt;是否停止测试&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;Errorf(format string, args...)&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;记录错误并继续执行&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;Fatalf(format string, args...)&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;记录错误并立即停止&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;Logf(format string, args...)&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;记录日志信息&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;Fail()&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;标记失败但继续执行&lt;/td&gt;
&lt;td&gt;否&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;FailNow()&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;标记失败并立即停止&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;SkipNow()&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;跳过当前测试&lt;/td&gt;
&lt;td&gt;是&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;Run(name string, f func(t *T))&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;运行子测试&lt;/td&gt;
&lt;td&gt;-&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h3 id=&quot;article-基准测试-benchmark-testing-1&quot;&gt;基准测试 (Benchmark Testing)&lt;/h3&gt;&lt;p&gt;用于衡量代码的性能，比如运行时间和内存分配情况&lt;/p&gt;

&lt;h4 id=&quot;article-基本写法-2&quot;&gt;基本写法&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// calculator_test.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;testing&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; BenchmarkAdd&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;b&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;testing&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;B&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; b.N; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; BenchmarkAddWithSetup&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;b&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;testing&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;B&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 准备工作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;b.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ResetTimer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 重置计时器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; b.N; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;b.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;StopTimer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 清理工作&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-testing-b-结构体的专属方法-1&quot;&gt;testing.B 结构体的专属方法&lt;/h4&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;方法&lt;/th&gt;
&lt;th&gt;作用&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;&lt;code&gt;ResetTimer()&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;重置基准测试计时器&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;StartTimer()&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;开始计时&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;StopTimer()&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;停止计时&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;ReportAllocs()&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;报告内存分配统计&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;SetBytes(n int64)&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;设置单次操作处理的字节数&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;注意&lt;/strong&gt;: &lt;code&gt;testing.B&lt;/code&gt; 继承了 &lt;code&gt;testing.T&lt;/code&gt; 的所有方法。&lt;/p&gt;

&lt;h3 id=&quot;article-示例测试-example-testing-1&quot;&gt;示例测试 (Example Testing)&lt;/h3&gt;
&lt;h4 id=&quot;article-基本写法-3&quot;&gt;基本写法&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// calculator_test.go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ExampleAdd&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;sum &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(sum)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Output: 3&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; ExampleAdd_negativeNumbers&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;sum &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(sum)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Output: -8&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-示例测试的特点-1&quot;&gt;示例测试的特点&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;不需要 &lt;code&gt;testing.T&lt;/code&gt; 或 &lt;code&gt;testing.B&lt;/code&gt; 参数&lt;/li&gt;
&lt;li&gt;函数名必须以 &lt;code&gt;Example&lt;/code&gt; 开头&lt;/li&gt;
&lt;li&gt;必须包含 &lt;code&gt;// Output:&lt;/code&gt; 注释来验证输出&lt;/li&gt;
&lt;li&gt;输出会被严格匹配验证&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-测试文件组织-1&quot;&gt;测试文件组织&lt;/h3&gt;
&lt;h4 id=&quot;article-文件命名约定-1&quot;&gt;文件命名约定&lt;/h4&gt;&lt;ul&gt;
&lt;li&gt;测试文件: &lt;code&gt;原文件名_test.go&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;包名: 通常与源文件相同（也可用 &lt;code&gt;包名_test&lt;/code&gt;）&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-运行测试的命令-1&quot;&gt;运行测试的命令&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;&lt;p&gt;运行所有测试:&lt;br /&gt;go test&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;显示详细输出:&lt;br /&gt;go test -v&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;运行基准测试:&lt;br /&gt;go test -bench=.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;显示内存分配信息:&lt;br /&gt;go test -bench=. -benchmem&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;运行特定测试:&lt;br /&gt;go test -run TestAdd&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;测试覆盖率:&lt;br /&gt;go test -cover&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;生成覆盖率报告:&lt;br /&gt;go test -coverprofile=coverage.out&lt;br /&gt;go tool cover -html=coverage.out&lt;br /&gt;%%&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-总结对比表-1&quot;&gt;总结对比表&lt;/h3&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;测试类型&lt;/th&gt;
&lt;th&gt;函数前缀&lt;/th&gt;
&lt;th&gt;参数&lt;/th&gt;
&lt;th&gt;主要用途&lt;/th&gt;
&lt;th&gt;验证方式&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;功能测试&lt;/td&gt;
&lt;td&gt;&lt;code&gt;Test&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;*testing.T&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;验证逻辑正确性&lt;/td&gt;
&lt;td&gt;断言检查&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;基准测试&lt;/td&gt;
&lt;td&gt;&lt;code&gt;Benchmark&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;*testing.B&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;测量性能指标&lt;/td&gt;
&lt;td&gt;循环计时&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;示例测试&lt;/td&gt;
&lt;td&gt;&lt;code&gt;Example&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;无&lt;/td&gt;
&lt;td&gt;提供可执行文档&lt;/td&gt;
&lt;td&gt;输出匹配&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h2 id=&quot;article-常见异常-error-1&quot;&gt;常见异常（Error）&lt;/h2&gt;&lt;p&gt;防御性编程：预见可能会出现的panic并在其出现前避免 (例如：检查指针是否为nil)&lt;/p&gt;

&lt;h3 id=&quot;article-主动判断异常-1&quot;&gt;主动判断异常&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//返回两个值:结果+错误信息&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; divide&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;a&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;bfloat64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) (&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;float64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; b &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Errorf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;除数不能为0&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; a&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;/&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;b, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;nil&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// nil 表示没有错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-空指针解引用-1&quot;&gt;空指针解引用&lt;/h3&gt;&lt;p&gt;尝试通过空指针访问其指向的值将导致运行时错误（panic），因此在使用空指针之前，&lt;br /&gt;通常需要检查它是否为nil，否则会出现空指针异常&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*int&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 声明一个指向int类型的空指针&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 尝试通过空指针p访问其指向的值，这将导致运行时panic&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 因为p是空指针，没有指向任何有效的内存地址&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;p) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 这里会发生空指针异常&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-索引越界-1&quot;&gt;索引越界&lt;/h3&gt;&lt;p&gt;基本上是最常见的一种异常了，就是访问 数组/切片/映射 索引 不存在/越界 的情况发生的异常&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	slice &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	slice[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 索引越界&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-类型断言失败-1&quot;&gt;类型断言失败&lt;/h3&gt;&lt;p&gt;顾名思义，就是对空接口存储的值未类型断言或类型断言失败导致的数据类型不匹配而Panic&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Stack&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	elements []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Stack&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Push&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;item&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    s.elements &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.elements, item)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Stack&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Top&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Empty&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.elements[&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.elements)&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Stack&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Push&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;float64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3.14&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;))&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	value &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Top&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;rune&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 类型断言失败 - Panic&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 应使用安全断言：&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	value, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Top&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;rune&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-test/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>随笔.3：熟悉常态</title><link>https://www.claran-blog.work/posts/diary3/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/diary3/</guid><description>开始学习Go了！</description><pubDate>Thu, 23 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-2025-10-23-1&quot;&gt;2025.10.23&lt;/h2&gt;&lt;br /&gt;

&lt;p&gt;我认识到了一个很严重的事情&lt;/p&gt;
&lt;p&gt;拘泥于博客或者笔记归档啥的，甚至是写没必要的笔记本身都十分浪费时间&lt;/p&gt;
&lt;p&gt;这样会拖慢我的学习进度&lt;/p&gt;
&lt;p&gt;所以博客归档应该是每隔一段时间才会做的&lt;/p&gt;
&lt;p&gt;而且博客只写重要的东西好了&lt;/p&gt;
&lt;p&gt;要加快学习进度了！太慢了！这样下去什么也干不了！&lt;/p&gt;
&lt;br /&gt;

&lt;hr /&gt;
&lt;p&gt;另外，今天翘了一整天的课呢... 第一次翘这么多课&lt;/p&gt;
&lt;p&gt;这会成为我以后的日常吗？&lt;/p&gt;
&lt;p&gt;期末该咋办啊？！挂科了就废了！&lt;/p&gt;
&lt;p&gt;了解到同届同学在暑假狂学Go（从零开始！）&lt;/p&gt;
&lt;p&gt;而且现在进度已经比我快了几个月，还进入了学校相关技术官工作部门开始些项目了&lt;/p&gt;
&lt;p&gt;真的好厉害！高考完暑假就一直在学！&lt;/p&gt;
&lt;p&gt;真是急得不得了！好想学快点啊！&lt;/p&gt;
&lt;p&gt;但是这样翘课下去期末真的没问题吗？啊哈哈...&lt;/p&gt;
&lt;p&gt;也是明确了学习路线：并发-Gin-http-数据库-Redis&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/diary3/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>随笔</category><category>杂项</category></item><item><title>随笔.2：Be a Gopher.</title><link>https://www.claran-blog.work/posts/diary2/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/diary2/</guid><description>对未来的规划.</description><pubDate>Mon, 20 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-2025-10-22-1&quot;&gt;2025.10.22&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;我决定走Go方向&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;原因我也不知道，可能是因为Go是一门对我而言比较有新鲜感的语言吧&lt;/p&gt;
&lt;br /&gt;

&lt;hr /&gt;
&lt;p&gt;如此决定了之后，我便开始去招新群、飞书、Github找各种资料和学习大纲，并且翻到了很多往年的学习文件，让我至少有了个暂时的方向&lt;/p&gt;
&lt;p&gt;然后就是最近几天，基本过完Go的基础语法后，我便开始着手于搭建自己的博客网站，花了整整两天终于搞出了成品（现在的这个网站）&lt;/p&gt;
&lt;p&gt;自己在互联网上寻觅资料或教程、在实操时与AI斗智斗勇、在一次次调试后终于产出成果&lt;/p&gt;
&lt;p&gt;也许正是这个过程让我对编程语言或后端开发、甚至计算机本身如此着迷&lt;/p&gt;
&lt;br /&gt;

&lt;hr /&gt;
&lt;p&gt;在翻找Github时，我看了很多学长自己的Blog&lt;/p&gt;
&lt;p&gt;每个人的Blog都记录了自己的学习生涯，也都承载了他们学习历程的辛苦&lt;/p&gt;
&lt;p&gt;看着学长们令人眼花缭乱的学习笔记，我再次认识到了自己的渺小&lt;/p&gt;
&lt;p&gt;曾经我认为拥有一点点OI基础，便是同龄人追赶不上的存在&lt;/p&gt;
&lt;p&gt;但是事实并非如此，OI只教会我一门语言的语法和它在算法与数据结构上的应用&lt;/p&gt;
&lt;p&gt;OI并没有让我知道，原来后端开发不仅包含某门语言的基本语法和算法，还要求我掌握一堆我闻所未闻的专有名词&lt;/p&gt;
&lt;p&gt;也没有让我知道，原来计算机的路是学无止境的，骄傲自满只会让我们与技术脱节&lt;/p&gt;
&lt;p&gt;我看完了所有学长的Blogs&lt;/p&gt;
&lt;p&gt;我决定与过去的我切割，与自满的我告别，从此刻开始积少成多&lt;/p&gt;
&lt;p&gt;我想，这也是这个博客网站存在的意义之一吧&lt;/p&gt;
&lt;br /&gt;

&lt;hr /&gt;
&lt;p&gt;最近发现蓝桥杯又开始报名了，我便去了解了一下，发现我可以参加大学生B组比赛&lt;/p&gt;
&lt;p&gt;再次明确了考试大纲后，我发现这组比赛的考试内容与我高中参加的CSP-S难度相差不大&lt;/p&gt;
&lt;p&gt;我又萌生了参加蓝桥杯的想法&lt;/p&gt;
&lt;p&gt;也就意味着我又要重拾，甚至是第二次重拾“算法与数据结构”的内容&lt;/p&gt;
&lt;p&gt;幸运的是还有半年比赛才开始&lt;/p&gt;
&lt;p&gt;那么就从现在开始每日一题&lt;/p&gt;
&lt;br /&gt;

&lt;p&gt;二编：&lt;/p&gt;
&lt;p&gt;我还是去报名了CACC&lt;/p&gt;
&lt;p&gt;十二月就要考，而且难度还比蓝桥杯大得多？！&lt;/p&gt;
&lt;p&gt;罢了，感受下氛围也挺好的！&lt;/p&gt;
&lt;br /&gt;
****

&lt;p&gt;写了这么多可有可无的内容，让我感觉我的感悟未免有些假大空&lt;/p&gt;
&lt;p&gt;我在未来学习的路上，一定会经历从兴趣驱动学习到意志驱动学习的转变&lt;/p&gt;
&lt;p&gt;一定会经历从跟随他人学习到自己找资料学习的转变&lt;/p&gt;
&lt;p&gt;那么，我现在一定要做好我所期望的每一件事&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;努力学习Go吧&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/diary2/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>随笔</category><category>杂项</category></item><item><title>Go的“面向对象”-接口与相关思想</title><link>https://www.claran-blog.work/posts/go-interface/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-interface/</guid><description>Go中关于接口的使用和思想.</description><pubDate>Mon, 20 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-接口-interface-1&quot;&gt;接口（interface）&lt;/h2&gt;&lt;p&gt;接口是一组方法签名的集合，定义了类型应实现的行为。实现是隐式的：只要类型具有接口所需方法，就实现&lt;br /&gt;该接口。&lt;/p&gt;

&lt;h4 id=&quot;article-定义格式-1&quot;&gt;定义格式&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; 接口名&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;     Method1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;arg&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; T&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;R&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;     Method2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;error&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;例如&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Stringer&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;s&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Stringer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Person&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { Name &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;p &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Person&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; p.Name }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Person&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Name: &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Tom&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// Person 隐式实现 Stringer&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-接口与面向对象-1&quot;&gt;接口与面向对象&lt;/h2&gt;&lt;p&gt;Go的面向对象包含三大要素：接口、方法、结构体&lt;/p&gt;
&lt;p&gt;定制接口 - 接口要求方法 - 存在方法满足接口要求 - struct存储信息 - 调用接口&lt;/p&gt;
&lt;p&gt;方法需要结构体作为接受者，也就是结构体与方法是“封装”一步的关键&lt;/p&gt;
&lt;p&gt;如图&lt;br /&gt;&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-%E6%8E%A5%E5%8F%A3%E4%B8%8E%E9%9D%A2%E5%90%91%E5%AF%B9%E8%B1%A11.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;多接口&lt;img src=&quot;https://www.claran-blog.work/images/albums/blogAlbum/Go-%E6%8E%A5%E5%8F%A3%E4%B8%8E%E9%9D%A2%E5%90%91%E5%AF%B9%E8%B1%A12.jpg&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;代码实现&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; 接口名&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 定义一个接口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;    方法名&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;参数&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;返回值&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;方法类型&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建接口要求方法，满足所用方法即调用接口&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    ...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; 结构体名&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 根据设计意图进行变量封装&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    ...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;结构体变量名 &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;结构体名&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;/*方法接收器，定义方法操作的对象*/&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;方法名&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;参数&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;返回值&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//定义满足要求方法的方法&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    ...&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; //方法实现过程&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-多态-1&quot;&gt;多态&lt;/h3&gt;&lt;p&gt;通过用不同类型实现同一接口，可以实现接口的多态表现&lt;/p&gt;

&lt;h3 id=&quot;article-解耦-1&quot;&gt;解耦&lt;/h3&gt;&lt;p&gt;通过接口定义依赖关系，降低模块之间的耦合&lt;/p&gt;
&lt;p&gt;区别于Java类OOP式面向对象的Is-a关系，Go的Can-do关系不要求强制存在父类、子类和方法之间的访问修饰符定义等强耦合关系&lt;/p&gt;

&lt;h3 id=&quot;article-泛化-1&quot;&gt;泛化&lt;/h3&gt;&lt;p&gt;使用空借口interface{}可表示任意类型&lt;/p&gt;

&lt;h3 id=&quot;article-空接口-1&quot;&gt;空接口&lt;/h3&gt;&lt;p&gt;空接口 interface{} 可以表示任何类型&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; x &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;x &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 123&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;x &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;hello&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-类型断言与类型选择-1&quot;&gt;类型断言与类型选择&lt;/h3&gt;&lt;ul&gt;
&lt;li&gt;类型断言获取具体类型或判断类型：&lt;/li&gt;
&lt;/ul&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; v &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;abc&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; v.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 断言，若失败会 panic&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;s, ok &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; v.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 安全断言&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;ul&gt;
&lt;li&gt;类型开关：&lt;/li&gt;
&lt;/ul&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; t &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; v.(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // t 是 int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;case&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // t 是 string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-泛型-any-1&quot;&gt;泛型（any）&lt;/h2&gt;&lt;p&gt;与空接口类似，可以表示任何类型&lt;/p&gt;
&lt;p&gt;不同的是，空接口在编译时容易发生类型安全错误，需要频繁类型断言&lt;/p&gt;
&lt;p&gt;而泛型any会自动保证编译时类型安全，编译器会为每个使用的具体类型生成一份特化代码&lt;/p&gt;
&lt;p&gt;拓展知识之后会逐渐接触&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-interface/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>随笔.1：初入大学和技术社团的接触</title><link>https://www.claran-blog.work/posts/diary1/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/diary1/</guid><description>初入大学的感想.</description><pubDate>Sun, 19 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-2025-10-18-1&quot;&gt;2025.10.18&lt;/h2&gt;&lt;br /&gt;
#### 有关大学生涯规划的思考：

&lt;br /&gt;

&lt;p&gt;作为以后想走计算机方向的一名双非大学本科学生&lt;/p&gt;
&lt;p&gt;我笃定了毕业就业的想法&lt;/p&gt;
&lt;p&gt;为什么呢？&lt;/p&gt;
&lt;blockquote&gt;
&lt;ol&gt;
&lt;li&gt;不想再像初高中那般继续埋头刷题、死钻文化课内容&lt;/li&gt;
&lt;li&gt;不想进入计算机方向就业过晚（甚至是7年后的计算机就业趋势）&lt;/li&gt;
&lt;li&gt;重邮本身有极其优秀的计算机方向技术&amp;amp;就业组织－红岩&amp;amp;蓝山&lt;/li&gt;
&lt;/ol&gt;
&lt;/blockquote&gt;
&lt;p&gt;由此，可以明确的是，在我的大学中：不保研、不考研、不评优评先、&lt;del&gt;不入党&lt;/del&gt;&lt;/p&gt;
&lt;p&gt;也就是说，在大学阶段，我只要保证能够顺利毕业，我的大学生涯就是成功的&lt;/p&gt;
&lt;p&gt;因此，我会翘开所有&lt;del&gt;没用的&lt;/del&gt;课和集会，将一切时间用于计算机后端开发技术的自学（跟着红蓝学）&lt;/p&gt;
&lt;p&gt;没错，就是在保证不挂科顺利毕业的条件下翘课自学&lt;/p&gt;
&lt;p&gt;那么，我个人的大学生涯规划已经呼之欲出了：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;大一学基础&amp;amp;技术 -&amp;gt; 进入红蓝 -&amp;gt; 大二继续学习技术、写项目 -&amp;gt; 大二下暑假实习 -&amp;gt; 大三&amp;amp;大四实习 -&amp;gt; 毕业找工作&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;在这样的发展模式下，我在毕业时拥有足够的项目和实习经验，而这两项往往是计算机就业最看重的东西&lt;/p&gt;
&lt;p&gt;然后，拿offer - 就业 - 直到中年被淘汰转型&lt;/p&gt;
&lt;br /&gt;

&lt;p&gt;是的，这样看起来，我的计划似乎过于理想主义了&lt;/p&gt;
&lt;p&gt;但不可避免的是，这是对于我个人最清晰、最有希望、最合乎我个人理想的规划&lt;/p&gt;
&lt;br /&gt;

&lt;p&gt;所以，让我们落实到当下（大一阶段）：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;目前要跟着红蓝/自己找资源努力学习技术，通过三大考核，成功进入红蓝组织&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://www.claran-blog.work/images/img/Lanshan.png&quot; alt=&quot;&quot; style=&quot;max-width:100%;height:auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/diary1/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>随笔</category><category>杂项</category></item><item><title>Go-常用包与函数</title><link>https://www.claran-blog.work/posts/go-usually/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-usually/</guid><description>Go-常用包的汇总.</description><pubDate>Fri, 17 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-自创包-1&quot;&gt;自创包&lt;/h2&gt;&lt;p&gt;字面意思，自己写包自己用(对外公开的接口/方法/结构体需大写)&lt;/p&gt;
&lt;p&gt;例如，go中没有现成的栈和队列，于是我们可以自己搓一个&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;如果引入一个包时其设置了一个特殊&lt;code&gt;_&lt;/code&gt;作为包名，那么这个包的引入方式就称为匿名引入&lt;/p&gt;
&lt;p&gt;一个包被匿名引入的目的主要是为了加载这个包，从而使得这个包中的资源得以初始化。&lt;/p&gt;
&lt;p&gt;被匿名引入的包中的&lt;code&gt;init&lt;/code&gt;函数将被执行并且仅执行一遍。&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3 id=&quot;article-队列-1&quot;&gt;队列&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; queue&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Queue&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	elements []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//0永远为Top/Front&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;q &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Queue&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Push&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;item&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	q.elements &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(q.elements, item)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;q &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Queue&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Pop&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; !&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;q.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Empty&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		q.elements &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; q.elements[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:] &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//delete top&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;q &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Queue&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Front&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{} {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; q.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Empty&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;		return&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; //队列空返回nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	item &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; q.elements[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; item&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;q &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Queue&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Empty&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; q.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Size&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;==&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;q &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Queue&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Size&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; len&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(q.elements)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;q &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Queue&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Clear&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	q.elements &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;interface&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{}, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-栈-1&quot;&gt;栈&lt;/h2&gt;&lt;p style=&quot;font-size:12px&quot;&gt;package&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;type Stack struct {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;	//切片储存栈元素，i=len(elements)为top&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;	elements []interface{}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;func (s *Stack) Push(item interface{}) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;	s.elements = append(s.elements, item)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;func (s *Stack) Pop() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;	if !s.Empty() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;		lastIdx := len(s.elements) - 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;		s.elements = s.elements[:lastIdx]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;func (s *Stack) Top() interface{} {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;	if s.Empty() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;		return nil&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;	return s.elements[len(s.elements)-1]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;func (s *Stack) Empty() bool {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;	return s.Size() == 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;func (s *Stack) Size() int {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;	return len(s.elements)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;func (s *Stack) Clear() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;	s.elements = make([]interface{}, 0)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;注意，这样生成的结构体在其他包使用时需要遵循一下语法：&lt;/p&gt;
&lt;p&gt;&lt;code&gt;var q queue.Queue&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;前者为包名，后者为结构体名&lt;/p&gt;

&lt;h2 id=&quot;article-生成随机数-1&quot;&gt;生成随机数&lt;/h2&gt;&lt;p&gt;包含包：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;math/rand&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//rand函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//产生时间刻&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;详细方法：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;rend.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Seed&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;().&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UnixNano&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;())&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//用系统时间刻设置随机数种子&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;randNum &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; rand.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Intn&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//生成范围0～100的随机数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(randNum)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//打印随机数&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-任意大整数-1&quot;&gt;任意大整数&lt;/h2&gt;&lt;p&gt;包：&lt;code&gt;&quot;math/big&quot;&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;该类型值不能用常规运算符计算，只能用自带方法&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;big.Int()&lt;/code&gt; 一种数据类型，表示任意大整数&lt;/li&gt;
&lt;li&gt;big.NewInt() 创建*big.Int (from int64)&lt;/li&gt;
&lt;li&gt;.Add(x,y) x+y&lt;/li&gt;
&lt;li&gt;.Sub(x,y) x-y&lt;/li&gt;
&lt;li&gt;.Mul(x,y) x*y&lt;/li&gt;
&lt;li&gt;.Quo(x,y) x/y&lt;/li&gt;
&lt;li&gt;.Rem(x,y) x%y&lt;/li&gt;
&lt;li&gt;x.Cmp(y) return -1(x&amp;lt;y) : 0(x==y) : 1(x&amp;gt;y)&lt;/li&gt;
&lt;li&gt;z.Set(x) z = x且为big.Int&lt;/li&gt;
&lt;/ul&gt;
&lt;blockquote&gt;
&lt;p&gt;注意：为节省空间，big.Int一般用指针方法接收&lt;/p&gt;
&lt;p&gt;因此，big.NewInt(x)返回的值为*big.Int()&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2 id=&quot;article-time包-时间获取-1&quot;&gt;time包(时间获取)&lt;/h2&gt;
&lt;h3 id=&quot;article-基础时间获取-1&quot;&gt;基础时间获取&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;time&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    now &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 获取当前时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(now) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 打印完整时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Year&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 年份&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Month&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 月份&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Day&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 日期&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Hour&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 小时&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Minute&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 分钟&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Second&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 秒数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    tomorrow &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;24&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; *&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.Hour) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 当前时间加24小时（明天）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(tomorrow)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    format &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;2006-01-02 15:04:05&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 固定格式（Go的参考时间）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Format&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(format)) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 格式化输出&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-时间戳-1&quot;&gt;时间戳&lt;/h3&gt;&lt;p&gt;时间戳是自1970年1月1日（08:00:00GMT）至当前时间的总毫秒数&lt;/p&gt;
&lt;p&gt;它也被称为Unix时间戳（UnixTimestamp）&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; timestampDemo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    now &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()            &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//获取当前时间&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    timestamp1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Unix&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()     &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//时间戳&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    timestamp2 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; now.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;UnixNano&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//纳秒时间戳&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;current timestamp1:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, timestamp1)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;current timestamp2:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%v\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, timestamp2)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;使用time.Unix()函数可以将时间戳转为时间格式&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3 id=&quot;article-时间间隔-1&quot;&gt;时间间隔&lt;/h3&gt;&lt;p&gt;time.Duration是time包定义的一个类型，它代表两个时间点之间经过的时间，以纳秒为单位&lt;/p&gt;

&lt;h3 id=&quot;article-时间操作-1&quot;&gt;时间操作&lt;/h3&gt;
&lt;h4 id=&quot;article-add-1&quot;&gt;Add&lt;/h4&gt;&lt;p&gt;时间+时间间隔&lt;/p&gt;
&lt;p&gt;方法签名：&lt;code&gt;func (t Time) Add(d Duration) Time&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;eg:&lt;code&gt;later := now.Add(time.Hour) // 当前时间加1小时后的时间&lt;/code&gt;&lt;/p&gt;

&lt;h4 id=&quot;article-sub-1&quot;&gt;Sub&lt;/h4&gt;&lt;p&gt;求两个时间之间的差值：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;func (t Time) Sub(u Time) Duration&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;返回一个时间段t-u(Duration)&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;要获取时间点t-d（d为Duration），可以使用&lt;code&gt;t.Add(-d)&lt;/code&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-equal-1&quot;&gt;Equal&lt;/h4&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;func (t Time) Equal(u Time) bool&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;判断两个时间是否相同，会考虑时区的影响，因此不同时区标准的时间也可以正确比较。&lt;/p&gt;

&lt;h4 id=&quot;article-before-1&quot;&gt;Before&lt;/h4&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;func (t Time) Before(u Time) bool&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;如果t代表的时间点在u之前，返回真；否则返回假。&lt;/p&gt;

&lt;h3 id=&quot;article-定时器-1&quot;&gt;定时器&lt;/h3&gt;&lt;p&gt;使用time.Tick(时间间隔)来设置定时器，定时器的本质上是一个通道（channel）。&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; tickDemo&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    ticker &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Tick&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(time.Second) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//定义一个1秒间隔的定时器&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; ticker {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(i)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//每秒都会执行的任务&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-strconv包-1&quot;&gt;strconv包&lt;/h2&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;strconv&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;log&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;10&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 字符串转整数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    i, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Atoi&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(i) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出 10&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 字符串转64位浮点数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    f, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ParseFloat&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;     }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(f) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出 10.0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 字符串转布尔值（&quot;1&quot;→true，&quot;0&quot;→false，其他报错）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    b, err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;ParseBool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;1&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; err &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;!=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; nil&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        log.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Fatal&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(err)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(b) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出 true&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 整数转字符串&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Itoa&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(i)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出 &quot;10&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;     // 浮点数转字符串（格式&apos;f&apos;=十进制，精度2）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FormatFloat&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(f, &lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;f&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;     fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出 &quot;10.00&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 布尔值转字符串&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;     s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;FormatBool&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(b)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出 &quot;true&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-container-1&quot;&gt;container&lt;/h2&gt;&lt;p&gt;占位&lt;/p&gt;

&lt;h2 id=&quot;article-math-1&quot;&gt;math&lt;/h2&gt;&lt;p&gt;占位&lt;/p&gt;

&lt;h2 id=&quot;article-reflect-1&quot;&gt;reflect&lt;/h2&gt;&lt;p&gt;占位&lt;/p&gt;

&lt;h2 id=&quot;article-io-bufio-1&quot;&gt;IO &amp;amp; bufio&lt;/h2&gt;&lt;p&gt;占位&lt;/p&gt;

&lt;h2 id=&quot;article-os-1&quot;&gt;os&lt;/h2&gt;&lt;p&gt;占位&lt;/p&gt;

&lt;h2 id=&quot;article-sync-1&quot;&gt;sync&lt;/h2&gt;&lt;p&gt;见：&lt;strong&gt;&lt;a href=&quot;https://www.claran-blog.work/2025/10/27/Go-%E5%B9%B6%E5%8F%91%EF%BC%9AGo%EF%BC%8CChannel-sync%E5%8C%85/&quot;&gt;My Blog&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-http-gin-1&quot;&gt;http &amp;amp; Gin&lt;/h2&gt;&lt;p&gt;见：&lt;strong&gt;&lt;a href=&quot;https://www.claran-blog.work/2025/10/29/Go-Web%EF%BC%9A%E8%AE%A1%E7%BD%91%EF%BC%8Chttp%EF%BC%8CJSON%E5%92%8CGin%E6%A1%86%E6%9E%B6/&quot;&gt;My Blog&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-usually/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>Java-面向对象与类</title><link>https://www.claran-blog.work/posts/java-class/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/java-class/</guid><description>Java中面向对象与类的学习.</description><pubDate>Fri, 17 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-part-1-基础-1&quot;&gt;Part.1 基础&lt;/h2&gt;
&lt;h3 id=&quot;article-面向对象-面相过程-1&quot;&gt;面向对象&amp;amp;面相过程&lt;/h3&gt;
&lt;h4 id=&quot;article-面向对象-1&quot;&gt;面向对象&lt;/h4&gt;
&lt;h5 id=&quot;article-定义-1&quot;&gt;定义&lt;/h5&gt;&lt;p&gt;把数据及数据的操作方法放在一起，作为一个相互依存的整体——对象。也就是把一个物体相关的信息全部放在一个整体的容器中。&lt;/p&gt;

&lt;h5 id=&quot;article-三大特性-1&quot;&gt;三大特性&lt;/h5&gt;&lt;ol&gt;
&lt;li&gt;封装：把对象的构造方法/方法/变量等数据存在类中，并选择暴露可供调用的接口以允许外界进行相应操作，而为暴露的内容则会自我隐藏，外部代码不能直接访问或修改内部数据&lt;/li&gt;
&lt;li&gt;继承：可在一个类外定义其子类，子类自动拥有父类的属性或方法，并可拓展子类特有的内容。&lt;/li&gt;
&lt;li&gt;多态：对于同名方法/属性，可创造其不同的特殊内容&lt;/li&gt;
&lt;/ol&gt;

&lt;h4 id=&quot;article-面向过程-1&quot;&gt;面向过程&lt;/h4&gt;
&lt;h5 id=&quot;article-定义-2&quot;&gt;定义&lt;/h5&gt;&lt;p&gt;把事件裁缝为几个步骤，并将其按照一定的顺序执行&lt;/p&gt;

&lt;h4 id=&quot;article-面向对象和面向过程的区别-1&quot;&gt;面向对象和面向过程的区别&lt;/h4&gt;&lt;p&gt;以洗衣服为例：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;面向对象&lt;/strong&gt;be like：&lt;/p&gt;
&lt;p&gt;创建对象 &quot;人&quot;&amp;amp;&quot;洗衣机&quot;&lt;/p&gt;
&lt;p&gt;在&quot;人&quot;中创建方法：人.放衣服、人.加洗衣液、人.取衣服&lt;/p&gt;
&lt;p&gt;在&quot;洗衣机&quot;中创建方法：洗衣机.启动、洗衣机.甩干、洗衣机.停止&lt;/p&gt;
&lt;p&gt;执行：人.放衣服 -&amp;gt; 人.加洗衣液 -&amp;gt; 洗衣机.启动 -&amp;gt; 洗衣机.甩干 -&amp;gt; 洗衣机.停止 -&amp;gt; 人.取衣服&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;面相过程&lt;/strong&gt;be like：&lt;/p&gt;
&lt;p&gt;创建函数：洗衣服、放衣服、加洗衣液、拿衣服&lt;/p&gt;
&lt;p&gt;执行：放衣服 -&amp;gt; 加洗衣液 -&amp;gt; 洗衣服 -&amp;gt; 拿衣服&lt;/p&gt;
&lt;p&gt;这样看起来，面相过程不是更加简单吗？&lt;/p&gt;
&lt;p&gt;那如果现在要让用户额外写一个 洗衣机自清洁 的功能呢？&lt;/p&gt;
&lt;p&gt;面向过程就需要结合全局函数变量，重新写一个洗衣机自清洁的函数&lt;/p&gt;
&lt;p&gt;但是面相过程只需要在&quot;洗衣机&quot;类中额外拓展一个方法：洗衣机.自清洁即可&lt;/p&gt;
&lt;p&gt;由此，我们便可总结二者的差别优劣：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;/th&gt;
&lt;th&gt;面向对象&lt;/th&gt;
&lt;th&gt;面相过程&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;思路&lt;/td&gt;
&lt;td&gt;自内而外&lt;/td&gt;
&lt;td&gt;自上而下&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;程序单元&lt;/td&gt;
&lt;td&gt;对象&lt;/td&gt;
&lt;td&gt;函数&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;设计过程&lt;/td&gt;
&lt;td&gt;程序=对象=方法+数据&lt;/td&gt;
&lt;td&gt;函数=功能=算法+数据&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;优点&lt;/td&gt;
&lt;td&gt;使用便携、易于维护、易拓展&lt;/td&gt;
&lt;td&gt;独立化、性能高&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;缺点&lt;/td&gt;
&lt;td&gt;性能相对更低&lt;/td&gt;
&lt;td&gt;修改、维护困难&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;由此，我们正式进入面向对象&lt;/p&gt;
&lt;hr /&gt;

&lt;h3 id=&quot;article-java中的类与对象-1&quot;&gt;Java中的类与对象&lt;/h3&gt;&lt;p&gt;科普：命名习惯：&lt;/p&gt;
&lt;p&gt;类名首字母大写，后续单词首字母大写&lt;/p&gt;
&lt;p&gt;变量/方法首字母小写，后续单词字母大写&lt;/p&gt;

&lt;h4 id=&quot;article-类-方法的声明-使用-1&quot;&gt;类/方法的声明/使用&lt;/h4&gt;&lt;p&gt;声明格式：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;public&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; class&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; FightingRound&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//注：类名一定要与文件名保持一致！&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; String bossName;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bossHealth;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; atk;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 成员变量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    public&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; void&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; attack&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 成员方法1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        bossHealth &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; atk;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        System.out.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;你对Boss造成了%d点伤害！&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,atk);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(bossHealth &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;this&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;end&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;();&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 调用成员方法2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    public&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; void&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; end&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 成员方法2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        System.out.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;你打败了Boss!&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-对象的声明-使用-1&quot;&gt;对象的声明/使用&lt;/h4&gt;&lt;p&gt;对象的声明：【 FightingRound bossFight = new FightingRound(); 】&lt;/p&gt;
&lt;p&gt;声明变量相当于声明一个struct的数据类型，类型为类Fightinground&lt;/p&gt;

&lt;h4 id=&quot;article-方法的调用-1&quot;&gt;方法的调用&lt;/h4&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;FightingRound bossFight &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; new&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; FightingRound&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;bossFight.bossName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;Mon3tr&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;bossFight.bossHeath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;bossFight.atk &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 30&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    bossFight.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;attack&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;();&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;注：吃醋的bossFight本质上保存的并非具体的值，二十指向保存着这些值的地址&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h4 id=&quot;article-匿名对象-1&quot;&gt;匿名对象&lt;/h4&gt;&lt;p&gt;即不直接创建对象便调用方法的操作：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;System.out.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;你遭遇了Boss！但是它很虚弱，你可以一击秒杀它！&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;new&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; FightingRound.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;end&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;();&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这种方法可以让我们在调用方法后迅速回收内存，提升程序运行效率&lt;/p&gt;

&lt;h4 id=&quot;article-访问修饰符-1&quot;&gt;访问修饰符&lt;/h4&gt;&lt;p&gt;即【private】【default】【protect】【public】&lt;/p&gt;
&lt;p&gt;用来修饰变量/方法/类等数据的访问权限的修饰符&lt;/p&gt;
&lt;p&gt;以下为以上访问修饰符的区别：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;访问修饰符&lt;/th&gt;
&lt;th&gt;本类&lt;/th&gt;
&lt;th&gt;同包&lt;/th&gt;
&lt;th&gt;子类&lt;/th&gt;
&lt;th&gt;不同包&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;&lt;tr&gt;
&lt;td&gt;private&lt;/td&gt;
&lt;td&gt;✓&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;default&lt;/td&gt;
&lt;td&gt;✓&lt;/td&gt;
&lt;td&gt;✓&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;protect&lt;/td&gt;
&lt;td&gt;✓&lt;/td&gt;
&lt;td&gt;✓&lt;/td&gt;
&lt;td&gt;✓&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;public&lt;/td&gt;
&lt;td&gt;✓&lt;/td&gt;
&lt;td&gt;✓&lt;/td&gt;
&lt;td&gt;✓&lt;/td&gt;
&lt;td&gt;✓&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;

&lt;h4 id=&quot;article-构造方法-1&quot;&gt;构造方法&lt;/h4&gt;&lt;p&gt;在初始化对象的同时给对象的属性赋值&lt;/p&gt;
&lt;p&gt;格式为&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;class&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; 类名称&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    访问修饰符 &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;类名称&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;数据类型&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt; 参数&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;...){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ... &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//构造方法是没有返回值的！&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;eg.&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;public&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; class&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; FightingRound&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; String bossName;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bossHealth;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; atk;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    public&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; FightingRound{&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 构造方法的名称必须与类名称一致！&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        System.out.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;对象建立成功&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    public&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; FightingRound&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(String &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;bossName&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt; bossHealth&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt; atk&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;){&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 构造方法的名称必须与类名称一致！&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;        this&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;        this&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.bossName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bossName;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;        this&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.bossHealth &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bossHealth;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;        this&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.atk &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; atk;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 构造方法无返回值！&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    public&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; void&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; attack&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        bossHealth &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;-=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; atk;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        System.out.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;你对Boss造成了%d点伤害！&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,atk);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(bossHealth &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;this&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;end&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    public&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; void&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; end&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        System.out.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;你打败了Boss!&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;像这样子建立一个构造方法，在后许对象的创建时就能直接给对象赋值：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;FightingRound bossFight &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; new&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; FightingRound&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Mon3tr&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;100&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;30&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;bossFight.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;attack&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-this-1&quot;&gt;this&lt;/h4&gt;&lt;p&gt;上述代码中存在没学过的关键词：this&lt;/p&gt;
&lt;p&gt;this：是对自身对象的一个地址引用，即指自身&lt;/p&gt;
&lt;p&gt;使用意义：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;一般情况下，在函数参数或函数中的局部变量和成员变量&lt;strong&gt;同名&lt;/strong&gt;的情况下，成员变量会被局部变量或参数覆盖屏蔽，此时若要访问成员变量，这可以用【 this.成员变量名 】的方式引用成员变量，即引用被屏蔽的上级变量。&lt;/li&gt;
&lt;li&gt;在函数中，需要引用改行书所属类的当前对象是，使用this实现&lt;/li&gt;
&lt;li&gt;类内部之间可以互相调用，构造方法也是一样。使用this调用另一个构造方法，使用【this(参数列表)】实现。注意，使用该语法时，【this(参数列表);】必须被放置在第一行，否则就会报错。&lt;/li&gt;
&lt;/ol&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;private&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; String bossName;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bossHealth;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    private&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; atk;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    public&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; FightingRound{&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 构造方法1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        System.out.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;对象建立成功&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    public&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; FightingRound&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(String bossName,&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bossHealth,&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; atk){&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 构造方法2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;        this&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;();&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 调用 构造方法1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;        this&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.bossName &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bossName;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 访问外部变量，即外部的bossName = 参数的bossName&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;        this&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.bossHealth &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; bossHealth;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 访问外部变量，同上&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;        this&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;.atk &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; atk;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 构造方法无返回值！&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-方法重载-1&quot;&gt;方法重载&lt;/h4&gt;&lt;p&gt;即可以定义两个同名的方法，通过在方法定义是添加不同函数参数，来实现同名方法的不同调用方法&lt;/p&gt;
&lt;p&gt;eg：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;public&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; void&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; end&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    System.out.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;你打败了Boss!&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;public&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; void&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; end&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; atk){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    System.out.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;你打败了Boss，终结一击为%d伤害！&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,atk);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;这样定义两个同名方法，在后续调用时通过添加不同的参数列表达到方法的不同调用，就叫做方法重载&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;bossFight.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;end&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;();&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;bossFight.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;end&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;30&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;运行结果为：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;你打败了Boss！&lt;/p&gt;
&lt;p&gt;你打败了Boss！终结一击为30伤害！&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;注意：返回值不会算成判断方法重载的要素&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/java-class/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>其他语言</category><category>杂项</category></item><item><title>Go-基础语法知识</title><link>https://www.claran-blog.work/posts/go-basic/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/go-basic/</guid><description>Golang语言的基础语法学习.</description><pubDate>Thu, 16 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;推荐学习网站：&lt;a href=&quot;https://www.cainiaojc.com/golang/golang-tutorial.html&quot;&gt;菜鸟教程&lt;span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;注：golang&lt;strong&gt;不用打分号&lt;/strong&gt;！！！&lt;/p&gt;
&lt;p&gt;另：当变量/类型/函数名等标识符以大写字符开头，则该标识符对外部可见（即Java中的public），否则对外不可见&lt;/p&gt;

&lt;h2 id=&quot;article-头文件-包-的声明-imort-1&quot;&gt;头文件（包）的声明：imort&lt;/h2&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; //基础包&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;hr /&gt;

&lt;h2 id=&quot;article-基础框架-1&quot;&gt;基础框架&lt;/h2&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    ...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-输入-输出-1&quot;&gt;输入/输出&lt;/h2&gt;&lt;p&gt;在go中，输入输出所在包为** fmt 基础包**&lt;/p&gt;
&lt;p&gt;注：Print/Scan 首字母&lt;strong&gt;需要大写&lt;/strong&gt;！&lt;/p&gt;

&lt;h3 id=&quot;article-输出-1&quot;&gt;输出&lt;/h3&gt;&lt;p&gt; &lt;strong&gt;%v 以默认格式打印值，打印任意类型的变量的值&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;%+v:结构体时会显示字段名和值&lt;/p&gt;
&lt;p&gt;%#v:值的Go语法表示&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;There have &quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,num,&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot; numbers&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Auto \0&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; + $d = &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,a,b,a&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;b)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-输入-1&quot;&gt;输入&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scan&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;a,&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;b)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Scanf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; %c&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;a,&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;c)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;hr /&gt;

&lt;h2 id=&quot;article-常量-1&quot;&gt;常量&lt;/h2&gt;&lt;p&gt;const同C，替代var&lt;/p&gt;

&lt;h3 id=&quot;article-inta-在const内自动逐行计数-1&quot;&gt;inta：在const内自动逐行计数&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    const&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;            a&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; iota&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;   //0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;            b&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;          //1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;            c&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;          //2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;            d&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;ha&quot;&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;   //独立值，iota += 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;            e&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;          //&quot;ha&quot;   iota += 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;            f&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 100&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    //iota +=1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;            g&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;          //100  iota +=1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;            h&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; iota&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;   //7,恢复计数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;            i&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;          //8&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    )&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(a,b,c,d,e,f,g,h,i)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-声明变量-1&quot;&gt;声明变量&lt;/h2&gt;&lt;p&gt;注意：未使用过的变量会导致编译错误（全局变量除外）&lt;/p&gt;
&lt;p&gt;在Go中，未初始化的变量会自动赋初始值（默认为&quot;零值&quot;）&lt;/p&gt;
&lt;p&gt;int32 = int&lt;/p&gt;
&lt;p&gt;int64 = long long&lt;/p&gt;
&lt;p&gt;Go中有多种声明变量的方式：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; 变量名称 &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;数据类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;变量名称 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; 值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;eg:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; a &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;a &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; [&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;a &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;sum &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; a&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;b;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; (&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    n &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    b &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;bool&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    num &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;float32&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;hr /&gt;

&lt;h2 id=&quot;article-函数-1&quot;&gt;函数&lt;/h2&gt;&lt;p&gt;函数的声明：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; 数据名称&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;参数&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)(&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;返回类型&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; 返回值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;注意，同一函数&lt;strong&gt;返回多个值&lt;/strong&gt;是合法的：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; swap&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;x&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;y&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; y,x&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-可变参数函数-1&quot;&gt;可变参数函数&lt;/h3&gt;&lt;p&gt;在不确定会传入多少个参数时使用：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; sum&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;numbers&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; ...int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    ...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;blockquote&gt;
&lt;p&gt;numbers ... int实际上是个[]int切片&lt;/p&gt;
&lt;p&gt;同时 ... 还可以用来展开切片：&lt;/p&gt;
&lt;p&gt;存在num切片，使用sum(num...)即可全部累加&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3 id=&quot;article-构造函数与工厂函数-1&quot;&gt;构造函数与工厂函数&lt;/h3&gt;&lt;p&gt;用于标准化构造结构体或其他自定义结构的函数&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; NewPerson&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;age&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Person&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; &amp;amp;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Person&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{Name: name, Age: age}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;hr /&gt;

&lt;h2 id=&quot;article-函数一等公民-1&quot;&gt;函数一等公民&lt;/h2&gt;&lt;p&gt;函数是一等公民是指函数在语言中具有与其他数据类型（如数字、字符串等）相同的地位&lt;/p&gt;
&lt;p&gt;也就是说，函数可以被当做一种数据类型而被用作赋值、参数传递、返回值。&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;   &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 定义一个函数类型&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; mathOperation&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 这个类型可以表示任何参数为(int, int) 且返回值为int的函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 一个普通的加法函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; add&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;a&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;b&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; a &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; b&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 一个函数，接受另一个函数作为参数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; calculate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;op&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;a&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;b&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; { &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 添加一个函数参数，该函数餐位数的参数为(int, int)且返回值为int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; op&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(a, b)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 返回执行该参数函数后的值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 一个函数返回另一个函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getMultiplier&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;mathOperation&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 返回值为(int, int) int类型的函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    return&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; func&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;a&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;b&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 返回功能为两数相乘的函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; a &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; b&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 将函数赋值给变量&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; operation &lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;mathOperation&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt; // 定义一个(int, int) int类函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    operation &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; add &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 该函数被赋予add的内容&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 调用函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; operation&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// result := add(3, 4)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;3 + 4 =&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 将函数作为参数传递给另一个函数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; calculate&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(add, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;6&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//在calculate中，返回值为add(5, 6);故result = add(5, 6)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;5 + 6 =&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;    // 将函数作为返回值&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    multiplier &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; getMultiplier&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// multiplier = unc(int,a b int) int{ return a*b }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    result &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; multiplier&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;7&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// result = 3*7&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;3 * 7 =&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, result)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;hr /&gt;

&lt;h2 id=&quot;article-for-gota-if-defer-switch-1&quot;&gt;for/gota/if/defer/switch&lt;/h2&gt;
&lt;h3 id=&quot;article-for-1&quot;&gt;for&lt;/h3&gt;&lt;p&gt;区别于C++，在Go中，for/if&lt;strong&gt;不需要括号&lt;/strong&gt;框入三段式，且省略三段式时可省略分号：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;;i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; n;i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(i)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    ...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; sum &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; n {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    sum&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    ...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;另外，for循环的range形式可遍历切片或映射&lt;/p&gt;
&lt;p&gt;当使用for循环遍历切片时，每次迭代都会返回两个值：&lt;strong&gt;第一个值为当前元素的下标，第二个值为改下表所对应的元素的一份副本&lt;/strong&gt;&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; num &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;8&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;16&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;32&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;64&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;128&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i, v &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; num {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;i=&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,i&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot; v=&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,v)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;同时，可以将下标或值写为_以忽略它&lt;/p&gt;
&lt;p&gt;&lt;code&gt;for i, _ := range a&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;&lt;code&gt;for _, value := range a&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;若只需要下标，忽略第二个变量即可&lt;/p&gt;
&lt;p&gt;&lt;code&gt;for i := range pow&lt;/code&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-gota-1&quot;&gt;gota&lt;/h3&gt;&lt;p&gt;通过定义标签，跳转到被标记的区域 （尽在同一函数内有用）&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;package&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;fmt&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Loop: &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 定义标签&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(i)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;++&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;        goto&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; Loop &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 跳转到 Loop 标签&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-if-1&quot;&gt;if&lt;/h3&gt;&lt;p&gt;同时，if语句可以在条件表达式前&lt;strong&gt;执行一个简短短语&lt;/strong&gt;（该语句声明的变量作用域仅在 if / else 之内）：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;if&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tmp &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;j;tmp &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; max {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    tmp&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;cnt&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    ...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-defer-1&quot;&gt;defer&lt;/h3&gt;&lt;p&gt;defer语句会将函数推迟到外层函数返回之后执行：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;func&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot; world!&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Hello&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//输出:Hello world!&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;注：被推迟调用的函数会被压入一个栈中&lt;/p&gt;
&lt;p&gt;defer 常见的使用就是在函数结束后执行一些收尾工作，比如我们在打开文件之后，在程序结束的时候需要关闭这个文件，以及在我们创建一个临时管道的时候需要在函数退出的时候能够及时关闭这个管道。&lt;br /&gt;另外 defer 也是一个比较常考的八股文，比如，在以下两个函数中，函数的返回值会是什么呢？为什么会有区别，这就涉及到 defer 和 return 的执行过程：&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;package main&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;import &quot;fmt&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;func returnValue1() int {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;a := 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;defer func() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;a += 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;return a&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;func returnValue2() (a int) {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;a = 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;defer func() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;a += 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;        return a&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;func main() {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;fmt.Println(returnValue1()) // 1&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;fmt.Println(returnValue2()) // 2&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;在 return 的时候，如果函数签名没有定义返回的变量，那就会定义一个临时变量，或者说帮你填充了一个你不知道的变量名，然后将返回的数据赋予这个临时变量，如果你已经定义好了变量名，那就将返回的数据赋予给这个定义的变量；第二步，我们会执行 defer 的操作；最后，我们真正将这个临时变量/已经定义的变量返回回去。&lt;br /&gt;也就是说，我们在函数签名已经定义好了变量名的时候，在最后会将这个变量名的值返回，如果没有，那么就会首先定义一个临时变量，然后赋予它返回值，再执行 defer 的函数，最后将这个临时变量返回。&lt;br /&gt;大概是这样的：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 如果定义了返回值变量名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;a &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; 返回的数据&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; xxxx &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 此时对 a 执行修改操作会反馈到 return 值上面&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; a&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 如果没有定义变量名&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;tmp &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; a&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;defer&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; xxx &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 此时如果对 a 进行修改无法反馈到 tmp 上面&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;return&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; tmp&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;简单来说分为三步，就是赋值，执行defer，返回值。&lt;/p&gt;

&lt;h3 id=&quot;article-switch-1&quot;&gt;switch&lt;/h3&gt;&lt;p&gt;处理多分支情况&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;fallthrough可以在匹配一条 case 之后，继续执行后面的 case &lt;/p&gt;
&lt;/blockquote&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;t &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; time.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Now&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;()&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	switch&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;	// 根据现在的时间判断是上午还是下午&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	case&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; t.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Hour&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;() &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;&amp;lt;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 12&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;It&apos;s before noon&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;	default&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;		fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;It&apos;s after noon&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;	}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;hr /&gt;

&lt;h2 id=&quot;article-指针-1&quot;&gt;指针&lt;/h2&gt;&lt;p&gt;仅与C++不同的是，Go无法进行指针运算&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;注：Go语言对结构体指针提供了语法糖，即可以直接通过指针访问字段，而不用再显示解引用&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//传统指针（如C）&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;target).Heath &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 50&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//go&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;target.Health &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 50&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;hr /&gt;

&lt;h2 id=&quot;article-结构体-1&quot;&gt;结构体&lt;/h2&gt;&lt;p&gt;与C++仅声明格式不同：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;type&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; student&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; struct&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    height &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    weight &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    score &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    name &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;hr /&gt;

&lt;h2 id=&quot;article-字符-1&quot;&gt;字符&lt;/h2&gt;&lt;p&gt;go中没有像c++中的char数据类型，与之相对的，go中有byte和rune两种数据类型&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;byte：用于存储ASCII中的字符&lt;/li&gt;
&lt;li&gt;rune：用于存储任意Unicode字符&lt;/li&gt;
&lt;/ol&gt;
&lt;hr /&gt;

&lt;h2 id=&quot;article-字符串-1&quot;&gt;字符串&lt;/h2&gt;&lt;p&gt;仅与C++不同的是，Go中字符串（直接声明的string）具有&lt;strong&gt;不可变性&lt;/strong&gt;（内容不可修改）&lt;/p&gt;
&lt;p&gt;另外，在&lt;code&gt;&quot;strings&quot;&lt;/code&gt;包中，存在若干便携的字符串函数：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;information &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;06072504&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;2025212533&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Claran&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//创建一个字符串切片&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;result1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strings.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Join&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(information,&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;-&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//字符串result1为由各字符串合成的单个字符串，以&apos;-&apos;链接&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-string-stringf-fmt-1&quot;&gt;String &amp;amp; Stringf (fmt)&lt;/h3&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 字符串生成&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s1 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprint&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(x, y, z)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s1) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出 &quot;10 3.14 Hello&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s2 &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Sprintf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;x=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%d&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, y=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%.2f&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;, z=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;%s&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, x, y, z)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s2) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 输出 &quot;x=10, y=3.14, z=Hello&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;hr /&gt;

&lt;h2 id=&quot;article-数组-切片-1&quot;&gt;数组/切片&lt;/h2&gt;
&lt;h3 id=&quot;article-数组-1&quot;&gt;数组&lt;/h3&gt;&lt;p&gt;数组声明格式：&lt;code&gt;var a [10]int&lt;/code&gt;  10不能为变量，但是可以为 ... 代替不确定长度的数组长度&lt;/p&gt;
&lt;p&gt;注意：Go语言中，数组的大小是类我，因此不同大小的数组是不兼容的。&lt;/p&gt;
&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span&gt;Go的数组不能随意改变大小，因此Go有其独特的功能：**切片**&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; a &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; [&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;b &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; [&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h3 id=&quot;article-切片-1&quot;&gt;切片&lt;/h3&gt;&lt;p&gt;类型 []T表示一个元素类型为T的切片，切片可以包含各种类型，包括其他切片。&lt;/p&gt;
&lt;p&gt;切片通过两个下标来界定：&lt;strong&gt;上界与下界&lt;/strong&gt; &lt;/p&gt;
&lt;p&gt;&lt;code&gt;a[low : high]&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;切片会选出一个区间，包含上界元素，但不包含下界元素&lt;/p&gt;
&lt;p&gt;因此 &lt;code&gt;a[1:4]&lt;/code&gt;实际包含了数组a[1]到a[3]的值&lt;/p&gt;
&lt;p&gt;在进行切片时，可以忽略上下界。此时，被忽略的上下界分别默认为0和其底层数组长度n&lt;/p&gt;
&lt;p&gt;另外，切片可以被声明为nil，即零值，此时其底层数组不存在，直到向其中添加值&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; a []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//创建一个空切片&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;base [&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;101&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;b ;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; base[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;51&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//创建一个含base[0]到base[50]的切片&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;c &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; base[:&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;51&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//与上句意义相同&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;此外，切片含3项结构：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;指针(ptr)&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;**长度(len) **- 切片含数量&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;容量(cap) -&lt;/strong&gt; 底层数组容量&lt;/li&gt;
&lt;/ul&gt;

&lt;h3 id=&quot;article-切片的操作-1&quot;&gt;切片的操作&lt;/h3&gt;
&lt;h4 id=&quot;article-make-1&quot;&gt;make&lt;/h4&gt;&lt;p&gt;格式：&lt;code&gt;make(数据类型,len,cap)&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;make函数为Go内置函数，可以用来&lt;strong&gt;直接创建切片&lt;/strong&gt;--make函数会分配一个元素为零值的数组并返回一个引用了它的切片：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;a &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// len(a)=5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;b &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;([]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; , &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// len(b)=0,cap(b)=5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;b &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; b[:&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;cap&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(b)] &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//len(b)=0 -&amp;gt; 5&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;b &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; b[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;:] &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//len(b)=5 -&amp;gt; 4  cap(b)=5 -&amp;gt; 4&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-append-1&quot;&gt;append&lt;/h4&gt;&lt;p&gt;格式：&lt;code&gt;append(切片名称 , 添加元素1 , ... )&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;append函数为Go的内置函数，可以用来&lt;strong&gt;为切片追加新的元素&lt;/strong&gt;。但被添加切片的底层数组太小，它就会被分配一个更大的数组。返回的切片会指向这个新分配的数组&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s []&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//可在空切片上添加&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; append&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(s,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//可以一次性添加多个元素&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h4 id=&quot;article-len-cap-1&quot;&gt;len/cap&lt;/h4&gt;&lt;p&gt;len()函数可以获取切片长度&lt;/p&gt;
&lt;p&gt;cap()函数可以获取切片容量&lt;/p&gt;

&lt;h4 id=&quot;article-copy-1&quot;&gt;copy&lt;/h4&gt;&lt;p&gt;copy可用于拷贝切片&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;copy&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(slice1,slice2)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//拷贝slice2的内容到silce1&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-range-1&quot;&gt;range&lt;/h2&gt;&lt;p&gt;用于for循环中迭代数组、字符串、切片、channel或map&lt;/p&gt;
&lt;p&gt;range在数组和切片中返回两个值：下标和对应值或只返回下标；在集合map中返回Key-value对&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;使用 _ 来忽略索引或值&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;例如：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;a &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; [&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;6&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;3&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;4&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;for&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; i, j &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; range&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; a {&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 若只有i则只返回下标&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(i,&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot; &quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,j)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// i返回下标，j返回a[i]&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id=&quot;article-map-1&quot;&gt;map&lt;/h2&gt;&lt;p&gt;与C++类似，map是一种无序的 索引-值 的集合&lt;/p&gt;
&lt;p&gt;使用make或字面量来创建map&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; make&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 创建ACSII map&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;m &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; map&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;byte&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;]&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;A&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 65&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    ...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;    &apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;a&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; =&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 97&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    ...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;} &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 另一种创建方式&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;m[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;a&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 97&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;m[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;A&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;] &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt; 65&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;fmt.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(m[&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;f&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;])&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 查询m对应的ASCII码&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;获取元素：&lt;/p&gt;
&lt;p&gt;&lt;code&gt;v, b := m[a] // 如果键不存在，则b的值为false，v2为零值&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;len、range同样对map适用&lt;/p&gt;
&lt;p&gt;使用delete删除键值对：&lt;/p&gt;
&lt;p&gt;&lt;code&gt;delete(m,&quot;a&quot;)&lt;/code&gt;&lt;/p&gt;

&lt;h2 id=&quot;article-强制数制转换-1&quot;&gt;强制数制转换&lt;/h2&gt;&lt;blockquote&gt;
&lt;p&gt;go不支持隐式类型转换&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;格式：&lt;code&gt;float32(6)&lt;/code&gt;&lt;/p&gt;

&lt;h3 id=&quot;article-strconv-1&quot;&gt;strconv&lt;/h3&gt;&lt;p&gt;使用 strconv.Atoi() 函数，可以自动解析字符串中的数字字符并返回相应整形&lt;/p&gt;
&lt;p&gt;相反 strconv.Itoa() 函数，可以将整形转换为字符串&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Go&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;str &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;:=&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt; &quot;123&quot;&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; num &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;num, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Atoi&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(str)&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// num = 123, _用于忽略strconv返回的错误&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;var&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; s &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;string&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;s, _ &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; strconv.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Itoa&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(num) &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// s = &quot;123&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;更多的strconv系列函数：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;strconv.ParseFloat(str, 64)         %s -&amp;gt; %f&lt;/li&gt;
&lt;li&gt;strconv.FormatFloat(f, &apos;f&apos;, 2/&lt;em&gt;精度&lt;/em&gt;/, 64)     %f -&amp;gt; %s&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/go-basic/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>Golang</category><category>后端</category></item><item><title>Java-基础语法知识</title><link>https://www.claran-blog.work/posts/java-basic/</link><guid isPermaLink="true">https://www.claran-blog.work/posts/java-basic/</guid><description>Java基础语法知识的学习.</description><pubDate>Thu, 16 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2 id=&quot;article-头文件-包-的声明-import-1&quot;&gt;头文件（包）的声明：import&lt;/h2&gt;&lt;p&gt;&lt;code&gt;import java.util......&lt;/code&gt;&lt;/p&gt;
&lt;hr /&gt;

&lt;h2 id=&quot;article-java-基本框架-1&quot;&gt;java 基本框架：&lt;/h2&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;public&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; class&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;    public&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; static&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; void&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; main&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;String&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[] &lt;/span&gt;&lt;span style=&quot;color:#E36209&quot;&gt;args&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;){&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;        ...&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;    }    &lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;hr /&gt;

&lt;h2 id=&quot;article-变量-1&quot;&gt;变量&lt;/h2&gt;&lt;p&gt;注：Java的变量在&lt;strong&gt;使用前要初始化&lt;/strong&gt;，否则会报错！&lt;/p&gt;
&lt;hr /&gt;

&lt;h2 id=&quot;article-输入-scanner-1&quot;&gt;输入：Scanner&lt;/h2&gt;&lt;p&gt;所在包 &lt;code&gt;import java.util.Scanner&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;用法：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;Scannner scan &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; new&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt; Scanner&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(System.in);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; n &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; scan.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;nextInt&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;();&lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//nextInt()方法会从读入流中读取一个整数&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;scan.close;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;读入流类型&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;nextInt()：整形&lt;/li&gt;
&lt;li&gt;nextByte()：byte型&lt;/li&gt;
&lt;li&gt;nextShort()：short型&lt;/li&gt;
&lt;li&gt;nextLong()：long型&lt;/li&gt;
&lt;li&gt;nextFloat()：float型&lt;/li&gt;
&lt;li&gt;nextDouble()：double型&lt;/li&gt;
&lt;li&gt;next()：读入一个字符串，直到&apos;\0&apos;&lt;/li&gt;
&lt;li&gt;nextLine()：读入一整行字符串，直到&apos;\n&apos;&lt;/li&gt;
&lt;/ul&gt;
&lt;blockquote&gt;
&lt;p&gt;注：next()后直接继续使用nextLine()回到是后者返回NULL，徐涛需要手动额外调动一次nextLine()以清除换行符&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr /&gt;

&lt;h2 id=&quot;article-输出-print-1&quot;&gt;输出：Print&lt;/h2&gt;&lt;p&gt;用法：&lt;/p&gt;
&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;System.out.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Print&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;字符串1&quot;&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;a&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;+&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;字符串2&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;System.out.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Println&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;Auto &lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;\n&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;);&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;System.out.&lt;/span&gt;&lt;span style=&quot;color:#6F42C1&quot;&gt;Printf&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;color:#032F62&quot;&gt;&quot;数字之和为%d，a = %d，b = %d&quot;&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;,sum,a,b);&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;特殊字面量：&lt;/p&gt;
&lt;p&gt;&lt;code&gt;%t //制表符，在打印时将前面字符串的长度补齐到8或8的整数倍&lt;/code&gt;&lt;/p&gt;
&lt;hr /&gt;

&lt;h2 id=&quot;article-for-if-else-while-函数-return-1&quot;&gt;for/if/else/while/函数/return&lt;/h2&gt;&lt;p&gt;与C++类似&lt;/p&gt;
&lt;hr /&gt;

&lt;h2 id=&quot;article-数组-存在重点差异-1&quot;&gt;数组 (存在重点差异)&lt;/h2&gt;&lt;p style=&quot;font-size:12px&quot;&gt;Java&lt;/p&gt;&lt;pre style=&quot;padding:16px;background:#f6f8fa;color:#24292f;border-radius:9px;white-space:pre-wrap;overflow-wrap:anywhere&quot;&gt;&lt;code&gt;&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[] a &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt; {&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;0&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;}; &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;//声明一个长度为1、初始值为0的数组&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[] a &lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; new&lt;/span&gt;&lt;span style=&quot;color:#D73A49&quot;&gt; int&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;[&lt;/span&gt;&lt;span style=&quot;color:#005CC5&quot;&gt;5&lt;/span&gt;&lt;span style=&quot;color:#24292E&quot;&gt;] &lt;/span&gt;&lt;span style=&quot;color:#6A737D&quot;&gt;// 声明一个长度为5、已初始化（初始值为0）的数组&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;a href=&quot;https://www.claran-blog.work/posts/java-basic/&quot;&gt;在网站中阅读原文&lt;/a&gt;&lt;/p&gt;</content:encoded><category>其他语言</category><category>杂项</category></item></channel></rss>