在实际业务场景中,需要一个后台同时支持多个微信小程序的登录。例如,企业有多个不同业务的小程序,但希望统一在同一个后台系统里进行用户认证和数据处理。这时候,我们就需要一个灵活的方式来管理多个小程序的 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: wxxxxxxxxxxxxxxxxxxsecret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx- appid: wyyyyyyyyyyyyyyyyyysecret: yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
三、属性类
定义配置属性类,读取配置文件中多个小程序的信息:
@Data
@Component
@ConfigurationProperties(prefix = "wx.miniapp")
public class WxMiniAppProperties {private List<Config> configs;@Datapublic 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
。