前言

最近做项目时需要做个小程序的消息推送，所以在这里记录分享一下实现过程

一、什么是消息推送

↓↓↓↓
官方文档

小程序提供了多种消息方式，一般常用的是模板消息和订阅消息，但是模板消息推送，在2020年1月10日下线，所以我们就是用使用订阅消息了。

功能介绍
消息能力是小程序能力中的重要组成，我们为开发者提供了订阅消息能力，以便实现服务的闭环和更优的体验。

• 订阅消息推送位置：服务通知
• 订阅消息下发条件：用户自主订阅
• 订阅消息卡片跳转能力：点击查看详情可跳转至该小程序的页面

消息类型

1. 一次性订阅消息
   一次性订阅消息用于解决用户使用小程序后，后续服务环节的通知问题。用户自主订阅后，开发者可不限时间地下发一条对应的服务消息；每条消息可单独订阅或退订。

2. 长期订阅消息
   一次性订阅消息可满足小程序的大部分服务场景需求，但线下公共服务领域存在一次性订阅无法满足的场景，如航班延误，需根据航班实时动态来多次发送消息提醒。为便于服务，我们提供了长期性订阅消息，用户订阅一次后，开发者可长期下发多条消息。

目前长期性订阅消息仅向政务民生、医疗、交通、金融、教育等线下公共服务开放，后期将逐步支持到其他线下公共服务业务。

二、获取模板ID

百度搜索微信公众平台

微信扫码登录

在功能中找到订阅消息

点击开通订阅消息

由于长期性订阅消息，目前仅向政务民生、医疗、交通、金融、教育等线下公共服务开放，后期将逐步支持到其他线下公共服务业务。仅就线下公共服务这一点，长期性订阅消息就和大部分开发者无缘了。
所以我们这里只能以使用一次性订阅消息为例。

选择先要的公共模板，也可以自己定制，但是公共模板已经可以满足我们绝大多数业务场景了

如上图，我们从公共模板库里选择一个一次性订阅的模板。然后编辑模板如下图

下图就是我们添加好的模板，下图的模板id就是我们需要的。

三、获取access_token

首先来看下access_token是什么，下图是官方给出的：

其实通俗的讲，access_token就是小程序官方给我们提供的一个凭证，你要调用小程序官方的接口，就必须先拿到access_token。这个和我们做的项目调用后台接口必须登录后台给你一个token你带token访问相似。

看一下官方文档：

grant_type是一个固定的值，只有appid和secret是需要我们填入的，这两个值在我们的小程序后台就可以拿到。

下面就是Java后台代码的编写了

我这里用的是springboot，这里要请求小程序官方接口，正常项目开发我都是用的自己写的接口请求工具类的，这里为了大家方便就用了springboot自带的RestTemplate来做网络请求。文章最后我会把我自己写的这个请求工具类贴出来有需要的朋友可以copy，具体代码如下。

代码如下（示例）：

这里代码很简单，就一个简单的get请求。不过要注意一点，这里获取的access_token是有两个小时的过期时间的

所以在获取到access_token的时候，把access_token存到数据库，或者存到本地缓存，并且还要记录当前时间，后面再用的时候先判断这个access_token有没有超过2个小时，如果超过2个小时的话，就要重新获取了。但这里我就不做了，只是你们在做开发的时候尽量还是规范点。

四、发送消息

官方文档

老规矩还是先看官方文档

上面的参数都是我们发送消息时需要的。

这里有个需要特别注意的点，我们要给用户发送消息，就必须引导用户授权，如下

因为用户不点击允许，你是没有办法给用户推送消息的。每一次授权只允许发送一条消息，所以如果你想尽量多的发送消息，就得尽量多的引导用户授权。

我们这里用到了wx.requestSubscribeMessage这个方法，来获取用户的授权。

这里我把前端的代码也贴出来大家可以参考参考

<button bindtap="getAuthority" type='primary'>获取订阅消息授权</button>

//获取授权的点击事件
  getAuthority() {
    wx.requestSubscribeMessage({
      tmplIds: ['CFeSWarQL*************8V8bFLkBzTU'], //这里填入我们生成的模板id
      success(res) {
        console.log('授权成功', res)
      },
      fail(res) {
        console.log('授权失败', res)
      }
    })
  }

推送的Java代码如下
代码如下（示例）：

可以看到，我们这里需要定义用户的openid，模板id，跳转路径，模板消息内容等。
这些都定义好以后，我们就可以提供一个服务给到Java的其他代码调用，或者提供一个接口供外界传入openid，然后给对应的用户推送消息了。

然后小程序就收到了

五、完整的代码

1. 获取access_token

下面的appId，appSecret替换成你们自己的，具体的可以去小程序后台查看

public static final String WX_ACCESS_TOKEN = "https://api.weixin.qq.com/cgi-bin/token?grant_type={grant_type}&appid={appid}&secret={secret}";

public String getAccessToken() {

        Map<String,Object> params = new HashMap<>();
        params.put("grant_type","client_credential");
        params.put("appid",appId);
        params.put("secret",appSecret);

        //发送请求
        String result = RestTemplateUtil.requestForGetString(WX_ACCESS_TOKEN , params);

        JSONObject jsonObject = JSONObject.parseObject(result);
        String accessToken = jsonObject.getString("access_token");
        if (StringUtils.isEmpty(accessToken)) {
            log.error("获取access token失败: {}" , jsonObject.getString("errmsg"));
            throw new ApiException("获取access token失败");
        } else {
            log.info("wx access_token : {}",accessToken);
            return accessToken;
        }

    }

2. 发送消息

public static final String SEND_INFO_URL = "https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=";

    public String push(QueueInfoTempDto info) {
        RestTemplate restTemplate = new RestTemplate();
        String url =  SEND_INFO_URL  + getAccessToken();
        //拼接推送的模版
        WxMssVO wxMssVo = new WxMssVO();
        wxMssVo.setTouser(info.getOpenId());//用户的openId
        wxMssVo.setTemplate_id(templateId);//订阅消息模板id
        wxMssVo.setPage("pages/appointment/line_up?"+"shopId="+info.getShopId());

        Map<String, TemplateData> m = new HashMap<>(5);
        m.put("thing1", new TemplateData(info.getShopName()));
        m.put("thing2", new TemplateData(info.getCode()));
        m.put("thing3", new TemplateData("前面还有"+info.getPreNumber()+"桌,请耐心等待"));
        m.put("thing9", new TemplateData(info.getNumber()+"人"));
        m.put("time8", new TemplateData(DateUtils.sdfTime.format(info.getCreatedTime())));
        wxMssVo.setData(m);
        ResponseEntity<String> responseEntity =
                restTemplate.postForEntity(url, wxMssVo, String.class);
        return responseEntity.getBody();
    }

3. 对应的两个数据类如下
   WxMssVo用来封装请求官方接口的参数

@Data
public class WxMssVO {

    private String touser;//用户openid
    private String template_id;//订阅消息模版id
    private String page = "pages/index/index";//默认跳到小程序首页
    private Map<String, TemplateData> data;//推送文字
}

TemplateData 用来定义消息的内容

@AllArgsConstructor
@Data
public class TemplateData {
    private String value;
}

到这里我们就可以完整的实现Java发送小程序消息的功能了。完整代码也已经贴给大家了。

总结

本文是比较老得技术来实现，用最新技术实现小程序推送，请看
5行java代码实现微信小程序模版消息推送 （含springboot后台和小程序源码）
也可以看最新的视频讲解：https://edu.csdn.net/course/detail/23750

最近需要开发微信和小程序的推送功能，需要用java后台实现推送，自己本身java和小程序都做，所以就自己动手实现下小程序的模版推送功能推送。

实现思路

• 1 小程序获取用户openid，收集formid传给java后台
• 2 java推送消息给指定小程序用户

老规矩，还是先看效果图

我的这个是跑腿抢单推送，当用户新下单时，会给跑腿员推送消息。

下面开始讲解实现步骤

一，微信小程序管理后台开通模版推送

这里的模版id很重要，接下来我们推送的都是这个模版。

二，java后台实现推送所需字段

• 1 看微信官方推送消息所需要的字段
  
  
• 2 有了官方说明，我门接下来就去拿到官方所需要的这些字段，来组装请求数据就可以了。

三，下面讲解实现步骤

我的java后台是基于springboot开发的，如果你不了解spring boot，建议你先去了解下springboot再回来接着学习。
还有RestTemplate是我们java后台做get和post请求必须的，我们和微信服务器交互就用的RestTemplate

• 1 首先根据官方推送所需字段组装java-bean
  这里用到两个javabean

/*
* 小程序推送所需数据
* qcl 微信：2501902696
* */
@Data
public class WxMssVo {
    private String touser;//用户openid
    private String template_id;//模版id
    private String page = "index";//默认跳到小程序首页
    private String form_id;//收集到的用户formid
    private String emphasis_keyword = "keyword1.DATA";//放大那个推送字段
    private Map<String, TemplateData> data;//推送文字
}

/*
* 设置推送的文字和颜色
* qcl 微信：2501902696
* */
@Data
public class TemplateData {
    //keyword1：订单类型，keyword2：下单金额，keyword3：配送地址，keyword4：取件地址，keyword5备注
    private String value;//,,依次排下去
//    private String color;//字段颜色（微信官方已废弃，设置没有效果）
}

到这里请求推送的数据就组装好了，解下来我们去实现推送功能。
奥不对，还有一个重要的字段需要获取到：access_token

access_token的获取

/*
    * 获取access_token
    * appid和appsecret到小程序后台获取，当然也可以让小程序开发人员给你传过来
    * */
    public String getAccess_token(String appid, String appsecret) {
        //获取access_token
        String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential" +
                "&appid=" + appid + "&secret=" + appsecret;
        String json = restTemplate.getForObject(url, String.class);
        AccessToken accessToken = new Gson().fromJson(json, AccessToken.class);
        return accessToken.getAccess_token();
    }

这次是真正的可以来请求微信服务器来实现消息推送了

/*
    * 微信小程序推送单个用户
    * */
    public String pushOneUser(String openid, String formid) {


        //获取access_token
        String access_token = getAccess_token(ConstantUtils.SCHOOL_APPID, ConstantUtils.SCHOOL_APPSECRET);
        String url = "https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send" +
                "?access_token=" + access_token;

        //拼接推送的模版
        WxMssVo wxMssVo = new WxMssVo();
        wxMssVo.setTouser(openid);//用户openid
        wxMssVo.setTemplate_id("LzeDP0G5PLgHoOjCMfhu44wfUluhW11Zeezu3r_dC24");//模版id
        wxMssVo.setForm_id(formid);//formid


        Map<String, TemplateData> m = new HashMap<>(5);

        //keyword1：订单类型，keyword2：下单金额，keyword3：配送地址，keyword4：取件地址，keyword5备注
        TemplateData keyword1 = new TemplateData();
        keyword1.setValue("新下单待抢单");
        m.put("keyword1", keyword1);

        TemplateData keyword2 = new TemplateData();
        keyword2.setValue("这里填下单金额的值");
        m.put("keyword2", keyword2);
        wxMssVo.setData(m);

        TemplateData keyword3 = new TemplateData();
        keyword3.setValue("这里填配送地址");
        m.put("keyword3", keyword3);
        wxMssVo.setData(m);

        TemplateData keyword4 = new TemplateData();
        keyword4.setValue("这里填取件地址");
        m.put("keyword4", keyword4);
        wxMssVo.setData(m);

        TemplateData keyword5 = new TemplateData();
        keyword5.setValue("这里填备注");
        m.put("keyword5", keyword5);
        wxMssVo.setData(m);

        ResponseEntity<String> responseEntity =
                restTemplate.postForEntity(url, wxMssVo, String.class);
        log.error("小程序推送结果={}", responseEntity.getBody());
        return responseEntity.getBody();
    }

openid可以让小程序开发人员给你传过来，也可以自己获取。
formid需要小程序开发给你传过来，你也可以把formid存到数据库里，什么时候需要直接拿出来用就可以了。
注意：formid必须和用户openid对应。

下面贴出来完整代码

package com.qcl.paotuischool.wechat;

import com.google.gson.Gson;
import com.qcl.userwechat.bean.AccessToken;
import com.qcl.utils.ConstantUtils;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

import java.util.HashMap;
import java.util.Map;

import lombok.extern.slf4j.Slf4j;

/**
 * Created by qcl on 2018/9/11.
 * 微信小程序推送服务，
 * 包含获取access_token的服务
 */
@Service
@Slf4j
public class WxPushServiceQcl {
    //用来请求微信的get和post
    @Autowired
    private RestTemplate restTemplate;


    /*
    * 微信小程序推送单个用户
    * */
    public String pushOneUser(String openid, String formid) {


        //获取access_token
        String access_token = getAccess_token(ConstantUtils.SCHOOL_APPID, ConstantUtils.SCHOOL_APPSECRET);
        String url = "https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send" +
                "?access_token=" + access_token;

        //拼接推送的模版
        WxMssVo wxMssVo = new WxMssVo();
        wxMssVo.setTouser(openid);//用户openid
        wxMssVo.setTemplate_id("LzeDP0G5PLgHoOjCMfhu44wfUluhW11Zeezu3r_dC24");//模版id
        wxMssVo.setForm_id(formid);//formid


        Map<String, TemplateData> m = new HashMap<>(5);

        //keyword1：订单类型，keyword2：下单金额，keyword3：配送地址，keyword4：取件地址，keyword5备注
        TemplateData keyword1 = new TemplateData();
        keyword1.setValue("新下单待抢单");
        m.put("keyword1", keyword1);

        TemplateData keyword2 = new TemplateData();
        keyword2.setValue("这里填下单金额的值");
        m.put("keyword2", keyword2);
        wxMssVo.setData(m);

        TemplateData keyword3 = new TemplateData();
        keyword3.setValue("这里填配送地址");
        m.put("keyword3", keyword3);
        wxMssVo.setData(m);

        TemplateData keyword4 = new TemplateData();
        keyword4.setValue("这里填取件地址");
        m.put("keyword4", keyword4);
        wxMssVo.setData(m);

        TemplateData keyword5 = new TemplateData();
        keyword5.setValue("这里填备注");
        m.put("keyword5", keyword5);
        wxMssVo.setData(m);

        ResponseEntity<String> responseEntity =
                restTemplate.postForEntity(url, wxMssVo, String.class);
        log.error("小程序推送结果={}", responseEntity.getBody());
        return responseEntity.getBody();
    }

    /*
    * 获取access_token
    * appid和appsecret到小程序后台获取，当然也可以让小程序开发人员给你传过来
    * */
    public String getAccess_token(String appid, String appsecret) {
        //获取access_token
        String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential" +
                "&appid=" + appid + "&secret=" + appsecret;
        String json = restTemplate.getForObject(url, String.class);
        AccessToken accessToken = new Gson().fromJson(json, AccessToken.class);
        return accessToken.getAccess_token();
    }

}

在需要做推送的地方调用WxPushServiceQcl类中的pushOneUser方法，并传入openid, formid参数即可。

这是我推送成功后打印的log

下面来讲小程序端开发需要做些什么

可以看出，我们的formid有效期是7天，并且一个form_id只能使用一次，所以我们小程序端所需要做的就是尽可能的多拿些formid，然后传个后台，让后台存到数据库中，这样7天有效期内，想怎么用就怎么用了。

所以接下来要讲的就是小程序开发怎么尽可能多的拿到formid了。

看下官方提供的，只有在表单提交时把report-submit设为true时才能拿到formid，比如这样

 <form report-submit='true' >
   <button  form-type='submit'>获取formid</button>
  </form>

所以我们就要在这里下功夫了，既然只能在form组件获取，我们能不能把我们小程序里用到最多的地方用form来伪装呢。

我的小程序是跑腿小程序，消息也主要推送给跑腿员的，而跑腿员点击最多的也就是这两个条目，所以我们就用from组件来伪装这两个条目，让用户在点击的同时就可以收集到用的formid。

 <view class='button_item'>
  <form class="form_item" bindsubmit='gorRunnerLobby' report-submit='true' data-type="1">
   <button class="button" form-type='submit'>
    <text>抢单大厅</text>
    <text class='runner_desc'>(兼职也可月入万元)</text>
   </button>
  </form>
  <view class='right_arrow' />
 </view>

这样就可以在用户点击条目时，收集到用户formid了

由于上面的botton有默认样式，所以我们就通过修改css来去除botton默认样式。

.button_item {
 width: 100%;
 display: flex;
 flex-direction: row;
 align-items: center;
 padding: 2px 20px;
 background: white;
 border-bottom: 1px solid gainsboro;
}
/* 主要通过这里去除botton默认样式 */
.button {
 width: 100%;
 background: white;
 border: none;
 text-align: left;
 padding: 6px 0px;
 margin: 0px;
 line-height: 1.5;
}

/* 主要通过这里去除botton边框 */
.button::after {
 border: none;
}

/* 用button伪装获取formid */

.form_item {
 width: 100%;
}

到这里我们小程序端也圆满完成自己的任务了。

补充知识点

• 小程序开发如何获取用户openid
• 借助小程序云开发获取小程序用户openid

这样我们java后台和小程序开发就可以开开心心的完成微信小程序的消息推送功能了。

如果有java或小程序相关的问题可以加我微信交流学习2501902696（备注小程序或java）

视频讲解：https://edu.csdn.net/course/detail/23750