go gin userAgent如何解析是手机还是PC

在 Gin 框架中解析 User-Agent 判断设备类型，可以通过手动解析或第三方库实现，推荐结合Gin 中间件使用。以下是具体方案：

一、手动解析（零依赖）

直接在 Gin 处理器中检查 User-Agent 字符串，适合简单场景：

go

复制

package main import ( "net/http" "strings" "github.com/gin-gonic/gin" ) // IsMobile 判断是否为移动设备 func IsMobile(userAgent string) bool { if userAgent == "" { return false } ua := strings.ToLower(userAgent) mobileKeywords := []string{ "mobile", "android", "iphone", "ipad", "ipod", "windows phone", "phone", "pad", "symbian", "blackberry", "nokia", "samsung", "htc", } for _, keyword := range mobileKeywords { if strings.Contains(ua, keyword) { return true } } return false } func main() { r := gin.Default() r.GET("/", func(c *gin.Context) { userAgent := c.GetHeader("User-Agent") deviceType := "PC端" if IsMobile(userAgent) { deviceType = "移动端" } c.JSON(http.StatusOK, gin.H{ "user_agent": userAgent, "device_type": deviceType, }) }) r.Run(":8080") }

二、使用第三方库（推荐）

1. 使用mileusna/useragent库

安装：

bash

复制

go get github.com/mileusna/useragent

Gin 集成示例：

go

复制

package main import ( "net/http" "github.com/gin-gonic/gin" "github.com/mileusna/useragent" ) func main() { r := gin.Default() r.GET("/", func(c *gin.Context) { uaString := c.GetHeader("User-Agent") ua := useragent.Parse(uaString) c.JSON(http.StatusOK, gin.H{ "user_agent": uaString, "device": ua.Device, // PC / Phone / Tablet / Bot "os": ua.OS, "browser": ua.Name, "version": ua.Version, "mobile": ua.Device == "Phone" || ua.Device == "Tablet", }) }) r.Run(":8080") }

2. 使用mssola/useragent库

安装：

bash

复制

go get github.com/mssola/useragent

Gin 集成示例：

go

复制

package main import ( "net/http" "github.com/gin-gonic/gin" "github.com/mssola/useragent" ) func main() { r := gin.Default() r.GET("/", func(c *gin.Context) { uaString := c.GetHeader("User-Agent") ua := useragent.New("") ua.Parse(uaString) c.JSON(http.StatusOK, gin.H{ "user_agent": uaString, "mobile": ua.Mobile(), "os": ua.OS(), "browser": ua.Name(), "version": ua.Version(), "device_type": func() string { if ua.Mobile() { return "移动端" } return "PC端" }(), }) }) r.Run(":8080") }

三、最佳实践：Gin 中间件模式

将设备类型判断逻辑封装为中间件，供全局或局部路由使用：

go

复制

package main import ( "net/http" "strings" "github.com/gin-gonic/gin" ) // DeviceType 设备类型常量 const ( DevicePC = "pc" DeviceMobile = "mobile" DeviceTablet = "tablet" ) // DeviceInfo 设备信息 type DeviceInfo struct { Type string UserAgent string } const deviceInfoKey = "_device_info" // DeviceMiddleware 设备检测中间件 func DeviceMiddleware() gin.HandlerFunc { return func(c *gin.Context) { userAgent := c.GetHeader("User-Agent") deviceType := detectDevice(userAgent) // 将设备信息存储到 Gin Context c.Set(deviceInfoKey, DeviceInfo{ Type: deviceType, UserAgent: userAgent, }) // 为模板渲染添加全局变量 c.Set("isMobile", deviceType == DeviceMobile) c.Set("isPC", deviceType == DevicePC) c.Next() } } // detectDevice 检测设备类型 func detectDevice(userAgent string) string { if userAgent == "" { return DevicePC } ua := strings.ToLower(userAgent) // 平板识别 tabletKeywords := []string{"ipad", "android pad", "tablet", "kindle"} for _, keyword := range tabletKeywords { if strings.Contains(ua, keyword) { return DeviceTablet } } // 手机识别 mobileKeywords := []string{ "mobile", "android", "iphone", "ipod", "windows phone", "phone", "symbian", "blackberry", "nokia", "htc", } for _, keyword := range mobileKeywords { if strings.Contains(ua, keyword) { return DeviceMobile } } return DevicePC } // GetDeviceInfo 从Context获取设备信息 func GetDeviceInfo(c *gin.Context) (DeviceInfo, bool) { info, exists := c.Get(deviceInfoKey) if !exists { return DeviceInfo{}, false } return info.(DeviceInfo), true } func main() { r := gin.Default() // 应用全局中间件 r.Use(DeviceMiddleware()) // 路由示例 r.GET("/", func(c *gin.Context) { deviceInfo, _ := GetDeviceInfo(c) c.JSON(http.StatusOK, gin.H{ "device_type": deviceInfo.Type, "user_agent": deviceInfo.UserAgent, "message": func() string { switch deviceInfo.Type { case DeviceMobile: return "您正在使用移动设备访问" case DeviceTablet: return "您正在使用平板设备访问" default: return "您正在使用PC访问" } }(), }) }) // 为移动端和PC端返回不同内容 r.GET("/home", func(c *gin.Context) { deviceInfo, _ := GetDeviceInfo(c) if deviceInfo.Type == DeviceMobile { c.String(http.StatusOK, "移动端首页") return } c.String(http.StatusOK, "PC端首页") }) r.Run(":8080") }

四、方案对比

表格

复制

生产环境建议：使用第三方库 + 中间件组合，平衡准确性与开发效率。