java向微信服务号发送消息的完整步骤实例

 更新时间:2025年06月24日 11:27:50   作者:WuWuII  
这篇文章主要介绍了java向微信服务号发送消息的相关资料,包括申请测试号获取appID/appsecret、关注公众号获取openID、配置消息模板及代码实现,需要的朋友可以参考下

https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Overview.html

步骤

  1. 申请测试系统
  2. 拿到公众号appIDappsecret
  3. 关注测试公众号
  4. 创建消息模板
  5. 编辑java代码进行测试

1. 申请测试系统

申请测试系统,相当于给你申请了一个测试用的公众号,用来测试发送消息,地址:申请测试

2. 公众号账号信息

申请成功后,会跳转到测试系统页面,这里有appIDappsecret

3. 关注测试号二维码

找到测试二维码,扫描二维码,相当于关注你申请的测试公众号,扫描关注后,右边是关注了这个测试公众号的用户,微信号就是openID,java代码发送消息的时候,就是指定这个openID(微信号)

4. 消息模板接口

找到模板消息接口,点击新增测试模板,编辑内容,如果是要填充数据,要以{{字段名.DATA}}的格式保存,DATA是固定的

5. java测试

import cn.hutool.http.HttpUtil;
import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.JSONObject;
import org.springframework.stereotype.Service;

import java.time.LocalDateTime;
import java.util.HashMap;
import java.util.Map;

@Service
public class MessageSendService {

    private static final String SEND_MSG_API = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=";
	//值是步骤3中,关注的用户的微信号
    private String openId="";
	//固定值
    private String grant_type="client_credential";
	//公众号的appId,我这里使用的测试系统的,在步骤2中
    private String appId="";
	//公众号的secret,我这里使用的测试系统的,在步骤2中
    private String secret="";
    /***
     * 发送模板消息
     *  (消费成功通知)
     */
    public Map<String, Object> sendCreateOrderTemplateMsg() {
        //获取token,获取的是公众号的token,验证通过,拿到token才能发送给关注了自己公众号的微信用户
        String token = this.getToken();
        //消息模板ID,步骤3中的模板的id
        String template_id = "cxlPOooN67-fCjVABt9mHBLJfwpkLkWHM6AE0Rh3jJo";
        // 接口地址
        String sendMsgApi = SEND_MSG_API + token;
        //openId微信号关注服务号的唯一标识
        String toUser = openId;
        //整体参数map
        Map<String, Object> paramMap = new HashMap<>();
        //消息主题显示相关map
        Map<String, Object> dataMap = new HashMap<String, Object>();
        //对应消息模板的{{dateTime.DATA}},第二个参数是颜色,目前测试是无效的,可以不要
        dataMap.put("dateTime",  createMsg(String.valueOf(LocalDateTime.now()),"#8c2444"));
        dataMap.put("address", createMsg("上海", "#8c2444"));
		//toUser就是接收人的openID,步骤3中的微信号
        paramMap.put("touser", toUser);
        //template_id是步骤4中创建的模板的id
        paramMap.put("template_id", template_id);
        //data是模板中的参数的map集合,键值对
        paramMap.put("data", dataMap);

        return Map.of("result",HttpUtil.post(sendMsgApi, JSON.toJSONString(paramMap)));
    }

    /**
     * 构建消息,
     * @param value
     * @param color
     * @return
     */
    private Map<String, Object> createMsg(String value,String color) {
        return Map.of("value",value,"color",color);
    }


    /**
     * 获取token
     * @return token
     */
    public String getToken() {

        // 接口地址拼接参数(appid为微信服务号的appid,secret为服务号的秘钥)
        String getTokenApi = "https://api.weixin.qq.com/cgi-bin/token?grant_type=" + grant_type + "&appid=" + appId
                + "&secret=" + secret;
        String tokenJsonStr = HttpUtil.get(getTokenApi);
        JSONObject tokenJson = JSONObject.parseObject(tokenJsonStr);
        String token = tokenJson.get("access_token").toString();
        System.out.println("获取到的TOKEN : " + token);
        return token;
    }
}

成功接收

其它

  • 需要主意的是,这里使用的是申请的测试的公众号,有了实际的公众号,可能要主意是否添加了指定服务器的白名单,否则会报错40164{"errcode":40164,"errmsg":"invalid ip ipv6 ::ffff:, not in whitelist rid: 68461f004be2"}
  • 模板配置的参数格式是{{dateTime.DATA}},这里{{.DATA}}都是固定的,dateTime是参数名,它的值是一个Map,key是value,这个key是固定的,而实际的value才是真正的dateTime值,可能有点绕。看下面实际效果,应该就明白了。
    • 这里有个值,color,是可选的,可以设置值的颜色,但是测试中没有生效,不知道真实的会不会生效,不传也可以,直接dataMap.put("address", Map.of("value","上海"));
      贴张图

到此这篇关于java向微信服务号发送消息的文章就介绍到这了,更多相关java微信服务号发送消息内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Spring Security与JWT实现微服务安全认证的方法

    Spring Security与JWT实现微服务安全认证的方法

    本文详细介绍了在Spring Cloud微服务架构中使用Spring Security和JWT实现安全认证的完整方案,通过合理的架构设计、安全的实现方式和完善的防护措施,可以构建一个安全、可靠的微服务认证系统,本文介绍的非常详细,感兴趣的朋友一起看看吧
    2026-01-01
  • springcloud nacos的赋值均衡和动态刷新

    springcloud nacos的赋值均衡和动态刷新

    nacos是一个分布式的配置中心和注册发现中心,这篇文章主要介绍了springcloud nacos的赋值均衡和动态刷新,需要的朋友可以参考下
    2024-05-05
  • SpringBoot如何打包自定义生成的包名

    SpringBoot如何打包自定义生成的包名

    这篇文章主要介绍了SpringBoot如何打包自定义生成的包名问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-06-06
  • MyBatis+Calcite实现多数据库SQL自动适配的详细指南

    MyBatis+Calcite实现多数据库SQL自动适配的详细指南

    在当今企业IT环境中,数据库异构性已成为常态,根据DB-Engines最新调研,超过78%的企业同时使用两种以上数据库系统,所以本文就来为大家介绍一下如何基于MyBatis+Calcite实现多数据库SQL自动适配吧
    2025-04-04
  • java8 计算时间差的方法示例

    java8 计算时间差的方法示例

    这篇文章主要介绍了java8 计算时间差的方法示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-10-10
  • 启动异常invalid constant type:15的解决方案

    启动异常invalid constant type:15的解决方案

    今天小编就为大家分享一篇关于启动异常invalid constant type:15的解决方案,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2018-12-12
  • hadoop之MapReduce框架原理

    hadoop之MapReduce框架原理

    这篇文章主要介绍了hadoop的MapReduce框架原理,MapReduce是分为两个阶段的,MapperTask阶段,和ReduceTask阶段。如果有感兴趣的小伙伴可以借鉴参考
    2023-03-03
  • 深度对比与解析SpringBoot中的application.properties与application.yml

    深度对比与解析SpringBoot中的application.properties与application.yml

    在Springboot项目中,使用.properties和.yml配置是等效的,均可以正常识别并使用,本文将为大家深入对比与解析一下二者的使用与区别,希望对大家有一定的帮助
    2025-04-04
  • 详解JAVA使用Comparator接口实现自定义排序

    详解JAVA使用Comparator接口实现自定义排序

    这篇文章主要介绍了JAVA使用Comparator接口实现自定义排序,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-03-03
  • SpringBoot 2 快速整合 Filter过程解析

    SpringBoot 2 快速整合 Filter过程解析

    这篇文章主要介绍了SpringBoot 2 快速整合 Filter过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-09-09

最新评论