登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Go http.CrossOriginProtection.Check 怎样让自定义处理器判断请求是否应拒绝

来源:17golang原创

时间:2026-11-20 01:36:54 182浏览 收藏

如果你不想直接把整条路由交给默认保护中间件,而是要在自己的处理器里决定“这次请求返回 403,还是继续进入业务逻辑”,可以调用 http.CrossOriginProtection.Check。它返回的 error 就是拒绝信号:有错误时结束当前处理;没有错误时再交给下游 Handler。

官方文档:https://pkg.go.dev/net/http#CrossOriginProtection.Check

要点速览
  • Check 负责判断请求是否应被拒绝,不负责替你写 403 响应。
  • GET、HEAD、OPTIONS 是安全方法;跨源的状态变更请求才是重点保护对象。
  • 自定义包装器应判断 err != nil,不要依赖错误文本或把“没有错误”误解成业务操作已经安全。

先分清 Check 的判定输入

CrossOriginProtection 读取的是请求上下文,而不是业务表单字段。文档列出的判断信号包括请求方法、Sec-Fetch-Site,以及用于比较来源主机的 Origin 和 Host。安全方法 GET、HEAD、OPTIONS 会被放行;真正需要关注的是浏览器发起的跨源非安全请求。

这意味着 Check 不是“只要没有 Origin 就拒绝”的黑名单函数。当前文档把缺少 Sec-Fetch-Site 或 Origin 的请求按同源或非浏览器请求处理。服务端仍然要保证 GET 等安全方法不会执行状态变更,因为放行只代表跨源检查没有判定为拒绝。

http.Request 中请求方法、Sec-Fetch-Site、Origin 和 Host 与 CrossOriginProtection.Check 的静态关系说明图
图1:静态结构说明图,查看请求信号、CrossOriginProtection.Check 与 error 的关系;不是截图或运行证据。

把 error 当作拒绝信号

自定义处理时,最稳定的判断方式是检查返回值是否为 nil。不要比较错误字符串,也不要把 Check 的错误当成业务 Handler 的错误继续向下传递:它表示请求应该在跨源保护这一层结束。

package main

import (
    "net/http"
)

// withCrossOriginCheck 在业务处理器之前保留一个明确的拒绝分支。
func withCrossOriginCheck(next http.Handler) http.Handler {
    // 零值 CrossOriginProtection 可用;把实例放在包装器外,便于复用配置。
    protection := http.CrossOriginProtection{}

    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        // Check 返回非 nil error 时,说明这次请求应被保护层拒绝。
        if err := protection.Check(r); err != nil {
            // 自定义处理器决定响应格式;这里用标准 403 表示拒绝。
            http.Error(w, "cross-origin request rejected", http.StatusForbidden)
            return
        }

        // 没有跨源拒绝信号,才把请求交给业务处理器。
        next.ServeHTTP(w, r)
    })
}

示例把“判定”和“响应”分开:Check 只返回决定,HandlerFunc 选择 403 的正文和状态码。若项目已有统一 JSON 错误格式,可以把 http.Error 换成自己的响应函数,但仍要保留 return,避免拒绝后继续执行写操作。

把判定接进自定义 Handler

真正接入路由时,把包装器放在业务 Handler 外层即可。下面的写法保留了 http.Handler 的组合方式,同时让自定义层拥有记录日志、返回 JSON 或设置响应头的空间。

func protectedHandler(next http.Handler) http.Handler {
    // 创建一次保护对象,避免每个请求都重新组织处理逻辑。
    protection := http.NewCrossOriginProtection()

    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        // 这里只根据 error 判断保护结果,不猜测具体错误文本。
        if err := protection.Check(r); err != nil {
            // 记录必要的请求信息时,避免把 Cookie 或完整身份数据写入日志。
            http.Error(w, "forbidden", http.StatusForbidden)
            return
        }

        // 通过保护判定后,才允许业务 Handler 读取并处理请求。
        next.ServeHTTP(w, r)
    })
}

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("POST /profile", func(w http.ResponseWriter, r *http.Request) {
        // 该分支代表业务写操作,前面已经经过跨源判定。
        w.WriteHeader(http.StatusNoContent)
    })

    // 保护包装器只改变入口边界,不改变 mux 内部的路由注册。
    _ = http.ListenAndServe(":8080", protectedHandler(mux))
}

这里没有把 Check 当作完整的身份认证或授权系统。它解决的是跨源浏览器请求的保护边界;登录态、权限判断、幂等性和业务参数校验仍由应用自己的处理层负责。

自定义 http.Handler 调用 CrossOriginProtection.Check 后分出 403 Forbidden 与业务 Handler 的静态边界说明图
图2:自定义处理器边界说明图,查看 Check、403 响应和业务 Handler 的关系;不是截图或运行证据。

Check 和 Handler 怎么选

如果整棵路由树都需要同一种拒绝行为,直接使用 CrossOriginProtection.Handler 更省代码;如果只有部分入口需要特殊 JSON、审计字段或不同的错误页面,才适合在局部包装器里调用 Check。两者使用的是同一类保护判断,差别在于响应控制权的位置。

场景更合适的方式原因
整站统一拒绝protection.Handler(mux)保护边界集中,少写一层重复分支
部分接口需要 JSON 错误自定义 Handler 调 Check可以按路由或业务上下文决定响应格式
需要登录授权另加认证授权层跨源检查不等于身份与权限校验

常见问题

Check 返回 nil 是不是代表请求一定安全?

不是。它只表示 CrossOriginProtection 没有判定这次请求应被拒绝。认证、授权、参数校验和业务自身的状态变更约束仍要单独执行。

为什么不直接判断 Origin 字符串?

因为标准类型已经把请求方法、Fetch Metadata 和 Origin/Host 的关系纳入统一判断。直接手写字符串规则容易漏掉安全方法、缺失来源头和来源比较的边界。

自定义拒绝响应后还要 return 吗?

要。返回 403 后若继续调用下游 Handler,业务代码仍可能写响应或执行状态变更,导致保护分支失去意义。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>