最全Go Gin框架中的路由组特性及其区别解析_gin 路由组(1)，系统盘点Golang开发者必须掌握的知识点

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

在此示例中，所有用户相关的路由都在`/v1`组下，它们可以共享例如认证、权限检查的中间件。


### 3. `/v1/system` 路由组


`/v1/system`是一个更具体的路由组，通常用于处理系统级别的API请求，如系统状态、配置等。


#### 3.1 特性


* **特定功能聚焦**：与`/v1`相比，`/v1/system`聚焦于系统相关的功能，使得路由更加专业化和细分。
* **继承和扩展**：`/v1/system`继承了`/v1`的所有特性（如版本管理和中间件），同时可以添加其特有的中间件或逻辑。


#### 3.2 示例

system := v1.Group(“/system”)
{
system.GET(“/status”, systemStatusHandler)
system.POST(“/config”, updateConfigHandler)
}

在此示例中，所有系统级别的操作都在`/v1/system`下，它继承了`/v1`的中间件并可能有自己的特定逻辑。


### 4. 两者的区别


* **路径层级**：`/v1`是一个基础层级，代表了API的一个主要版本；而`/v1/system`是更具体的子层级，专注于系统相关功能。
* **功能聚焦**：`/v1`适合作为更广泛的功能集的基础，如用户管理、订单处理等；而`/v1/system`更适合特定的、通常是低级的系统功能。
* **中间件和处理逻辑**：虽然两者都可以使用中间件，但`/v1/system`可以在继承`/v1`的中间件基础上进一步添加特定的逻辑。


### 5.优先级


在Gin框架中，路由的匹配是基于首先遇到的最精确匹配原则进行的。这意味着Gin在处理请求时会从注册的路由中找到最先匹配的一个。因此，理论上讲，更具体的路由（即路径更长或更复杂的路由）通常会有更高的优先级。这是因为它们提供了更精确的匹配条件。


在前面的例子中，`/v1/system`本身就因为更具体，相对于`/v1`而言，在Gin的路由匹配机制中自然拥有更高的优先级。当我们定义了这两个路由组时，任何发送到`/v1/system`的请求都会被`/v1/system`路由组中的路由处理，而不会落到`/v1`上。这是因为`/v1/system`提供了更精确的匹配。

router := gin.Default()

// 定义/v1路由组
v1 := router.Group(“/v1”)
{
v1.GET(“/”, v1Handler) // 处理 /v1
}

// 定义/v1/system路由组，它自然拥有比/v1更高的优先级
v1System := router.Group(“/v1/system”)
{
v1System.GET(“/”, v1SystemHandler) // 处理 /v1/system
}

router.Run(“:8080”)

在上面的代码中，即使`v1System`在代码中定义在`v1`之后，请求`/v1/system`仍然会被`v1SystemHandler`处理，因为它提供了一个更精确的匹配。


#### 5.1确保优先级


在Gin中，路由的注册顺序也会影响匹配过程。Gin在内部维护了一个路由列表，新注册的路由会被添加到列表的末尾。因此，尽管具体的路由通常有更高的优先级，但在某些复杂的情况下（尤其是涉及到路径参数时），确保我们的具体路由先被注册可以提供额外的保障。


#### 5.2注意事项


* **路由冲突**：确保你的路由模式之间没有冲突，特别是当使用路径参数时（如`/v1/:param`和`/v1/specific`可能会冲突）。
* **清晰的路由设计**：一个清晰和有组织的路由设计可以减少潜在的问题，遵循RESTful原则可以使你的API更直观易用。




![img](https://img-blog.csdnimg.cn/img_convert/66c77467a11290226db9da5587fefd84.png)
![img](https://img-blog.csdnimg.cn/img_convert/db395418ab65a76d99a3237e70daf038.png)

**网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。**

**[需要这份系统化的资料的朋友，可以添加戳这里获取](https://bbs.csdn.net/topics/618658159)**


**一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**

**


**一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**