微信公众号开发初始化接入

本是古典何须时尚 2022-04-13 03:41 555阅读 0赞

**1.开通测试号：https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login**

手机微信扫描确认登录之后，网页端可以获取一个测试的接口。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70]

**2.因为测试号的URL地址的配置要求，所以本地网络必须暴露在外网，需要借助穿透工具，[下载地址][Link 1]**

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 1]  
1）下载到本地，解压缩文件夹  
2）注册一个免费的账号  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 2]  
3）注册成功之后，进行实名认证  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 3]  
![在这里插入图片描述][20181127004436255.png]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 4]  
4）点击免费隧道  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 5]  
5）复制authtoken，配置到解压好的文件夹下，在解压好的目录下新建一个文件config.ini

#将本文件放置于natapp同级目录 程序将读取 [default] 段
    #在命令行参数模式如 natapp -authtoken=xxx 等相同参数将会覆盖掉此配置
    #命令行参数 -config= 可以指定任意config.ini文件
    [default]
    authtoken= e377241028fec08af632359    #对应一条隧道的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 非代理上网用户请务必留空

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 6]  
6）将红色部分改为你复制的authtoken,然后保存  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 7]  
7）点击运行natapp.exe  
![在这里插入图片描述][2018112700540495.png]  
**3.出现下列信息，代表穿透成功，将tomcat的端口号修改为80**  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 8]  
找到tomcat的安装目录下的server.xml文件  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 9]  
**4.然后重启tomcat**  
![在这里插入图片描述][20181127005825612.png]  
地址栏访问，穿透之后提供的网址，会出现tomcat的主页  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 10]  
**5.新建springboot项目作为测试号的后台**![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 11]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 12]  
**6.新建controller包，和新建JieRuController类**

package com.springboot.test.controller;
    
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestMapping;
    
    /** * @author 小思 * @PackageName:com.springboot.test.controller * @ClassName: JieRuController * @Description: * @date 2018/11/27 9:17 */
    @Controller
    @RequestMapping("JieRu")
    public class JieRuController { 
    }

配置application.properties文件

#接入的后台项目部署的服务器的端口号必须发布在80的端口上
    server.port=80
    server.servlet.context-path=/weixin

配置weixin4j.properties文件

#微信SDK配置文件
    #读取规则：优先读取System.getProperty()
    #再从weixin4j.properties读取,key
    #如果System.getProperty()与weixin4j.properties都没设置，则默认未NULL
    
    #开发者调试设置
    weixin4j.debug=true
    #公众号Token
    weixin4j.token=weixin4j
    
    #公众号原始ID
    weixin4j.oauth.originalid=gh_da433f9665e5
    #开发者第三方用户唯一凭证
    weixin4j.oauth.appid=wx2086f4cf7d2a0274
    #开发者第三方用户唯一凭证密钥
    weixin4j.oauth.secret=57f0ea52a5fdb7a93c5babc2a452d438
    
    
    #消息加密方式 0:明文模式(默认), 1:兼容模式, 2:安全模式(推荐)
    weixin4j.oauth.encodingtype=0
    #消息加密密钥(43位字符组成A-Za-z0-9)
    weixin4j.oauth.encodingaeskey=0123456789abcedfghijklmnopqrstuvwxyzZXCVBNM
    #网页安全授权URL
    weixin4j.oauth.url=
    
    #公众平台接口域名
    #通用域名(api.weixin.qq.com)，使用该域名将访问官方指定就近的接入点；
    #上海域名(sh.api.weixin.qq.com)，使用该域名将访问上海的接入点；
    #深圳域名(sz.api.weixin.qq.com)，使用该域名将访问深圳的接入点；
    #香港域名(hk.api.weixin.qq.com)，使用该域名将访问香港的接入点。
    weixin4j.api.domain=api.weixin.qq.com
    
    #微信支付_商户ID
    weixin4j.pay.partner.id=
    #微信支付_商户密钥
    weixin4j.pay.partner.key=
    #微信支付_通知URL
    weixin4j.pay.notify_url=
    
    #连接超时设置
    weixin4j.http.connectionTimeout=25000
    #请求超时设置
    weixin4j.http.readTimeout=25000
    #证书路径
    weixin4j.http.cert.path=
    weixin4j.http.cert.secret=
    
    #默认消息处理函数
    weixin4j.handler=org.weixin4j.spi.DefaultMessageHandler
    #weixin4j.message.handler.normal=org.weixin4j.spi.DefaultNormalMessageHandler
    #weixin4j.message.handler.event=org.weixin4j.spi.DefaultEventMessageHandler

配置的时候，注意下面的信息要和测试的公众号的提供的信息保持一致，因为有很多测试公众号，你的后台必须接入到你的公众号上，这里就是做配置  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 13]  
**7.配置微信的测试号的连接信息**  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 14]  
在pom.xml引入weixin4j的依赖

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

WeixinJieruController类继承WeixinJieruController  
配置好接口信息，点击提交  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 15]

**8.然后将tomcat停止，在idea启动springboot项目**

如果显示配置成功代表微信接口接入成功！  
配置失败，就是步骤不对哦，或者配置有误

**9.微信关注页面上你的测试号，发送信息给公众号，公众号显示“你的信息已经收到！”**

常见错误：tomcat的80端口号被占用  
错误分析以及解决方法  
案例的完整代码：[https://download.csdn.net/download/zeal9s/10811316][https_download.csdn.net_download_zeal9s_10811316]  
**说在最后的话：编写实属不易，若喜欢或者对你有帮助记得点赞+关注或者收藏哦~**

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70]: /images/20220413/bc55c2a91f284d3cb1282ac140b40ab5.png
[Link 1]: https://natapp.cn/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 1]: /images/20220413/a66ac872e68e49b190b29fe2bb588958.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 2]: /images/20220413/b84cc801556d4affb7443acdb3bc5194.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 3]: /images/20220413/d2a84fce6c03454d81f52021c1bc681f.png
[20181127004436255.png]: /images/20220413/73dd9ba39121461e9722289a38d04019.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 4]: /images/20220413/df193ded8afa43db9b4092773f5ab31c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 5]: /images/20220413/4cb7b467fc0d46638aef0000b9958ed7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 6]: /images/20220413/ff67938a60d44991819bb0d00ae3227e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 7]: /images/20220413/79db627374b640a99cd9000fc9bb476e.png
[2018112700540495.png]: /images/20220413/323172f42f3a494a9feea238bece9827.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 8]: /images/20220413/b77d8782d1eb4581a158b711341fe873.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 9]: /images/20220413/02f7c29decc941b883f25275952a366d.png
[20181127005825612.png]: /images/20220413/a3f8ade352934f4f8c0b0331863db12c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 10]: /images/20220413/c0104866c93b4f4585d5dd713a53573a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 11]: /images/20220413/2842d7c6f7934e419564bc56dfce7eee.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 12]: /images/20220413/3a3571bc72c14ca7b98284310b5d25d3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 13]: /images/20220413/cb290abd1e1147829fb3f5e31df9ea34.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 14]: /images/20220413/b8e150f5bbc243a5a19a5606e5f456ea.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3plYWw5cw_size_16_color_FFFFFF_t_70 15]: /images/20220413/16f95a079f014691981f4cf92ad6aa4c.png
[https_download.csdn.net_download_zeal9s_10811316]: https://download.csdn.net/download/zeal9s/10811316