答案:通过配置CORS响应头或使用中间件解决Golang Web服务跨域问题。具体包括设置Access-Control-Allow-Origin、Methods、Headers和Credentials,并处理OPTIONS预检请求,可借助gorilla/handlers库或手动实现中间件。

在使用 Golang 构建 Web 服务时,前端如果通过不同源(协议、域名、端口任一不同)访问后端接口,就会遇到跨域问题。浏览器出于安全考虑会阻止这类请求,除非后端正确配置 CORS(跨域资源共享)。解决这个问题的关键是在 HTTP 响应头中添加必要的 CORS 相关字段。
理解 CORS 核心响应头
要让浏览器接受跨域请求,服务器需设置以下几个关键响应头:
-
Access-Control-Allow-Origin:指定允许访问资源的源,例如 http://localhost:3000 或通配符 *(生产环境慎用)
-
Access-Control-Allow-Methods:声明允许的 HTTP 方法,如 GET、POST、PUT、DELETE 等
-
Access-Control-Allow-Headers:列出前端可以发送的自定义请求头,如 Content-Type、Authorization
-
Access-Control-Allow-Credentials:是否允许携带凭据(如 Cookie),设为 true 时 Origin 不能为 *
使用第三方库 gorilla/handlers 快速实现
最简单的方式是使用成熟的中间件库 github.com/gorilla/handlers,它提供了开箱即用的 CORS 支持。
安装依赖:
立即学习“go语言免费学习笔记(深入)”;
go get github.com/gorilla/handlers
示例代码:
package main
import (
"net/http"
"github.com/gorilla/mux"
"github.com/gorilla/handlers"
)
func main() {
r := mux.NewRouter()
r.HandleFunc("/api/data", func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
w.Write([]byte(`{"message": "Hello CORS"}`))
})
allowedOrigins := handlers.AllowedOrigins([]string{"http://localhost:3000"})
allowedMethods := handlers.AllowedMethods([]string{"GET", "POST", "PUT", "DELETE"})
allowedHeaders := handlers.AllowedHeaders([]string{"X-Requested-With", "Content-Type", "Authorization"})
http.ListenAndServe(":8080", handlers.CORS(allowedOrigins, allowedMethods, allowedHeaders)(r))
}
这段代码启用 CORS,并限制只允许来自 http://localhost:3000 的请求,支持常见方法和头部。
手动实现 CORS 中间件(无需外部依赖)
如果你不想引入额外依赖,也可以自己写一个简单的 CORS 中间件:
func corsMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Access-Control-Allow-Origin", "http://localhost:3000")
w.Header().Set("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS")
w.Header().Set("Access-Control-Allow-Headers", "Content-Type, Authorization")
if r.Method == "OPTIONS" {
w.WriteHeader(http.StatusOK)
return
}
next.ServeHTTP(w, r)
})
}
使用方式:
r := mux.NewRouter()
r.Use(corsMiddleware)
r.HandleFunc("/api/data", yourHandler)
注意:预检请求(OPTIONS)由中间件直接处理,避免转发到实际业务逻辑。
处理凭证与精确源匹配
如果前端需要携带 Cookie 或使用 withCredentials: true,后端必须明确设置凭据支持且不能使用通配符。
正确做法:
w.Header().Set("Access-Control-Allow-Origin", "http://localhost:3000")
w.Header().Set("Access-Control-Allow-Credentials", "true")
此时 Origin 必须是具体地址,不能为 *,否则浏览器会拒绝响应。
基本上就这些。根据项目情况选择使用库或手写中间件,关键是把响应头写对,并妥善处理 OPTIONS 预检请求。
以上就是Golang如何实现跨域资源共享CORS的详细内容,更多请关注php中文网其它相关文章!