在 Gin 框架中，跨域（CORS，Cross-Origin Resource Sharing）是一个常见的需求。跨域问题通常会在浏览器中阻止从一个域名或端口发出的请求访问另一个域名或端口的资源。为了解决这个问题，可以使用跨域资源共享（CORS）标准，允许服务器指定哪些域可以访问其资源。
CORS 是一种通过 HTTP 头部字段来解决跨域问题的机制。服务器通过设置响应头 Access-Control-Allow-Origin，告诉浏览器是否允许跨域请求。
常见的 CORS 相关响应头包括：
Life is like a journey
Access-Control-Allow-Origin: 指定哪些来源的请求可以访问资源。可以是具体的域名（如 http://example.com），也可以是 *（表示所有域名都可以访问）。Access-Control-Allow-Methods: 指定允许的 HTTP 方法，例如 GET, POST, PUT, DELETE。Access-Control-Allow-Headers: 指定哪些请求头可以在实际请求中使用。Access-Control-Allow-Credentials: 是否允许发送凭据（如 Cookies 或 HTTP 认证信息）。默认是 false，如果是 true，则必须与具体的域配合使用。Gin 本身并没有内置 CORS 中间件，但你可以很容易地实现一个跨域中间件。也可以使用现有的第三方库 github.com/gin-contrib/cors 来快速实现 CORS。
首先来看一个简单的自定义 CORS 中间件的实现：
package main
import (
"github.com/gin-gonic/gin"
"net/http"
)
// CORS 中间件
func CORSMiddleware() gin.HandlerFunc {
return func(c *gin.Context) {
// 设置 CORS 响应头
c.Header("Access-Control-Allow-Origin", "*") // 允许所有域访问
c.Header("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS") // 允许的请求方法
c.Header("Access-Control-Allow-Headers", "Origin, Content-Type, Accept, Authorization") // 允许的请求头
c.Header("Access-Control-Allow-Credentials", "true") // 是否允许发送凭据
// 如果是预检请求（OPTIONS 方法），直接返回 200
if c.Request.Method == http.MethodOptions {
c.AbortWithStatus(http.StatusOK)
return
}
// 处理请求
c.Next()
}
}
func main() {
r := gin.Default()
// 使用 CORS 中间件
r.Use(CORSMiddleware())
// 示例路由
r.GET("/ping", func(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{"message": "pong"})
})
r.Run(":8080")
}
Access-Control-Allow-Origin: 设置允许哪些域进行访问，这里用 * 表示允许所有域。Access-Control-Allow-Methods: 设置允许的 HTTP 方法。Access-Control-Allow-Headers: 设置允许的请求头部信息，客户端发送请求时会携带这些头部。Access-Control-Allow-Credentials: 设置是否允许携带凭证（例如 Cookies）。在本示例中设置为 true。200 OK，这样浏览器就知道可以发起实际的请求了。c.Next() 来继续处理后续的请求。r.Use(CORSMiddleware())，我们将 CORS 中间件应用到所有请求路径。gin-contrib/cors 中间件Gin 提供了一个非常方便的 CORS 中间件库 gin-contrib/cors，它封装了 CORS 的常见操作，使得我们可以通过简单的配置实现跨域功能。
gin-contrib/cors：go get -u github.com/gin-contrib/cors
gin-contrib/cors 实现 CORS 中间件：package main
import (
"github.com/gin-gonic/gin"
"github.com/gin-contrib/cors"
"net/http"
)
func main() {
r := gin.Default()
// 配置 CORS 中间件
r.Use(cors.New(cors.Config{
AllowOrigins: []string{"http://localhost:3000"}, // 允许的跨域来源，可以是单个或多个域
AllowMethods: []string{"GET", "POST", "PUT", "DELETE", "OPTIONS"}, // 允许的方法
AllowHeaders: []string{"Origin", "Content-Type", "Accept", "Authorization"}, // 允许的请求头
AllowCredentials: true, // 是否允许携带凭证
ExposeHeaders: []string{"Content-Length", "Authorization"}, // 可公开的响应头
MaxAge: 12 * time.Hour, // 预检请求缓存的最大时长
}))
// 示例路由
r.GET("/ping", func(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{"message": "pong"})
})
r.Run(":8080")
}
AllowOrigins: 设置允许的域名，可以指定多个域名。AllowMethods: 设置允许的请求方法。AllowHeaders: 设置允许的请求头部信息。AllowCredentials: 是否允许客户端发送凭据（如 Cookies）。ExposeHeaders: 设置哪些响应头可以暴露给客户端。MaxAge: 预检请求的缓存时间，单位是秒，表示浏览器在这个时间内可以复用同一个预检请求。通过 Gin 框架的中间件功能，可以非常方便地实现 CORS 支持，确保不同域之间可以安全地进行资源共享。你可以选择手动实现 CORS 中间件，或者使用现成的 gin-contrib/cors 中间件库来快速配置跨域支持。
gin-contrib/cors：适合标准的跨域需求，提供了丰富的配置选项，便于快速开发。无论哪种方式，跨域中间件都是确保前后端分离应用能够正常工作的重要工具。