Gin 框架中的重定向功能是 Web 开发中常用的操作，常用于页面跳转、路由转发或 HTTP 请求的临时/永久重定向。以下是 Gin 重定向功能的详细讲解：

一、基本用法

Gin 提供了 c.Redirect() 方法实现重定向，需指定 HTTP 状态码和 目标 URL。

示例代码：

package main

import "github.com/gin-gonic/gin"

func main() {
    r := gin.Default()
    
    // 触发重定向的路由
    r.GET("/old", func(c *gin.Context) {
        // 302 临时重定向到 /new
        c.Redirect(302, "/new")
    })
    
    r.GET("/new", func(c *gin.Context) {
        c.String(200, "This is the new page!")
    })

    r.Run(":8080")
}

访问 /old 会自动跳转到 /new。

二、重定向类型

1. 内部重定向（同一应用内）

重定向到应用内的其他路由，路径以 / 开头。

c.Redirect(302, "/internal/path")

2. 外部重定向（不同域名或外部地址）

重定向到其他域名或绝对 URL。

c.Redirect(301, "https://external-site.com")

三、常见 HTTP 状态码

• 301 Moved Permanently
  永久重定向，浏览器会缓存，后续直接访问新地址。
• 302 Found
  临时重定向，浏览器每次都会请求原地址再跳转。
• 307 Temporary Redirect
  临时重定向，且保持原请求方法（如 POST 请求不会被转为 GET）。

四、路由级别的重定向

在定义路由时直接指定重定向，无需处理函数。

示例：

r.GET("/old-about", gin.RedirectFixedPath("/about"))

访问 /old-about 会自动跳转到 /about。

五、常见应用场景

1. 表单提交后跳转
   防止用户重复提交（POST 请求后重定向到结果页）。

   r.POST("/submit", func(c *gin.Context) {
       // 处理表单数据...
       c.Redirect(302, "/success")
   })

2. 旧 URL 迁移
   将旧路径重定向到新路径，保持 SEO 友好。

   r.GET("/legacy-page", func(c *gin.Context) {
       c.Redirect(301, "/new-page")
   })

3. 用户认证
   未登录用户访问受限页面时重定向到登录页。

   func AuthMiddleware() gin.HandlerFunc {
       return func(c *gin.Context) {
           if !isLoggedIn(c) {
               c.Redirect(302, "/login")
               c.Abort() // 终止后续处理
           }
       }
   }

六、传递参数

通过 URL 参数或路径参数传递数据。

示例：

// 重定向时携带查询参数
c.Redirect(302, "/new?message=hello")

// 目标路由接收参数
r.GET("/new", func(c *gin.Context) {
    msg := c.Query("message") // "hello"
})

七、注意事项

1. 避免循环重定向
   确保重定向路径不会形成死循环（如 A → B → A）。
2. 状态码选择
   根据业务需求选择 301（永久）或 302/307（临时）。
3. POST 请求处理
   默认重定向会将 POST 转为 GET，需保留原方法时使用 307。

八、完整示例

package main

import "github.com/gin-gonic/gin"

func main() {
    r := gin.Default()

    // 重定向到外部地址
    r.GET("/google", func(c *gin.Context) {
        c.Redirect(302, "https://google.com")
    })

    // 路由级重定向
    r.GET("/old", gin.RedirectFixedPath("/new"))

    // 带参数重定向
    r.GET("/redirect-with-param", func(c *gin.Context) {
        c.Redirect(302, "/greet?name=Alice")
    })

    r.GET("/greet", func(c *gin.Context) {
        name := c.Query("name")
        c.String(200, "Hello, %s!", name)
    })

    r.Run(":8080")
}

通过灵活使用 Gin 的重定向功能，可以实现路由跳转、状态管理和用户引导等常见需求。