微信小程序开发最基础的功能就是用户的认证过程,在使用springcloud微服务架构进行开发时为了简化开发周期,我们参考Wafer的架构,实现了java版本的会话服务器,由于目前wafer1官方已经停止更新,Wafer2服务器端完全托管在腾讯云,不对外公开会话服务器的实现,因此我们开发了wxss-spring-boot-starter项目,项目实现的会话服务器接口参考了Wafer2的小程序客户端wafer2-client-sdk的代码,目前与其完全兼容(仅登录接口)。
项目地址:
使用方法目前只支持SpringBoot2.0以上版本。
在您的springboot项目中引入本项目依赖,然后增加相应功能注解和配置即可。
maven:
dependencygroupIdcom.venusource.ms.base/groupIdartifactIdwxss-spring-boot-starter/artifactIdversion1.0.0/version/dependency
gradle:
compile('com.venusource.ms.base:wxss-spring-boot-starter:1.0.0')
会话服务器实现参考php版本wafer-session-server,使用前请详细阅读。在SpringBoot的入口类中加入@EnableWeChatSessionServer注解即可。如下所示:
packagecom.venusource.ms.base.wxssdemo;importorg.springframework.boot.SpringApplication;importorg.springframework.boot.autoconfigure.SpringBootApplication;importcom.venusource.ms.base.wxss.EnableWeChatSessionServer;@SpringBootApplication@EnableWeChatSessionServer//启用会话服务器publicclassWxssSpringBootStarterDemoApplication{publicstaticvoidmain(String[]args){SpringApplication.run(WxssSpringBootStarterDemoApplication.class,args);}}
在spring的配置文件application.properties中配置小程序的appid和secret,如下所示:
weixin.app.appid=yourappidweixin.app.secret=yoursecret
启动服务后,会自动在服务内对外暴露/mina_auth会话服务接口。
接口与php版本完全相同,见wafer-session-server。
注:会话服务会和微信的服务器进行通信,获取session_key,需要能访问外网,同时为了安全性会话服务一般只对内部服务提供服务,不对外暴露接口,因此如果使用SpringCloud的服务网关,需要把它忽略。
Session数据的存储
默认情况下,所有的用户数据存储在内存内(不推荐),您需要实现如下接口来存储自己的数据:
packagecom.venusource.ms.base.wxss.service;importcom.venusource.ms.base.wxss.domain.CSessionInfo;publicinterfaceSessionInfoStoreService{CSessionInfoadd(CSessionInfosessionInfo);voidremove(CSessionInfosessionInfo);CSessionInfoupdate(CSessionInfosessionInfo);CSessionInfoget(Stringskey);}在实现类内注解@Service即可,系统会自动替换session存储类型。
登录入口登录入口是为wafer2客户端提供的用户授权登录地址,您可以自己基于上面的会话服务器单独开发,也可以在服务内增加注解@EnableWeChatWaferLoginEndpoint,自动提供登录入口/login,如下所示:
packagecom.venusource.ms.base.wxssdemo;importorg.springframework.boot.SpringApplication;importorg.springframework.boot.autoconfigure.SpringBootApplication;importcom.venusource.ms.base.wxss.EnableWeChatWaferLoginEndpoint;@SpringBootApplication@EnableWeChatWaferLoginEndpoint//启用wafer2登录入口publicclassWxssSpringBootStarterDemoApplication{publicstaticvoidmain(String[]args){SpringApplication.run(WxssSpringBootStarterDemoApplication.class,args);}}
在spring的配置文件application.properties中配置会话服务器地址,如下所示:
weixin.wafer.authServerUrl=http://ms-session-server/mina_auth/
ms-session-server为在Eureka中注册的服务名,因为我们使用ribbon作客户端负载,可以部署多个ms-session-server服务。
业务服务用户信息
基于SpringCloud微服务架构开发时,业务服务需要获取用户信息时,starter可提供自动的参数注入功能,只需要在业务服务内增加注解@EnableWeChatUserInfoArgumentInjection即可,如下所示:
packagecom.venusource.app.oa.microserviceprovideruser;importorg.springframework.boot.SpringApplication;importorg.springframework.boot.autoconfigure.SpringBootApplication;importorg.springframework.cloud.client.discovery.EnableDiscoveryClient;importcom.venusource.ms.base.wxss.EnableWeChatUserInfoArgumentInjection;@SpringBootApplication@EnableDiscoveryClient@EnableWeChatUserInfoArgumentInjection//启用微信用户信息注入。publicclassMicroserviceProviderUserApplication{publicstaticvoidmain(String[]args){SpringApplication.run(MicroserviceProviderUserApplication.class,args);}}
在spring的配置文件application.properties中配置会话服务器地址,如下所示:
weixin.wafer.authServerUrl=http://ms-session-server/mina_auth/
ms-session-server为在Eureka中注册的服务名,因为我们使用ribbon作客户端负载,可以部署多个ms-session-server服务。
在controller的方法参数中,会自动注入UserInfo类,可以直接获取登录用户的信息,如下所示:
@GetMapping("/product/{id}")publicProductshowInfo(@PathParamLongid,UserInfouserInfo){Stringuid=userInfo.getOpenId();...}项目目前代码还很丑陋,测试还不全面,如您在使用中发现问题,请及时告诉我们,或直接pullrequest。
作者:cjzhao链接:著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。
最新资讯
-

小程序制作平台选型踩坑记录:2026年五大主流方案横向对比
2026 年微信小程序月活达 10.7 亿、覆盖 108 个行业,本次横向对比即速应用、乔拓云、凡科、有赞、微盟五大主流平台,分三阶段给出选型结论,核心聚焦成本、扩展性、运营能力三大维度。 -

即速应用,赋能企业玩转微信小程序智慧经营
作为国内领军的智慧商业经营服务商,即速应用始终秉承“让每个企业都拥有自己的智慧店铺”的愿景,持续赋能更多企业玩转智慧经营。即速应用旗下拥有“小程序搭建工具-即速应用”、“私域流量专家-即客云”等产品,帮助商家打通互联网全生态营销闭环。 -

即客云2.0重磅更新,让微信小程序运营更简单!
即客云作为一款基于企业微信的第三方工具,现从多维度提供超过30种功能,自上线以来,已服务多家企业,受到一致好评。近期,我们根据客户反馈和市场调研正式推出升级版 即客云2.0!更新了私域运营SOP,群日历功能,批量拓客,客户雷达,消息推送,个人欢迎语,帮助企业更好运用企业微信;同时提升了社群运营工作标准化,提升运营效率,帮助企业实现客户增长,玩转私域流量。










