最佳实践:在 golang 中实现 cors(跨域资源共享):使用社区提供的库简化处理,如 github.com/rs/cors。配置 allowedorigins 以控制访问来源。设置 allowedmethods 限制请求类型。启用 cookie 共享,使用 allowcredentials 选项。设置 maxage 缓存预检请求,提高性能。使用 allowedheaders 和 exposedheaders 指定需要公开的头。
跨域资源共享在 Golang 框架中的最佳实践
跨域资源共享 (CORS) 介绍
跨域资源共享 (CORS) 是一种机制,用于允许不同源的客户端访问服务器资源。它通过在服务器响应中添加额外的 HTTP 头来实现,这些头描述了哪些源可以访问该资源以及允许的请求类型。
Golang 框架中的 CORS 实现
Golang 社区提供了一些库来简化 CORS 处理:
- github.com/rs/cors: 一个流行且功能齐全的 CORS 库,提供了对配置选项的细 granularity 控制。
- github.com/gorilla/handlers: 一个轻量级库,提供了一个中间件函数,可以在路由器上使用。
- github.com/go-chi/cors: 用于 chi 路由器的一个包,提供了一个中间件函数,具有简单的配置选项。
实战案例
考虑一个使用 Gin 框架的 Golang API,我们想启用 CORS。我们可以使用 github.com/rs/cors 库如下:
立即学习“go语言免费学习笔记(深入)”;
import (
"github.com/gin-gonic/gin"
"github.com/rs/cors"
)
func main() {
// 创建一个 Gin 路由器
r := gin.Default()
// 添加 CORS 中间件
r.Use(cors.New(cors.Options{
AllowedOrigins: []string{"*"},
AllowedMethods: []string{"GET", "POST", "PUT", "DELETE"},
AllowedHeaders: []string{"Content-Type", "Authorization"},
ExposedHeaders: []string{"Content-Length"},
AllowCredentials: true,
MaxAge: 3600, // 1 小时
}))
// 定义 API 路由
r.GET("/api/v1/users", func(c *gin.Context) {})
// 启动服务器
r.Run()
}
此配置允许来自任何来源的 GET、POST、PUT 和 DELETE 请求,并允许携带 Cookie。
其他建议
- 使用 AllowCredentials 选项启用 Cookie 共享,当服务器响应中设置了 Access-Control-Allow-Credentials: true 头时,浏览器允许跨域请求中发送凭据。
- 设置合适的 MaxAge 以缓存 CORS 预检请求。这是可选的,但可以提高性能。
- 使用适当的 AllowedOrigins 列表进行访问控制。如果可能,尽量限制为特定的来源。
- 使用 AllowedHeaders 和 ExposedHeaders 选项指定哪些头需要向客户端公开。