首页 > 后端开发 > Golang > 正文

Golang处理跨域请求怎么做 配置CORS中间件方案

P粉602998670
发布: 2025-08-16 09:49:01
原创
911人浏览过

使用 rs/cors 中间件是解决 golang 后端跨域问题的推荐方案,通过配置 allowedorigins、allowedmethods 等参数可精准控制 cors 策略,支持 net/http 和 gin 框架,能自动处理预检请求且避免手动设置头部的遗漏风险,生产环境应避免通配符并明确指定可信域名,最终实现安全高效的跨域通信。

Golang处理跨域请求怎么做 配置CORS中间件方案

在使用 Golang 构建后端服务时,尤其是配合前端框架(如 Vue、React)开发时,经常会遇到跨域请求(CORS)问题。浏览器出于安全考虑,会阻止跨域的 AJAX 请求,因此需要在服务端配置 CORS 策略来允许特定或全部来源的请求。

最常见且推荐的做法是使用成熟的第三方中间件

github.com/rs/cors
登录后复制
来处理跨域问题。下面详细介绍如何配置。


使用
rs/cors
登录后复制
中间件配置 CORS

rs/cors
登录后复制
是一个轻量、功能完整的 CORS 中间件,适用于
net/http
登录后复制
gorilla/mux
登录后复制
gin
登录后复制
等主流 Go Web 框架。

立即学习go语言免费学习笔记(深入)”;

1. 安装依赖

go get github.com/rs/cors
登录后复制

2. 在
net/http
登录后复制
中使用

如果你使用的是标准库

net/http
登录后复制
,可以这样配置:

package main

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

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/api/hello", func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Content-Type", "application/json")
        w.Write([]byte(`{"message": "Hello CORS!"}`))
    })

    // 配置 CORS 中间件
    c := cors.New(cors.Options{
        AllowedOrigins:   []string{"http://localhost:3000", "https://your-frontend.com"}, // 允许的前端域名
        AllowedMethods:   []string{"GET", "POST", "PUT", "DELETE", "OPTIONS"},
        AllowedHeaders:   []string{"*"}, // 允许所有头部,也可以指定如 "Content-Type", "Authorization"
        ExposedHeaders:   []string{"Content-Length"},
        AllowCredentials: true, // 允许携带凭证(如 cookies)
        MaxAge:           3600, // 预检请求缓存时间(秒)
    })

    // 将 CORS 中间件包装在 handler 外层
    handler := c.Handler(mux)
    http.ListenAndServe(":8080", handler)
}
登录后复制

3. 在 Gin 框架中使用

如果你使用的是 Gin 框架,也可以使用

rs/cors
登录后复制
,但更常见的是使用 Gin 自带的 CORS 中间件,或者继续用
rs/cors
登录后复制

千图设计室AI海报
千图设计室AI海报

千图网旗下的智能海报在线设计平台

千图设计室AI海报 172
查看详情 千图设计室AI海报

方法一:使用

rs/cors
登录后复制
包装 Gin Engine

package main

import (
    "github.com/gin-gonic/gin"
    "github.com/rs/cors"
    "net/http"
)

func main() {
    r := gin.Default()

    r.GET("/api/hello", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{
            "message": "Hello from Gin with CORS",
        })
    })

    // 使用 rs/cors 包装
    corsMiddleware := cors.New(cors.Options{
        AllowedOrigins: []string{"http://localhost:3000"},
        AllowedMethods: []string{"GET", "POST", "PUT", "DELETE", "OPTIONS"},
        AllowedHeaders: []string{"*"},
        AllowCredentials: true,
    })

    handler := corsMiddleware.Handler(r)
    http.ListenAndServe(":8080", handler)
}
登录后复制

方法二:使用 Gin 内置方式(不推荐用于复杂场景)

r.Use(func(c *gin.Context) {
    c.Header("Access-Control-Allow-Origin", "http://localhost:3000")
    c.Header("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS")
    c.Header("Access-Control-Allow-Headers", "Content-Type, Authorization")

    if c.Request.Method == "OPTIONS" {
        c.AbortWithStatus(204)
        return
    }
    c.Next()
})
登录后复制
注意:手动设置 Header 的方式容易遗漏细节(如凭证、预检处理),建议优先使用中间件。

CORS 配置参数说明

参数 说明
@@######@@ 允许访问的前端域名列表,生产环境避免使用 @@######@@
@@######@@ 允许的 HTTP 方法
@@######@@ 允许的请求头,设为 @@######@@ 表示允许所有
@@######@@ 是否允许携带 Cookie 或认证信息,设为 @@######@@ 时 @@######@@ 不能为 @@######@@
@@######@@ 客户端可读取的响应头
@@######@@ 预检请求(OPTIONS)的缓存时间,减少重复请求

常见问题与注意事项

  • *

    AllowedOrigins
    登录后复制
    不能为 `
    *
    登录后复制
    withCredentials: true
    AllowedMethods
    登录后复制
    AllowCredentials: true
    AllowedHeaders
    登录后复制
    AllowedOrigins
    []string{"*"}
    登录后复制
    *`。

  • 预检请求(OPTIONS)自动处理

    AllowCredentials
    登录后复制
    会自动拦截并响应 OPTIONS 请求,无需手动处理。

  • 生产环境避免开放所有来源
    不要使用

    true
    登录后复制
    ,应明确指定可信的前端域名。

  • 路径级别控制(高级)

    AllowedOrigins
    登录后复制
    支持通过
    *
    登录后复制
    实现动态来源判断:

    ExposedHeaders
    登录后复制

基本上就这些。用

MaxAge
登录后复制
是最简单、最安全的方案,几行代码就能解决绝大多数跨域问题。

Access-Control-Allow-Origin
登录后复制
同时携带凭证** 如果前端发送了
登录后复制
,服务端
登录后复制
,那么
登录后复制
必须是具体域名,不能是
登录后复制
rs/cors
登录后复制
AllowedOrigins: []string{"*"}
登录后复制
rs/cors
登录后复制
AllowOriginFunc
登录后复制
AllowOriginFunc: func(r *http.Request, origin string) bool {
    return origin == "http://localhost:3000"
},
登录后复制
rs/cors
登录后复制

以上就是Golang处理跨域请求怎么做 配置CORS中间件方案的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号