微信程序开发之微信接入

最新推荐文章于 2024-03-25 21:50:33 发布

爱嘤斯塔

最新推荐文章于 2024-03-25 21:50:33 发布

阅读量4.6k

点赞数

文章标签：微信微信小程序小程序

本文链接：https://blog.csdn.net/weixin_60389087/article/details/123295204

版权

本文详细介绍了微信公众号的开发流程，包括注册、获取access_token、创建自定义菜单、接口配置、内网穿透工具的使用，以及后台配置和错误处理。通过实名认证、购买免费隧道并设置natapp客户端，实现本地8080端口对外访问。同时展示了如何使用Weixin4j库创建菜单，并处理微信消息。最后，文章提到了Redis的使用以及后台接收和响应用户扫码信息。

摘要由CSDN通过智能技术生成

一、微信公众号

1、详情网址

微信公众平台

微信官方文档 | 微信开放文档

微信公众平台接口调试工具

几款免费内网穿透工具测评使用 - 哔哩哔哩

2、使用测试号

①、微信公众平台

可以进行登录或注册：

公众号分类：

订阅号: 个人
服务号支付: 公司-工商营业执照,个体户-工商营业执照
企业号: 公司-工商营业执照
测试号: 拥有所有接口

咱们就使用测试号👆进行扫码登录：

生成id与密钥：

以及公众号二维码：

公众号：

3、获取令牌access_token

access_token是公众号的全局唯一接口调用凭据，公众号调用各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的access_token失效。并且获取acces_token是有上限的，只能调用2000次。

使用微信公众平台接口调试工具

得到令牌：

每次生成的令牌应该存起来，不应存在数据库，因为令牌会过期，存在redis内。

4、生成菜单栏

注意：

①、自定义菜单最多包括3个一级菜单，每个一级菜单最多包含5个二级菜单。

②、一级菜单最多4个汉字，二级菜单最多8个汉字，多出来的部分将会以“...”代替。

③、创建自定义菜单后，菜单的刷新策略是，在用户进入公众号会话页或公众号profile页时，如果发现上一次拉取菜单的请求在5分钟以前，就会拉取一下菜单，如果菜单有更新，就会刷新客户端的菜单。测试时可以尝试取消关注公众账号后再次关注，则可以看到创建后的效果。

access_token：为之前的令牌，body：为菜单栏

body内容：

{
    "button": [
        {
            "name": "扫码", 
            "sub_button": [
                {
                    "type": "scancode_waitmsg", 
                    "name": "扫码带提示", 
                    "key": "rselfmenu_0_0", 
                    "sub_button": [ ]
                }, 
                {
                    "type": "scancode_push", 
                    "name": "扫码推事件", 
                    "key": "rselfmenu_0_1", 
                    "sub_button": [ ]
                }
            ]
        }, 
        {
            "name": "发图", 
            "sub_button": [
                {
                    "type": "pic_sysphoto", 
                    "name": "系统拍照发图", 
                    "key": "rselfmenu_1_0", 
                    "sub_button": [ ]
                }, 
                {
                    "type": "pic_photo_or_album", 
                    "name": "拍照或者相册发图", 
                    "key": "rselfmenu_1_1", 
                    "sub_button": [ ]
                }, 
                {
                    "type": "pic_weixin", 
                    "name": "微信相册发图", 
                    "key": "rselfmenu_1_2", 
                    "sub_button": [ ]
                }
            ]
        }
    ]
}

出现菜单栏：

我删除原有的菜单：从后台获取

5、接口配置信息

URL：ip需要与域名绑定,并且需要到公安/网上备案

所以此处不支持IP的，将它变成域名，我使用了内网穿透工具：NATAPP-内网穿透基于ngrok的国内高速内网映射工具

①、注册natapp

必须实名认证，否则无法使用：

②、进入购买隧道，选择免费的：

免费购买：

得到隧道，复制authtoken:

根据本机下载对应的natapp客户端 ,下载之后解压至任意目录,得到natapp.exe (linux下无需解压,直接 wget)

同时需要找到兼容特殊编码的config.ini文件，放入，：

文件内容（修改隧道的authtoken）：

#将本文件放置于natapp同级目录 程序将读取 [default] 段
#在命令行参数模式如 natapp -authtoken=xxx 等相同参数将会覆盖掉此配置
#命令行参数 -config= 可以指定任意config.ini文件
[default]
authtoken=57b18b9e80dde414                      #对应一条隧道的authtoken
clienttoken=                    #对应客户端的clienttoken,将会忽略authtoken,若无请留空,
log=none                        #log 日志文件,可指定本地文件, none=不做记录,stdout=直接屏幕输出 ,默认为none
loglevel=ERROR                  #日志等级 DEBUG, INFO, WARNING, ERROR 默认为 DEBUG
http_proxy=                     #代理设置 如 http://10.123.10.10:3128 非代理上网用户请务必留空

运行：

访问👇网址就可以访问到本机8080端口：

本地尚未开启8080端口：

6、配置后台，开启8080端口

开启redis,在yml文件中配置

server:
  port: 8080
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/wx?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8&useSSL=false
    username: root
    password: root123
  redis:
    database: 0                           # Redis数据库索引(默认为0 redis有16个库)
    host: 47.100.191.44                      # Redis服务器地址
    port: 6379                            # Redis服务器连接端口
    password: xiaoli_redis                     # Redis服务器连接密码(默认为空)
    jedis:
      pool:
        max-active: 100                   # 连接池最大连接数(使用负值表示没有限制)
        max-idle: 10                      # 连接池中的最大空闲连接
        min-idle: 0                       # 连接池中的最小空闲连接
        max-wait: -1                      # 连接池最大阻塞等待时间(使用负值表示没有限制)
    timeout: 5000                         # 连接超时时间(毫秒),不能设置为0,时间太短连接不上会报错
  freemarker:
    allow-request-override: false
    request-context-attribute: req
    suffix: .ftl
    content-type: text/html;charset=UTF-8
    enabled: true
    cache: false
    template-loader-path: classpath:/templates/
    charset: UTF-8
  application:
    name: wx

启动后台，访问端口成功：

后台能够连接微信后台，原因是导入了依赖：

<dependency>
            <groupId>org.weixin4j.spring.boot</groupId>
            <artifactId>weixin4j-spring-boot-starter</artifactId>
            <version>1.0.0</version>
        </dependency>

配置weixin4j.properties文件，配置用户名和密码：

要与之对应：

文件内容：

#\u5FAE\u4FE1SDK\u914D\u7F6E\u6587\u4EF6
#\u8BFB\u53D6\u89C4\u5219\uFF1A\u4F18\u5148\u8BFB\u53D6System.getProperty()
#\u518D\u4ECEweixin4j.properties\u8BFB\u53D6,key
#\u5982\u679CSystem.getProperty()\u4E0Eweixin4j.properties\u90FD\u6CA1\u8BBE\u7F6E\uFF0C\u5219\u9ED8\u8BA4\u672ANULL
#\u5F00\u53D1\u8005\u8C03\u8BD5\u8BBE\u7F6E
weixin4j.debug=true
#\u516C\u4F17\u53F7Token
weixin4j.token=weixin4j
#\u516C\u4F17\u53F7\u539F\u59CBID
weixin4j.oauth.originalid=gh_deb36b02d675
#\u5F00\u53D1\u8005\u7B2C\u4E09\u65B9\u7528\u6237\u552F\u4E00\u51ED\u8BC1
weixin4j.oauth.appid=wxdda2e4d9e1360e84
#\u5F00\u53D1\u8005\u7B2C\u4E09\u65B9\u7528\u6237\u552F\u4E00\u51ED\u8BC1\u5BC6\u94A5
weixin4j.oauth.secret=eb21304348726d315d10dec33be10358
#\u6D88\u606F\u52A0\u5BC6\u65B9\u5F0F 0:\u660E\u6587\u6A21\u5F0F(\u9ED8\u8BA4), 1:\u517C\u5BB9\u6A21\u5F0F, 2:\u5B89\u5168\u6A21\u5F0F(\u63A8\u8350)
weixin4j.oauth.encodingtype=0
#\u6D88\u606F\u52A0\u5BC6\u5BC6\u94A5(43\u4F4D\u5B57\u7B26\u7EC4\u6210A-Za-z0-9)
weixin4j.oauth.encodingaeskey=0123456789abcedfghijklmnopqrstuvwxyzZXCVBNM
#\u7F51\u9875\u5B89\u5168\u6388\u6743URL
weixin4j.oauth.url=
#\u516C\u4F17\u5E73\u53F0\u63A5\u53E3\u57DF\u540D
#\u901A\u7528\u57DF\u540D(api.weixin.qq.com)\uFF0C\u4F7F\u7528\u8BE5\u57DF\u540D\u5C06\u8BBF\u95EE\u5B98\u65B9\u6307\u5B9A\u5C31\u8FD1\u7684\u63A5\u5165\u70B9\uFF1B
#\u4E0A\u6D77\u57DF\u540D(sh.api.weixin.qq.com)\uFF0C\u4F7F\u7528\u8BE5\u57DF\u540D\u5C06\u8BBF\u95EE\u4E0A\u6D77\u7684\u63A5\u5165\u70B9\uFF1B
#\u6DF1\u5733\u57DF\u540D(sz.api.weixin.qq.com)\uFF0C\u4F7F\u7528\u8BE5\u57DF\u540D\u5C06\u8BBF\u95EE\u6DF1\u5733\u7684\u63A5\u5165\u70B9\uFF1B
#\u9999\u6E2F\u57DF\u540D(hk.api.weixin.qq.com)\uFF0C\u4F7F\u7528\u8BE5\u57DF\u540D\u5C06\u8BBF\u95EE\u9999\u6E2F\u7684\u63A5\u5165\u70B9\u3002
weixin4j.api.domain=api.weixin.qq.com
#\u5FAE\u4FE1\u652F\u4ED8_\u5546\u6237ID
weixin4j.pay.partner.id=
#\u5FAE\u4FE1\u652F\u4ED8_\u5546\u6237\u5BC6\u94A5
weixin4j.pay.partner.key=
#\u5FAE\u4FE1\u652F\u4ED8_\u901A\u77E5URL
weixin4j.pay.notify_url=
#\u8FDE\u63A5\u8D85\u65F6\u8BBE\u7F6E
weixin4j.http.connectionTimeout=25000
#\u8BF7\u6C42\u8D85\u65F6\u8BBE\u7F6E
weixin4j.http.readTimeout=25000
#\u8BC1\u4E66\u8DEF\u5F84
weixin4j.http.cert.path=
weixin4j.http.cert.secret=
#\u9ED8\u8BA4\u6D88\u606F\u5904\u7406\u51FD\u6570
weixin4j.handler=org.weixin4j.spi.DefaultMessageHandler
#weixin4j.message.handler.normal=org.weixin4j.spi.DefaultNormalMessageHandler
#weixin4j.message.handler.event=org.weixin4j.spi.DefaultEventMessageHandler
weixin4j.message.handler.normal=com.yk.wx.weixin.MyAtsNormalMessageHandler
weixin4j.message.handler.event=com.yk.wx.weixin.MyAtsEventMessageHandler

而此处的话不应该访问那个端口进入主界面，而是接入微信：

后台文件：

package com.yk.wx.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.weixin4j.spring.web.WeixinJieruController;

/**
 * 微信开发者接入
 */
@Controller
@RequestMapping("/jieru")
@SuppressWarnings("all")
public class JieruController extends WeixinJieruController {
}

扫码给公众号发送信息，后台接收信息：

创建菜单：

package com.yk.wx.controller;


import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.weixin4j.Configuration;
import org.weixin4j.Weixin;
import org.weixin4j.component.MenuComponent;
import org.weixin4j.model.base.Token;
import org.weixin4j.model.menu.Menu;
import org.weixin4j.model.menu.SingleButton;
import org.weixin4j.model.menu.ViewButton;
import org.weixin4j.spring.WeixinTemplate;

import javax.servlet.http.HttpServletRequest;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

@Controller
@RequestMapping("/wx")
@Slf4j
@SuppressWarnings("all")
public class WeixinController {

    private WeixinTemplate weixinTemplate;

    @Autowired
    public WeixinController(WeixinTemplate weixinTemplate) {
        this.weixinTemplate = weixinTemplate;
    }

    public static void main(String[] args) throws Exception {
        Weixin weixin = new Weixin();
        weixin.base().token();
        Token token = weixin.getToken();
        System.out.println(token);
    }

    @RequestMapping("/createMenu")
    @ResponseBody
    public Map<String, Object> createMenu(Model model, HttpServletRequest request) {
        log.info("WeixinController.createMenu");
        String ctx = request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort() + request.getContextPath();
        log.info("ctx=" + ctx);
        Map<String, Object> jsonData = new HashMap<String, Object>();
        jsonData.put("code", 0);
        jsonData.put("message", "微信菜单创建成功,ts=" + System.currentTimeMillis());
        try {
            Menu menu = new Menu();
            //创建菜单按钮
            List<SingleButton> buttons = new ArrayList<SingleButton>();
            menu.setButton(buttons);
            SingleButton btn1 = new ViewButton("主界面", ctx + "/toMain");
            buttons.add(btn1);
            SingleButton btn2 = new ViewButton("更多", ctx + "/toHello");
            buttons.add(btn2);
            SingleButton btn3 = new ViewButton("还想要", ctx + "/toHello");
            buttons.add(btn3);
            //设置子菜单
            System.out.println(menu.toJSONObject().toString());
            //创建自定义菜单
            Weixin weixin = weixinTemplate.getWeixinFactory().getWeixin();
            MenuComponent menu1 = weixin.menu();
            menu1.create(menu);
            model.addAttribute("message", "微信菜单创建成功");
        } catch (Exception e) {
            log.error(e.getMessage());
            jsonData.put("code", -1);
            jsonData.put("message", "微信菜单创建失败,原因：" + e.getMessage());
        }
        return jsonData;
    }

    @RequestMapping("/test1")
    @ResponseBody
    public Map<String, Object> test1() {
        log.info("WeixinController.test1");
        Map<String, Object> jsonData = new HashMap<String, Object>();
        System.out.println("test");
        String s1 = Configuration.getProperty("weixin4j.message.handler.normal");
        String s2 = Configuration.getProperty("weixin4j.message.handler.event");
        jsonData.put("weixin4j.message.handler.normal", s1);
        jsonData.put("weixin4j.message.handler.event", s2);
        return jsonData;
    }

}

访问此端口创建菜单：

redis出现数据：

改变路径，解决后台报错：

点击后台路径访问：

本期内容结束~~~~~~~~~~~~~~~

爱嘤斯塔

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
微信程序开发之微信接入

一、微信公众号1、详情网址微信公众平台微信官方文档 | 微信开放文档微信公众平台接口调试工具几款免费内网穿透工具测评使用 - 哔哩哔哩2、使用测试号①、微信公众平台可以进行登录或注册：公众号分类：订阅号: 个人服务号支付: 公司-工商营业执照,个体户-工商营业执照企业号: 公司-工商营业执照测试号: 拥有所有接口咱们就使用测试号👆进行扫码登录：生成id与密钥：以及公众号二维码：公众号：3、获取令牌access..
复制链接

扫一扫