你真的了解跨域吗?如何解决?为 Go 程序员准备的跨域教程

本文作者: guyan0319

原文链接: https://segmentfault.com/a/1190000020869645

跨域指的是浏览器不能执行其他网站或域名下的脚本。之所以形成跨域,是因为浏览器的 同源策略 [1] 造成的,是浏览器对 javascript 程序做的安全限制,现在所有支持 JavaScript [2] 的浏览器都会使用这个策略。

在实际应用中会遇到需要跨域的场景,比如前后端分离,前后端不在同域(这里的同域指的是同一协议,同一域名,同一端口),那么,它们之间相互通信如何解决呢?

跨域解决有以下几种方法:

jsonp 解决跨域

这里 jsonp [3] 跨域其实是利用 iframe、img、srcipt,link 标签的 src 或 href 属性来实现的,这些标签都可以发送一个 get 请求资源,src 和 href 并没有受同源策略的限制。

这里我们拿懒人教程示例

JSONP 实例

$.getJSON("https://www.runoob.com/try/ajax/jsonp.php?jsoncallback=?", function(data) {

var html = '<ul>';
for(var i = 0; i &lt; data.length; i++)
{
    html += '<li>' + data[i] + '</li>';
}
html += '</ul>';

$('#divCustomers').html(html);

});

jsonp 主要站在前端的角度去解决问题,这种方式有一定的局限性,就是仅适用 get 请求。

nginx 代理解决跨域

1、nginx 配置解决 iconfont 跨域

众所周知 js、css、img 等常用资源不受浏览器同源策略限制,但一些特殊资源如 iconfont 字体文件(eot|otf|ttf|woff|svg)除外,这里通过修改 nginx 配置就可以解决。

location / {
  add_header Access-Control-Allow-Origin *;
}

2、nginx 反向代理

同源策略是浏览器的安全策略,不属于 http 协议一部分,限制的是 js 脚本。而服务器端调用的 http 接口,不受同源策略限制,也不存在跨域问题。

实现思路:nginx 服务器作为中间代理(或跳转机),实现从域名 A 访问域名 B,像访问同域一样。

示例

server {
     listen80;
     server_name http://domain1;

     location / {
         proxy_pass http://domain2:8081/;
         proxy_set_header Host $host;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_set_header X-Forwarded-Proto $scheme;
         proxy_set_header X-Forwarded-Port $server_port;
      }
}

nodejs 代理解决跨越

nodejs 实现原理和 nginx 基本类似。

修改 app.js

var express = require('express');
const proxy = require('http-proxy-middleware');
const app = express();
app.set('port', '809');

app.all('*', function (req, res, next) {    // 解决跨域问题
    res.header("Access-Control-Allow-Origin", "*");
    res.header("Access-Control-Allow-Headers", "Content-Type,Content-Length, Authorization, Accept,X-Requested-With");
    res.header("Access-Control-Allow-Methods", "PUT,POST,GET,DELETE,OPTIONS");
    if (req.method == "OPTIONS") {
        res.send(200);
    } else {
        next();
    }
});

var options = {
        target: 'http://localhost:8090',
        changeOrigin: true,
    };
var exampleProxy = proxy(options);
app.use('/', exampleProxy);
app.listen(app.get('port'), () => {
 console.log(`server running @${app.get('port')}`);
});

如是 vue+nodejs 环境

通过只修改 vue.config.js,不用修改 nodejs 也可以实现代理跨域。

devServer: {host: '0.0.0.0',port: 8080,disableHostCheck: true,proxy: {'/*': {target: 'https://www.runoob.com',secure: false,changeOrigin: true}}}

cors

跨域资源共享( CORS [4] ) 是一种机制,它使用额外的 HTTP [5] 头来告诉浏览器 让运行在一个 origin (domain) 上的 Web 应用被准许访问来自不同源服务器上的指定的资源。当一个资源从与该资源本身所在的服务器 不同的域、协议或端口 请求一个资源时,资源会发起一个 跨域 HTTP 请求

比如,站点 http://domain-a.com [6] 的某 HTML 页面通过 的 src [7] 请求 http://domain-b.com/image.jpg [8] 。网络上的许多页面都会加载来自不同域的 CSS 样式表,图像和脚本等资源。

出于安全原因,浏览器限制从脚本内发起的跨源 HTTP 请求。例如,XMLHttpRequest 和 Fetch API 遵循同源策略。这意味着使用这些 API 的 Web 应用程序只能从加载应用程序的同一个域请求 HTTP 资源,除非响应报文包含了正确 CORS 响应头。

前面扯了很多方法,其实归根结底是围绕 cors 机制来实现(除了 nginx 反向代理)的,具体就是服务端发送 `Access-Control-Allow-Origin` [9] 以及相关响应头,来通知浏览器有权访问资源。

前面讲了 nodejs 或 nginx 服务器端通过设置 `Access-Control-Allow-Origin` [10] ,可以实现跨域,这里讲一下 golang 实现方式,当然 php、java 等也可以实现、原理相同。

示例 1

package main

import (
    "net/http"
)

funccors(f http.HandlerFunc)http.HandlerFunc {
    returnfunc(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Access-Control-Allow-Origin", "*")  // 允许访问所有域,可以换成具体url,注意仅具体url才能带cookie信息
        w.Header().Add("Access-Control-Allow-Headers", "Content-Type,AccessToken,X-CSRF-Token, Authorization, Token") //header的类型
        w.Header().Add("Access-Control-Allow-Credentials", "true") //设置为true,允许ajax异步请求带cookie信息
        w.Header().Add("Access-Control-Allow-Methods", "POST, GET, OPTIONS, PUT, DELETE") //允许请求方法
        w.Header().Set("content-type", "application/json;charset=UTF-8")             //返回数据格式是jsonif r.Method == "OPTIONS" {
            w.WriteHeader(http.StatusNoContent)
            return
        }
        f(w, r)
    }
}
funcindex(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("Hello Golang"))
}
funcmain() {
    http.HandleFunc("/", cors(index))
    http.ListenAndServe(":8000", nil)
}

示例 2

gin 框架跨域中间件

package main

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


funcmain() {
    r := gin.Default()
    r.Use(Cors())//默认跨域
    r.GET("/", func(c *gin.Context) {
        c.JSON(200, gin.H{
            "message": "pong",
        })
    })
    r.Run(":8090")
}
funcCors() gin.HandlerFunc {

    returnfunc(c *gin.Context) {
        method := c.Request.Method
        origin := c.Request.Header.Get("Origin")
        if origin != "" {
            c.Header("Access-Control-Allow-Origin", "*")
            c.Header("Access-Control-Allow-Methods", "POST, GET, OPTIONS, PUT, DELETE")
            c.Header("Access-Control-Allow-Headers", "Content-Type,AccessToken,X-CSRF-Token, Authorization")
            c.Header("Access-Control-Allow-Credentials", "true")
            c.Set("content-type", "application/json")
        }
        //放行所有OPTIONS方法if method == "OPTIONS" {
            c.AbortWithStatus(http.StatusNoContent)
        }
        c.Next()
    }
}

gin 有个官方的跨域中间件

https://github.com/gin-contri… [11]

注意 :

某些简单请求不会触发 CORS 预检请求 [12]

`Content-Type` [13] 的值仅限于下列三者之一:

  • text/plain

  • multipart/form-data

  • application/x-www-form-urlencoded 默认

现在应用中越来越多前端和服务端都采用 json 通讯,如 vue 等。

要求前端 `Content-Type` [14] 设置为 application/json,且是 post 请求,这属于复杂请求,将触发 CORS 预检请求 [15] 。即浏览器会先发送一次 options 请求,同意后才继续发送 post 请求。

当发送这种请求时,在浏览器的 network 会发现两条请求。同时在服务端接收前端参数时需要注意,以前通过 get 、post 方法会失效。

具体接收参数方法,php 语言为 file_get_contents(‘php://input’) 。

golang 语言

net/http

package main

import (
    "encoding/json""fmt""io/ioutil""net/http"
)

funccors(f http.HandlerFunc)http.HandlerFunc {
    returnfunc(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Access-Control-Allow-Origin", "*")  // 允许访问所有域,可以换成具体url,注意仅具体url才能带cookie信息
        w.Header().Add("Access-Control-Allow-Headers", "Content-Type,AccessToken,X-CSRF-Token, Authorization, Token") //header的类型
        w.Header().Add("Access-Control-Allow-Credentials", "true") //设置为true,允许ajax异步请求带cookie信息
        w.Header().Add("Access-Control-Allow-Methods", "POST, GET, OPTIONS, PUT, DELETE") //允许请求方法
        w.Header().Set("content-type", "application/json;charset=UTF-8")             //返回数据格式是jsonif r.Method == "OPTIONS" {
            w.WriteHeader(http.StatusNoContent)
            return
        }
        f(w, r)
    }
}
type User struct {
    Username string`json:"username"`
    Password  string`json:"password"`
}

funcindex(w http.ResponseWriter, r *http.Request) {
    body, _ := ioutil.ReadAll(r.Body)
    fmt.Println(string(body))
    var user User
    if err := json.Unmarshal(body, &user); err == nil {
        fmt.Println(user)
    } else {
        fmt.Println(err)
    }
    w.Write([]byte("Hello Golang"))
}
funcmain() {
    http.HandleFunc("/", cors(index))
    http.ListenAndServe(":8000", nil)
}

gin 框架

对于 gin 框架我们就需要 bind 来解决这个问题

示例

type Userstruct{
    Username string `form:"username" json:"username" binding:"required"`
    Password   string `form:"password" json:"password" binding:"required"`
}
funcLogin(c *gin.Context) {
    var u User
    err :=c.BindJSON(&u)
    fmt.Println(err)
    fmt.Println(u)
}

先建一个结构体 user,再使用 BindJSON 绑定,将 request 中的 Body 中的数据按照 JSON 格式解析到 User 结构体中。

需要注意:

  • binding:”required” 字段对应的参数未必传没有会抛出错误,非 banding 的字段,对于客户端没有传,User 结构会用零值填充。对于 User 结构没有的参数,会自动被忽略。

  • 结构体字段类型和所传参数类型要一致。

Bind 的实现都在 gin/binding 里面. 这些内置的 Bind 都实现了 Binding 接口, 主要是 Bind() 函数.

  • context.BindJSON() 支持 MIME 为 application/json 的解析

  • context.BindXML() 支持 MIME 为 application/xml 的解析

  • context.BindYAML() 支持 MIME 为 application/x-yaml 的解析

  • context.BindQuery() 只支持 QueryString 的解析, 和 Query()函数一样

  • context.BindUri() 只支持路由变量的解析

  • Context.Bind() 支持所有的类型的解析, 这个函数尽量还是少用(当 QueryString, PostForm, 路由变量在一块同时使用时会产生意想不到的效果), 目前测试 Bind 不支持路由变量的解析, Bind()函数的解析比较复杂, 这部分代码后面再看

总结

  • 通常在解决跨域问题时,通过在服务端设置 head 请求的方式比较便利。

  • 设置”Access-Control-Allow-Origin”为”*”匹配所有域名,但无法带 cookie,影响登录。设置具体域名则不受影响。

  • 前端 `Content-Type` [16] 设置为 application/json 时,服务端在接收参数数据方式不同。

参考

https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Access_control_CORS

https://blog.csdn.net/qq_37960007/article/details/91359579

http://www.okyes.me/2016/05/03/go-gin.html

https://www.cnblogs.com/CyLee/p/7644380.html

更多 golang 开发资料 [17]

喜欢本文的朋友,欢迎关注“ Go语言中文网