springboot对接微信小程序,发送订阅消息

在Spring Boot中对接微信小程序发送订阅消息,需要通过微信服务端API实现。以下是完整的实现步骤和代码示例:

1. 准备工作

  1. 在小程序后台申请订阅消息模板,获取模板ID
  2. 确保小程序已获取用户订阅授权(需用户主动触发)
  3. 获取小程序的AppID和AppSecret

2. 配置参数(application.yml)

perl 复制代码
wechat:
  miniapp:
    appid: 你的小程序AppID
    secret: 你的小程序AppSecret
    subscribe-msg-url: https://api.weixin.qq.com/cgi-bin/message/subscribe/send
    access-token-url: https://api.weixin.qq.com/cgi-bin/token

3. 配置类

less 复制代码
@Data
@Configuration
@ConfigurationProperties(prefix = "wechat.miniapp")
public class WechatMiniConfig {
    private String appid;
    private String secret;
    private String subscribeMsgUrl;
    private String accessTokenUrl;
}

4. AccessToken管理(带缓存)

arduino 复制代码
@Component
public class WechatTokenManager {
    private static final Logger logger = LoggerFactory.getLogger(WechatTokenManager.class);
    
    @Autowired
    private WechatMiniConfig config;
    @Autowired
    private RedisTemplate<String, String> redisTemplate;

    private static final String ACCESS_TOKEN_KEY = "wechat:miniapp:access_token";

    public String getAccessToken() {
        String token = redisTemplate.opsForValue().get(ACCESS_TOKEN_KEY);
        if (StringUtils.isNotBlank(token)) {
            return token;
        }
        return refreshAccessToken();
    }

    private synchronized String refreshAccessToken() {
        // 防止并发刷新
        String url = config.getAccessTokenUrl() + "?grant_type=client_credential" +
                "&appid=" + config.getAppid() +
                "&secret=" + config.getSecret();

        try {
            RestTemplate restTemplate = new RestTemplate();
            String response = restTemplate.getForObject(url, String.class);
            JsonObject json = JsonParser.parseString(response).getAsJsonObject();
            
            if (json.has("errcode")) {
                logger.error("获取AccessToken失败:{}", response);
                throw new RuntimeException("微信接口调用失败");
            }
            
            String newToken = json.get("access_token").getAsString();
            int expiresIn = json.get("expires_in").getAsInt();
            
            redisTemplate.opsForValue().set(
                ACCESS_TOKEN_KEY, 
                newToken, 
                expiresIn - 200,  // 提前200秒过期
                TimeUnit.SECONDS
            );
            
            return newToken;
        } catch (Exception e) {
            logger.error("刷新AccessToken异常", e);
            throw new RuntimeException("微信服务不可用");
        }
    }
}

5. 订阅消息发送服务

typescript 复制代码
@Service
public class SubscribeMessageService {
    
    @Autowired
    private WechatTokenManager tokenManager;
    @Autowired
    private WechatMiniConfig config;

    public void sendSubscribeMessage(String openid, String templateId, 
                                    Map<String, Object> data) {
        String accessToken = tokenManager.getAccessToken();
        String url = config.getSubscribeMsgUrl() + "?access_token=" + accessToken;

        Map<String, Object> params = new HashMap<>();
        params.put("touser", openid);
        params.put("template_id", templateId);
        params.put("data", buildMessageData(data));
        params.put("page", "pages/index/index"); // 可选跳转页面

        try {
            RestTemplate restTemplate = new RestTemplate();
            HttpHeaders headers = new HttpHeaders();
            headers.setContentType(MediaType.APPLICATION_JSON);
            
            HttpEntity<Map<String, Object>> request = 
                new HttpEntity<>(params, headers);
            
            ResponseEntity<String> response = restTemplate.postForEntity(
                url, request, String.class);
            
            handleResponse(response.getBody());
        } catch (Exception e) {
            throw new RuntimeException("消息发送失败", e);
        }
    }

    private Map<String, Map<String, String>> buildMessageData(Map<String, Object> data) {
        Map<String, Map<String, String>> result = new HashMap<>();
        data.forEach((key, value) -> {
            result.put(key, Collections.singletonMap("value", value.toString()));
        });
        return result;
    }

    private void handleResponse(String responseBody) {
        JsonObject json = JsonParser.parseString(responseBody).getAsJsonObject();
        int errcode = json.get("errcode").getAsInt();
        
        if (errcode != 0) {
            String errmsg = json.get("errmsg").getAsString();
            throw new RuntimeException("微信接口错误[" + errcode + "]:" + errmsg);
        }
    }
}

6. 控制器示例

less 复制代码
@RestController
@RequestMapping("/api/msg")
public class MessageController {

    @Autowired
    private SubscribeMessageService messageService;

    @PostMapping("/send")
    public ResponseEntity<?> sendMessage(@RequestBody MessageRequest request) {
        Map<String, Object> data = new HashMap<>();
        data.put("thing1", new HashMap<String, String>(){{ put("value", "订单状态更新"); }});
        data.put("time2", new HashMap<String, String>(){{ put("value", LocalDateTime.now().format(DateTimeFormatter.ISO_DATE_TIME)); }});
        
        messageService.sendSubscribeMessage(
            request.getOpenid(),
            "你的模板ID",
            data
        );
        
        return ResponseEntity.ok().build();
    }
}

7. 消息请求DTO

kotlin 复制代码
@Data
public class MessageRequest {
    @NotBlank
    private String openid;
    // 其他业务参数...
}

8. 注意事项

  1. 模板参数格式:

    • 必须严格按照模板要求的参数格式发送
    • 每个参数值需要用 {"value": "内容"} 格式包裹
    • 参数值长度需符合模板限制
  2. AccessToken管理:

    • 必须缓存access_token,每天获取次数有限(2000次/天)
    • 推荐使用Redis缓存,设置合理过期时间
  3. 用户授权:

    • 需要用户主动订阅消息(前端需调用wx.requestSubscribeMessage)
    • 每个模板的授权是独立的
  4. 错误处理:

    • 40001:access_token无效,需要重新获取
    • 43101:用户拒绝接受消息
    • 47003:模板参数不准确
  5. 性能优化:

    • 使用连接池(推荐使用OkHttp或Apache HttpClient)
    • 异步发送非关键性消息

9. 完整调用流程

  1. 小程序端获取用户openid
  2. 用户触发订阅授权(前端调用wx.requestSubscribeMessage)
  3. 服务端接收发送请求
  4. 构造符合模板规范的消息内容
  5. 调用微信消息接口发送

10. 最佳实践建议

  1. 消息去重:对相同内容的消息添加业务去重机制
  2. 发送频率控制:避免对用户造成骚扰
  3. 模板版本管理:当模板修改时做好版本兼容
  4. 日志记录:记录消息发送日志以便排查问题
  5. 监控报警:对发送失败的情况建立监控机制

完整实现时建议配合使用:

  • Spring Boot Actuator 进行健康监控
  • Swagger 生成API文档
  • Spring Cache 优化Token缓存
  • Hibernate Validator 进行参数校验

以上方案已包含微信订阅消息的核心实现逻辑,可根据具体业务需求扩展消息模板管理、发送记录追踪等功能。

相关推荐
陈拉斯2 天前
无后端的人格测试小程序:当「数据不出设备」变成架构约束,我学到了什么
微信小程序
李纲明2 天前
微信小程序开了 Skyline 后样式全乱、滚动对不上甚至部分组件不能用?Skyline 怎么接才稳
javascript·微信小程序·小程序·devdiy
李纲明2 天前
微信小程序等位大桌被小桌占掉或过号回来就闹:先核桌型分队与过号容忍次数,再查门口屏与推送同源
微信小程序·devdiy·等位排队·桌型分队·过号重排·门口屏·推送同源
李纲明2 天前
微信小程序团课临开课才取消或空位没人补:先核取消时限与自动释放,再查候补确认与预扣回滚
微信小程序·devdiy·团课预约·取消时限·空位释放·候补确认·预扣回滚
用户034187671383 天前
用秒哒做了个拍照识餐小程序,上线两周踩的 4 个坑
微信小程序
李纲明3 天前
微信小程序租赁归还说本来就坏或配件对不上:先核借还点验与随单存证,再查差异计价公示
微信小程序·devdiy·租赁点验·借还拍照·随单存证·差异计价·押金释放
李纲明4 天前
微信小程序次卡跨店对不上账或前台随手改余次:先核流水只增不改与统一日切,再查冲正权限与总部只读
微信小程序·devdiy·核销流水·跨店次卡·日切对账·冲正权限·总部只读
李纲明4 天前
微信小程序维修拆机后口头加价或未确认就开工:先核验机快照与报价确认,再查补充报价与取机核验
微信小程序·devdiy·维修验机·报价确认·报价快照·补充报价·取机核验
wx1qq1com4 天前
一桩带几台车:共享租赁桩位配比、取电与结算闭环设计
物联网·微信小程序·小程序
李纲明4 天前
微信小程序场地长租月底对不上或口头占场撞场:先核合约预约与核销流水出账,再查附加费与转租归属
微信小程序·devdiy·场地长租·月结账单·核销流水·附加费·转租归属