如何让 Golang 中的 Gorilla CORS 中间件正确工作

如何让 Golang 中的 Gorilla CORS 中间件正确工作

在构建 RESTful API 时，**跨域资源共享（CORS）**是一个常见问题。前端请求后端接口时，若两者的域名、端口不同，浏览器就会触发跨域校验。若服务端未配置 CORS 策略，则浏览器会阻止请求。

Golang 中使用 gorilla/mux 路由器配合 rs/cors 中间件库可以优雅地解决这个问题。然而，很多人刚开始使用时会遇到配置不生效的问题，本文将详细介绍其正确用法。

---

一、基础依赖

确保安装以下依赖：

go get -u github.com/gorilla/mux
go get -u github.com/rs/cors

---

二、错误用法（很多人一开始都会这样写）

package main

import (
	"fmt"
	"net/http"
	"github.com/gorilla/mux"
	"github.com/rs/cors"
)

func main() {
	router := mux.NewRouter()

	router.HandleFunc("/api", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintln(w, "Hello, CORS!")
	}).Methods("GET")

	// ❌ 错误：中间件未被真正使用
	c := cors.New(cors.Options{
		AllowedOrigins: []string{"*"},
	})
	
	http.ListenAndServe(":8080", router) // 忽略了 cors.Handler
}

虽然写了 cors.New(...)，但实际上并没有将其作用于 HTTP 服务器上。这相当于创建了一个 CORS 配置但未使用。

---

三、正确用法

你需要将 cors.Handler 包装你的主路由器：

func main() {
	router := mux.NewRouter()

	router.HandleFunc("/api", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintln(w, "Hello, CORS!")
	}).Methods("GET")

	// ✅ 正确：将 CORS 中间件包裹 router
	c := cors.New(cors.Options{
		AllowedOrigins:   []string{"*"},
		AllowedMethods:   []string{"GET", "POST", "PUT", "DELETE"},
		AllowedHeaders:   []string{"Content-Type"},
		AllowCredentials: true,
	})

	handler := c.Handler(router)

	http.ListenAndServe(":8080", handler)
}

---

四、如何验证是否生效

你可以通过以下方式测试：

1. 用浏览器或 Postman 发起请求。
2. 检查返回的响应头中是否有：

Access-Control-Allow-Origin: *

这说明服务端已允许跨域请求。

---

五、常见配置项说明

配置项	说明
AllowedOrigins	允许的来源，例如：[]string{"http://localhost:3000"} 或 * 表示所有
AllowedMethods	支持的方法，如 GET, POST, OPTIONS 等
AllowedHeaders	允许的请求头，如 Content-Type, Authorization
AllowCredentials	是否允许携带 cookie

---

六、OPTIONS 请求的问题

浏览器在发出跨域请求之前，通常会发出一个 OPTIONS 请求（预检）。务必确保你的路由器或中间件没有拦截 OPTIONS 请求。

示例：

router.Methods("OPTIONS").HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
	w.WriteHeader(http.StatusOK)
})

不过大多数时候 rs/cors 会自动处理 OPTIONS 请求，你无需手动添加。

---

七、小贴士

• 开发阶段可以设置 AllowedOrigins: []string{"*"}，但生产环境下应限制为指定域名。
• 确保中间件被正确包裹 router，否则它根本不会生效。
• 如果你还有认证逻辑，确保 cors 中间件放在最外层。

---

总结

在 Golang 项目中正确配置 CORS 是 API 可用性的基本要求之一。通过 gorilla/mux 搭配 rs/cors，你可以快速实现跨域支持。记住，最常见的错误就是：创建了中间件但没有包裹 router。只要绕开这个坑，你的跨域请求将顺利进行。

原文链接：https://duoke360.com/post/44220