SpringBoot 实现支持多个微信小程序的登录
在实际业务场景中,需要一个后台同时支持多个微信小程序的登录。例如,企业有多个不同业务的小程序,但希望统一在同一个后台系统里进行用户认证和数据处理。这时候,我们就需要一个灵活的方式来管理多个小程序的 appid 和 secret,并根据前端传递的 appid 与 code 获取对应的 openid 实现登录。
本文将基于 weixin-java-miniapp SDK 实现一个通用的多小程序登录模块。
一、依赖引入
在 pom.xml 中加入微信小程序 SDK 依赖:
<dependency> <groupId>com.github.binarywang</groupId> <artifactId>weixin-java-miniapp</artifactId> <version>4.7.7-20250808.182223</version> </dependency>
二、配置文件
通过 application.yml 配置多个小程序的 appid 与 secret,提供给后续动态获取。
wx: miniapp: configs: - appid: wxxxxxxxxxxxxxxxxxx secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx - appid: wyyyyyyyyyyyyyyyyyy secret: yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
三、属性类
定义配置属性类,读取配置文件中多个小程序的信息:
@Data @Component @ConfigurationProperties(prefix = "wx.miniapp") public class WxMiniAppProperties { private List<Config> configs; @Data public static class Config { private String appid; private String secret; } }
这样就能自动绑定 application.yml 中的配置到 WxMiniAppProperties。
四、服务工厂类
编写一个工厂类 WxMiniAppServiceFactory,用来存储和获取 WxMaService 实例。 每个小程序对应一个 WxMaService,通过 appid 来区分。
后台可以根据传入的 appid 动态选择对应的 WxMaService。
@Component public class WxMiniAppServiceFactory { private final Map<String, WxMaService> services = new HashMap<>(); public WxMiniAppServiceFactory(WxMiniAppProperties properties) { for (WxMiniAppProperties.Config config : properties.getConfigs()) { WxMaDefaultConfigImpl wxConfig = new WxMaDefaultConfigImpl(); wxConfig.setAppid(config.getAppid()); wxConfig.setSecret(config.getSecret()); WxMaService wxService = new WxMaServiceImpl(); wxService.setWxMaConfig(wxConfig); services.put(config.getAppid(), wxService); } } public WxMaService getWxMaService(String appid) { WxMaService service = services.get(appid); if (service == null) { throw new IllegalArgumentException("未找到对应appid的配置: " + appid); } return service; } }
五、登录逻辑
定义登录服务,根据前端传递的 appid 与 code 获取用户 openid:
@Service public class WxMiniAppLoginService { private final WxMiniAppServiceFactory serviceFactory; public WxMiniAppLoginService(WxMiniAppServiceFactory serviceFactory) { this.serviceFactory = serviceFactory; } public String getOpenId(String appid, String code) throws Exception { WxMaService wxService = serviceFactory.getWxMaService(appid); WxMaJscode2SessionResult session = wxService.jsCode2SessionInfo(code); return session.getOpenid(); } }
调用时,只需要传入 appid 和前端 wx.login 获取的 code,就能拿到用户的唯一标识 openid。
更多推荐



所有评论(0)