Gin框架能否用单一路由匹配:item或:id两种查询参数？

Gin并不支持你示例中/inventories/(:item|:id)这种同时指定两个参数名称的路由语法——它的路由占位符是一对一绑定参数名的。不过你可以通过以下几种方式实现类似需求：

方案1：使用通用参数名，在处理函数中判断参数类型 #

定义一个通用的路由参数（比如:identifier），然后在处理函数里判断这个参数是ID（通常为数字）还是物品名称，再执行对应的查询逻辑：

// 定义路由
r.GET("/inventories/:identifier", controllers.FindInventory)

处理函数实现：

import (
    "strconv"
    "net/http"
    "github.com/gin-gonic/gin"
)

func FindInventory(g *gin.Context) {
    var inv models.Inventory
    identifier := g.Param("identifier")

    // 尝试将参数转为整数，判断是否是ID
    id, err := strconv.Atoi(identifier)
    if err == nil {
        // 参数是ID，按ID查询
        if err := models.DB.Where("id = ?", id).First(&inv).Error; err != nil {
            g.JSON(http.StatusNotFound, gin.H{"error": "Record not found!"})
            return
        }
    } else {
        // 参数是物品名称，按名称查询
        if err := models.DB.Where("item = ?", identifier).First(&inv).Error; err != nil {
            g.JSON(http.StatusNotFound, gin.H{"error": "Record not found!"})
            return
        }
    }

    g.JSON(http.StatusOK, gin.H{"data": inv})
}

方案2：使用路由正则约束（复用处理函数） #

如果你想在路由层面就区分ID和名称的格式，可以利用Gin的路由正则匹配功能，分别定义路由但复用同一个处理函数：

// 先定义更具体的数字ID路由，避免被更宽泛的路由覆盖
r.GET("/inventories/:id([0-9]+)", controllers.FindInventory)
// 匹配非数字的物品名称路由
r.GET("/inventories/:item([^0-9]+)", controllers.FindInventory)

处理函数中判断哪个参数存在：

func FindInventory(g *gin.Context) {
    var inv models.Inventory
    var err error

    if id := g.Param("id"); id != "" {
        err = models.DB.Where("id = ?", id).First(&inv).Error
    } else if item := g.Param("item"); item != "" {
        err = models.DB.Where("item = ?", item).First(&inv).Error
    }

    if err != nil {
        g.JSON(http.StatusNotFound, gin.H{"error": "Record not found!"})
        return
    }

    g.JSON(http.StatusOK, gin.H{"data": inv})
}

方案3：使用查询参数（替代路径参数） #

如果业务允许，也可以用查询参数的方式实现，无需在路径中区分参数类型：

r.GET("/inventories", controllers.FindInventory)

处理函数实现：

func FindInventory(g *gin.Context) {
    var inv models.Inventory
    var err error

    if id := g.Query("id"); id != "" {
        err = models.DB.Where("id = ?", id).First(&inv).Error
    } else if item := g.Query("item"); item != "" {
        err = models.DB.Where("item = ?", item).First(&inv).Error
    } else {
        g.JSON(http.StatusBadRequest, gin.H{"error": "Please provide either id or item parameter"})
        return
    }

    if err != nil {
        g.JSON(http.StatusNotFound, gin.H{"error": "Record not found!"})
        return
    }

    g.JSON(http.StatusOK, gin.H{"data": inv})
}

用户可通过/inventories?id=1或/inventories?item=apple的方式发起查询。

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