• 本文基于之前几个项目在部署在微信公众号下的网页应用，以此写下微信公众号开发的步骤以及踩过的坑

申请测试公众号

• 首先开发者可以在微信测试平台申请测试公众号微信测试号申请
  进入如下的界面
  TIM截图20180305211259.png
  
  appid相当于公众号的为唯一标识，appsecret相当于公众号的密码，用于获取access_token等（access_token可以用于推送模板消息等）
• 得到服务号后要部署到服务器上需要验证服务器验证（接口配置信息的URL），验证规定使用80或443端口
• 如果是本地主机测试没有域名可以使用natapp进行内网映射
• 填写服务器地址URL(可以使用主机域名)、Token(这里的token自定义，区别与之后的access_token)
• 开发者提交信息后，微信服务器将发送GET请求到填写的服务器地址URL上，GET请求携带参数如下表所示：

若确认此次GET请求来自微信服务器，请原样返回echostr参数内容，则接入生效，成为开发者成功，否则接入失败。加密/校验流程如下：

1. 将token、timestamp、nonce三个参数进行字典序排序
2. 将三个参数字符串拼接成一个字符串进行sha1加密 3）开发者获得加密后的字符串可与signature对比，标识该请求来源于微信

参考go语言

package main

import (
        "crypto/sha1"
        "fmt"
        "io"
        "log"
        "net/http"
        "sort"
        "strings"
)

const (
        token = "wechat"
)

func makeSignature(timestamp, nonce string) string {
        sl := []string{token, timestamp, nonce}
        sort.Strings(sl)
        s := sha1.New()
        io.WriteString(s, strings.Join(sl, ""))
        return fmt.Sprintf("%x", s.Sum(nil))
}

func validateUrl(w http.ResponseWriter, r *http.Request) bool {
        timestamp := strings.Join(r.Form["timestamp"], "")
        nonce := strings.Join(r.Form["nonce"], "")
        signatureGen := makeSignature(timestamp, nonce)

        signatureIn := strings.Join(r.Form["signature"], "")
        if signatureGen != signatureIn {
                return false
        }
        echostr := strings.Join(r.Form["echostr"], "")
        fmt.Fprintf(w, echostr)
        return true
}

func procRequest(w http.ResponseWriter, r *http.Request) {
        r.ParseForm()
        if !validateUrl(w, r) {
                log.Println("Wechat Service: this http request is not from Wechat platform!")
                return
        }
        log.Println("Wechat Service: validateUrl Ok!")
}

func main() {
        log.Println("Wechat Service: Start!")
        http.HandleFunc("/", procRequest)
        err := http.ListenAndServe(":80", nil)
        if err != nil {
                log.Fatal("Wechat Service: ListenAndServe failed, ", err)
        }
        log.Println("Wechat Service: Stop!")
}

注意微信服务器填写的URL中的域名api对应代码的api

公众号授权登录

关于网页授权的两种scope的区别说明

1. 以snsapi_base为scope发起的网页授权，是用来获取进入页面的用户的openid的，并且是静默授权并自动跳转到回调页的。用户感知的就是直接进入了回调页（往往是业务页面）
   2.以snsapi_userinfo为scope发起的网页授权，是用来获取用户的基本信息的。但这种授权需要用户手动同意，并且由于用户同意过，所以无须关注，就可在授权后获取该用户的基本信息。
2. 用户管理类接口中的“获取用户基本信息接口”，是在用户和公众号产生消息交互或关注后事件推送后，才能根据用户OpenID来获取用户基本信息。这个接口，包括其他微信接口，都是需要该用户（即openid）关注了公众号后，才能调用成功的。

注：

• 一个用户经过微信snsapi_base授权登录后，微信服务器会返回用户的唯一标识openid，该openid在本公众号中具有唯一性，但不同公众号同一用户拥有不同的openid
• 开发者如果需要跨公众号识别同一用户，可以使用snsapi_userinfo方法拉取用户的UnionID

snsapi_base方法授权解释

遵循规则：
1、在微信公众号请求用户网页授权之前，开发者需要先到公众平台官网中的“开发 - 接口权限 - 网页服务 - 网页帐号 - 网页授权获取用户基本信息”的配置选项中，修改授权回调域名。请注意，这里填写的是域名（是一个字符串），而不是URL，因此请勿加 http:// 等协议头，例如：gzhu.edu.cn；
2、授权回调域名配置规范为全域名，比如需要网页授权的域名为：www.qq.com，配置以后此域名下面的页面http://www.qq.com/music.html 、 http://www.qq.com/login.html 都可以进行OAuth2.0鉴权。但http://pay.qq.com 、 http://music.qq.com 、 http://qq.com无法进行OAuth2.0鉴权

授权登录流程：

微信授权.png

开发者开发时最好先判断用户信息是否过期，过期再重定向用户至微信授权登录
授权登录go演示代码

func AuthLogin(w http.ResponseWriter, r *http.Request) {

    title := "登录"

    if r.Method != "GET" {
        responHtml(w, title, "请求方式错误!")
        return
    }

    err:=r.ParseForm()
    if err!=nil{
        wc.logger.Error(fmt.Errorf("auth login fail: %v",err))
        responHtml(w, title, "系统错误")
        return
    }


    route := r.FormValue("route")
    if route == "" {
        wc.logger.Warning("auth login fail: route is nil")
        responHtml(w, title, "路由为空")
        return
    }

    sess,err := wc.CheckSession(r)
    if err!=nil{
        wc.logger.Error(fmt.Errorf("auth login fail: %v",err))
        responHtml(w, title, "系统错误")
        return
    }

    if sess==nil {
        wc.logger.Info("授权登陆：cookie 过期，重新授权")
        url := wc.conf.UserOAuthUrl + "appid=" + wc.conf.AppID + "&redirect_uri=" + wc.conf.ServerHost+wc.conf.ServerGrantAPI +
            "&response_type=code&scope=snsapi_base&state=" + route + "#wechat_redirect"
        http.Redirect(w, r, url, 302)
        return
    }else {
        if wc.route[route] == "" {
            wc.logger.Warning(fmt.Errorf("auth login fail: route %s doesn't exist ", route))
            responHtml(w, title, "路由 "+route+" 不存在")
            return
        }

        redirectUrl:=wc.conf.ServerHost+wc.route[route]
        wc.logger.Info(fmt.Sprintf("授权登陆成功：用户：%s 重定向至 %s",sess.UserID,redirectUrl))
        http.Redirect(w, r, redirectUrl, 302)
        return
    }
}

//微信授权
func WechatGrant(w http.ResponseWriter, r *http.Request) {
    title := "授权"

    r.ParseForm()
    code := r.FormValue("code")
    state := r.FormValue("state")

    if len(code) == 0 {
        wc.logger.Warning("wechat grant fail: code is invalid")
        responHtml(w, title, "code is invalid")
        return
    }
    if state == "" {
        wc.logger.Warning("wechat grant fail: state is invalid")
        responHtml(w, title, "state is invalid")
        return
    }

    var data *http.Response
    var err error
    url := wc.conf.GetOpenIDUrl + "appid=" + wc.conf.AppID + "&secret=" + wc.conf.AppSecret +
        "&code=" + code + "&grant_type=authorization_code"

    wc.logger.Info("微信授权：获取用户信息链接：" + url)

    data, err = http.Get(url)
    if err != nil {
        wc.logger.Error(fmt.Errorf("wechat grant fail: %v", err))
        responHtml(w, title, "系统错误")
        return
    }

    body, err := ioutil.ReadAll(data.Body)
    defer data.Body.Close()
    if err != nil {
        wc.logger.Error(fmt.Errorf("wechat grant fail: %v", err))
        responHtml(w, title, "系统错误")
        return
    }

    userGrantInfo := &userGrantInfo{}
    err = json.Unmarshal(body, userGrantInfo)
    if err != nil {
        wc.logger.Error(fmt.Errorf("wechat grant fail: %v", err))
        responHtml(w, title, "系统错误")
        return
    }

    if len(userGrantInfo.OpenID) == 0 {
        wc.logger.Error("wechat grant fail: openid nil")
        responHtml(w, title, "openid 为空")
        return
    }

    err = wc.GrantCallBack(w, r, userGrantInfo.OpenID)
    if err != nil {
        wc.logger.Error(fmt.Errorf("wechat grant fail: %v", err))
        responHtml(w, title, "系统错误")
        return
    }

    if wc.route[state] == "" {
        wc.logger.Warning(fmt.Errorf("wechat grant fail: route %s doesn't exist", state))
        responHtml(w, title, "路由错误："+state)
        return
    }

    wc.logger.Info("微信授权：用户%s登录成功，重定向至%s",userGrantInfo.OpenID,wc.conf.ServerHost+wc.route[state])

    http.Redirect(w, r, wc.conf.ServerHost+wc.route[state], 302)

}

微信assess_token管理

access_token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的access_token失效，所以微信assess_token再服务器端应该有一个统一管理的模块

微信官方文档表述：

1、建议公众号开发者使用中控服务器统一获取和刷新Access_token，其他业务逻辑服务器所使用的access_token均来自于该中控服务器，不应该各自去刷新，否则容易造成冲突，导致access_token覆盖而影响业务；
2、目前Access_token的有效期通过返回的expire_in来传达，目前是7200秒之内的值。中控服务器需要根据这个有效时间提前去刷新新access_token。在刷新过程中，中控服务器可对外继续输出的老access_token，此时公众平台后台会保证在5分钟内，新老access_token都可用，这保证了第三方业务的平滑过渡；
3、Access_token的有效时间可能会在未来有调整，所以中控服务器不仅需要内部定时主动刷新，还需要提供被动刷新access_token的接口，这样便于业务服务器在API调用获知access_token已超时的情况下，可以触发access_token的刷新流程。

获取接口调用请求说明
https请求方式: GET
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
参数说明

返回说明
正常情况下，微信会返回下述JSON数据包给公众号：
{"access_token":"ACCESS_TOKEN","expires_in":7200}

{"errcode":40013,"errmsg":"invalid appid"}
返回码说明

注意，在生产环境中，access_token的获取需要在微信公众号后台设置服务器的IP地址，如果请求access_token的源IP不在微信公众号配置的ip白名单中，将会获取失败，因此保险起见要配置服务器对外IP所有可变情况，因为曾经微信服务器检测到我们学校的服务器是会跳动的（实际上我们的服务器对外IP不变）