Golang跨域处理技巧与CORS设置方法

怎么入门Golang编程？需要学习哪些知识点？这是新手们刚接触编程时常见的问题；下面golang学习网就来给大家整理分享一些知识点，希望能够给初学者一些帮助。本篇文章就来介绍《Golang跨域处理技巧\_CORS设置方法》，涉及到，有需要的可以收藏一下

CORS是解决浏览器跨域请求的机制，通过配置Access-Control-Allow-Origin等响应头允许指定源访问资源；在Golang中可通过手动设置响应头、编写中间件或使用gorilla/handlers.CORS库实现，推荐中大型项目使用中间件或第三方库统一管理以支持预检请求和凭据传递。

在使用 Golang 构建后端服务时，前端通过浏览器发起请求经常会遇到跨域问题。这是由于浏览器的同源策略限制，不允许从一个源加载的网页向另一个不同源的服务器发起请求。为了解决这个问题，需要在 Go 服务中正确配置 CORS（跨源资源共享）策略。

什么是 CORS

CORS 是一种基于 HTTP 头部的机制，允许服务器声明哪些源可以访问其资源。当浏览器检测到跨域请求时，会先发送一个预检请求（OPTIONS 方法），确认服务器是否接受该请求。服务器需返回正确的响应头来授权访问。

手动设置 CORS 响应头

最直接的方式是在处理函数中添加必要的响应头：

示例代码：

func handler(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Access-Control-Allow-Origin", "https://example.com")
    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
    }

    // 正常处理逻辑
    w.Write([]byte("Hello World"))
}

使用中间件统一处理 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", "https://example.com")
        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)
    })
}

// 使用方式
http.Handle("/api/", corsMiddleware(http.StripPrefix("/api", apiRouter)))

使用第三方库简化配置

Gorilla 的 handlers.CORS 是一个常用的解决方案，功能完整且易于配置：

安装：

go get github.com/gorilla/handlers

使用示例：

import "github.com/gorilla/handlers"

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/data", yourHandler)

    corsHandler := handlers.CORS(
        handlers.AllowedOrigins([]string{"https://example.com"}),
        handlers.AllowedMethods([]string{"GET", "POST", "PUT", "DELETE", "OPTIONS"}),
        handlers.AllowedHeaders([]string{"Content-Type", "Authorization"}),
        handlers.AllowCredentials(),
    )

    log.Fatal(http.ListenAndServe(":8080", corsHandler(mux)))
}

这个库支持细粒度控制，比如只对某些路径启用 CORS，或动态判断 origin 是否合法。

基本上就这些。根据项目规模选择合适的方式：小项目可手动加头，中大型应用建议用中间件或成熟库统一管理。关键是理解 OPTIONS 预检和响应头的作用，避免因配置不当导致请求被拦截。

到这里，我们也就讲完了《Golang跨域处理技巧与CORS设置方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于golang,中间件,跨域请求,cors,HTTP响应头的知识点！