Go项目搞定CORS跨域，超简单教程来了！

还在为Go项目的CORS跨域问题头疼？别担心，本文为你提供超简单的解决方案！CORS跨域是Web开发中常见的难题，尤其是在前后端分离的项目中。本文将深入浅出地讲解如何在Go项目中配置CORS，让你的API能够安全地被允许的域访问。文章将介绍通过中间件统一处理CORS、针对特定路由单独配置、以及使用第三方库`github.com/rs/cors`简化配置等多种方法。重点讲解如何处理OPTIONS预检请求、设置Access-Control-Allow-Credentials以支持cookie跨域，以及为什么在生产环境应避免使用“*”作为允许的源。掌握这些技巧，轻松解决Go项目中的CORS跨域问题，提升项目安全性！

解决Go项目中CORS跨域问题的方法是配置正确的CORS头部信息，允许特定域访问API。1. 使用中间件统一处理CORS，通过设置Access-Control-Allow-Origin、Access-Control-Allow-Methods和Access-Control-Allow-Headers头部实现集中管理；2. 针对特定路由单独配置CORS规则；3. 使用第三方库如github.com/rs/cors简化配置；4. 处理OPTIONS预检请求并返回200 OK状态码；5. 若需携带cookie，设置Access-Control-Allow-Credentials为true且不允许使用通配符域名。生产环境应避免使用“*”作为允许的源，以提升安全性。

解决Go项目中CORS跨域问题，核心在于配置正确的CORS头部信息，允许来自特定域的请求访问你的API。这通常涉及到在你的Go HTTP处理程序中添加适当的Access-Control-Allow-Origin、Access-Control-Allow-Methods和Access-Control-Allow-Headers头部。

解决方案：

1. 使用中间件处理CORS： 创建一个CORS中间件，它可以拦截所有请求，并根据预定义的规则设置CORS头部。这是一种集中管理CORS配置的好方法，避免在每个处理程序中重复编写相同的代码。

   

   package main
   
   import (
       "log"
       "net/http"
   )
   
   func corsMiddleware(next http.Handler) http.Handler {
       return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
           w.Header().Set("Access-Control-Allow-Origin", "*") // 生产环境不要用*
           w.Header().Set("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
           w.Header().Set("Access-Control-Allow-Headers", "Content-Type, Authorization")
   
           if r.Method == "OPTIONS" {
               w.WriteHeader(http.StatusOK)
               return
           }
   
           next.ServeHTTP(w, r)
       })
   }
   
   func mainHandler(w http.ResponseWriter, r *http.Request) {
       w.Write([]byte("Hello, CORS!"))
   }
   
   func main() {
       mux := http.NewServeMux()
       mux.HandleFunc("/", mainHandler)
   
       handler := corsMiddleware(mux)
   
       log.Fatal(http.ListenAndServe(":8080", handler))
   }

   • Access-Control-Allow-Origin: 指定允许访问资源的域。在开发环境中，可以使用*允许所有域，但在生产环境中，务必设置为你的前端应用的域名，多个域名可以用逗号分隔，但更好的方式是检查Origin请求头并动态设置。
   • Access-Control-Allow-Methods: 指定允许的HTTP方法。
   • Access-Control-Allow-Headers: 指定允许客户端在请求中使用的头部。
   • OPTIONS请求处理：CORS预检请求使用OPTIONS方法。中间件需要处理这些请求，并返回200 OK状态码。

2. 针对特定路由配置CORS： 如果只需要对部分路由启用CORS，可以在这些路由的处理程序中单独设置CORS头部。

   func specificRouteHandler(w http.ResponseWriter, r *http.Request) {
       w.Header().Set("Access-Control-Allow-Origin", "http://example.com")
       w.Header().Set("Access-Control-Allow-Methods", "GET")
       w.Header().Set("Content-Type", "application/json")
       w.Write([]byte(`{"message": "Specific route with CORS"}`))
   }

3. 使用第三方库： 可以使用现有的CORS库，例如github.com/rs/cors，它可以简化CORS配置。

   package main
   
   import (
       "log"
       "net/http"
   
       "github.com/rs/cors"
   )
   
   func mainHandler(w http.ResponseWriter, r *http.Request) {
       w.Write([]byte("Hello, CORS!"))
   }
   
   func main() {
       mux := http.NewServeMux()
       mux.HandleFunc("/", mainHandler)
   
       c := cors.New(cors.Options{
           AllowedOrigins:   []string{"http://localhost:3000", "http://example.com"}, // 允许的域
           AllowedMethods:   []string{"GET", "POST", "OPTIONS"},                     // 允许的方法
           AllowedHeaders:   []string{"Content-Type", "Authorization"},               // 允许的头部
           AllowCredentials: true,                                                    // 是否允许发送cookie
           Debug:            true,                                                    // 调试模式
       })
   
       handler := c.Handler(mux)
   
       log.Fatal(http.ListenAndServe(":8080", handler))
   }

   这个库提供了更灵活的配置选项，例如允许携带凭据（cookie）等。

为什么在生产环境要避免使用*作为Access-Control-Allow-Origin的值？

使用*允许任何域访问你的API，这会带来安全风险。恶意网站可以模拟你的前端应用，向你的API发送请求，窃取用户数据或执行其他恶意操作。在生产环境中，应该明确指定允许访问的域名，以提高安全性。

如何处理预检请求（OPTIONS请求）？

CORS预检请求是浏览器在发送跨域请求之前，先发送一个OPTIONS请求到服务器，询问服务器是否允许该跨域请求。服务器需要在OPTIONS请求的响应中设置CORS头部，告诉浏览器允许哪些域、方法和头部。如果服务器没有正确处理OPTIONS请求，浏览器会阻止跨域请求的发送。

例如，如果你使用了中间件，确保中间件会拦截OPTIONS请求并设置正确的CORS头部。如果没有使用中间件，需要在每个处理程序中手动处理OPTIONS请求。

如何处理带有凭据（cookie）的跨域请求？

如果你的跨域请求需要携带cookie，需要在服务器端设置Access-Control-Allow-Credentials头部为true，并且在客户端的XMLHttpRequest对象中设置withCredentials属性为true。同时，Access-Control-Allow-Origin的值不能是*，必须明确指定允许访问的域名。

例如：

服务器端：

w.Header().Set("Access-Control-Allow-Origin", "http://example.com")
w.Header().Set("Access-Control-Allow-Credentials", "true")

客户端：

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.open('GET', 'http://api.example.com/data');
xhr.send();

注意，如果服务器端没有设置Access-Control-Allow-Credentials为true，即使客户端设置了withCredentials，浏览器也会阻止跨域请求的发送。

到这里，我们也就讲完了《Go项目搞定CORS跨域，超简单教程来了！》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于Go,中间件,cors,跨域,Access-Control-Allow-Origin的知识点！