SpringBoot+微信模板消息：每日暖心问候与天气预报自动化实现

一、项目背景与需求分析

在数字化时代，如何通过技术手段传递情感关怀成为开发者关注的焦点。本项目源于一个温馨的诉求：通过自动化技术每日向女友发送包含早安问候与天气预报的微信消息，既体现技术浪漫，又解决日常提醒的实际需求。

核心需求：

定时触发：每日固定时间（如7:00）自动执行发送任务。
内容个性化：问候语需包含动态元素（如日期、天气），避免重复。
稳定性要求：需处理微信接口调用限制、异常重试等边界情况。

二、技术选型与架构设计

1. 技术栈选择

后端框架：SpringBoot 2.7（快速开发、内置依赖管理）。
定时任务：Spring Task（轻量级定时调度，适合简单场景）。
HTTP客户端：OkHttp（高效、支持连接池）。
模板引擎：Thymeleaf（可选，用于生成动态HTML内容）。
天气API：和风天气/心知天气（提供免费接口，支持城市天气查询）。

2. 系统架构

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  定时任务   │ →  │  业务逻辑   │ →  │  微信接口   │
│ (SpringTask)│    │ (组装消息)  │    │ (发送模板)  │
└─────────────┘    └─────────────┘    └─────────────┘
        ↑                                     ↓
┌───────────────────────────────────────────┐
│           天气API（异步获取数据）           │
└───────────────────────────────────────────┘

三、核心功能实现步骤

1. 微信模板消息配置

步骤1：申请模板ID

登录微信公众平台，进入「模板消息」模块。

选择或自定义模板，示例模板内容：

{{first.DATA}}
日期：{{date.DATA}}
天气：{{weather.DATA}}
温度：{{temperature.DATA}}
{{remark.DATA}}

步骤2：获取Access Token

调用微信接口获取全局Access Token（有效期2小时，需缓存）：

public String getAccessToken(String appId, String appSecret) {
    String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" 
        + appId + "&secret=" + appSecret;
    // 使用OkHttp发送GET请求
    Response response = client.newCall(new Request.Builder().url(url).build()).execute();
    JSONObject json = new JSONObject(response.body().string());
    return json.getString("access_token");
}

2. 天气数据获取

调用第三方天气API（以和风天气为例）：

public WeatherData getWeather(String cityKey) {
    String url = "https://devapi.qweather.com/v7/weather/now?key=YOUR_KEY&location=" + cityKey;
    Response response = client.newCall(new Request.Builder().url(url).build()).execute();
    return new Gson().fromJson(response.body().string(), WeatherData.class);
}

3. 消息组装与发送

动态填充模板参数：

public void sendDailyMessage(String openId, String accessToken) {
    // 获取天气数据
    WeatherData weather = getWeather("BEIJING");
    // 组装模板参数
    Map<String, Map<String, String>> data = new HashMap<>();
    data.put("first", Map.of("value", "早安，亲爱的！"));
    data.put("date", Map.of("value", LocalDate.now().toString()));
    data.put("weather", Map.of("value", weather.getNow().getText()));
    data.put("temperature", Map.of("value", weather.getNow().getTemp() + "℃"));
    data.put("remark", Map.of("value", "今天也要开心哦~"));
    // 调用微信发送接口
    String url = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=" + accessToken;
    JSONObject request = new JSONObject();
    request.put("touser", openId);
    request.put("template_id", "YOUR_TEMPLATE_ID");
    request.put("data", data);
    Response response = client.newCall(new Request.Builder()
        .url(url)
        .post(RequestBody.create(request.toString(), MediaType.parse("application/json")))
        .build()).execute();
    // 处理响应结果
    if (response.code() != 200) {
        throw new RuntimeException("发送失败: " + response.body().string());
    }
}

4. 定时任务配置

使用Spring Task的@Scheduled注解：

@Component
public class DailyTask {
    @Autowired
    private WeChatService weChatService;
    @Scheduled(cron = "0 0 7 * * ?") // 每日7:00执行
    public void sendMorningMessage() {
        String accessToken = weChatService.getAccessToken();
        weChatService.sendDailyMessage("女友的OPENID", accessToken);
    }
}

四、关键问题与解决方案

1. 微信接口调用频率限制

问题：微信模板消息接口有调用频率限制（如每分钟100次）。
解决方案：
- 缓存Access Token，避免频繁获取。
- 添加重试机制（如指数退避算法）。

2. 天气API稳定性

问题：第三方天气API可能不可用或返回错误数据。
解决方案：
- 配置备用天气API（如心知天气）。
- 添加本地缓存，避免重复请求。

3. 定时任务并发问题

问题：多实例部署时可能导致重复发送。
解决方案：
- 使用分布式锁（如Redis锁）。
- 或通过数据库标记发送状态。

五、项目部署与优化建议

环境配置：
- 使用application.yml管理配置（如微信AppID、天气API Key）。
- 示例配置：
```
wechat:
  app-id: your_app_id
  app-secret: your_app_secret
weather:
  api-key: your_weather_key
```
日志与监控：
- 添加SLF4J日志记录发送结果。
- 集成Prometheus监控接口调用成功率。
扩展性设计：
- 将消息内容抽象为配置文件，支持多模板切换。
- 添加用户管理功能，支持同时向多人发送。

六、总结与启示

本项目通过SpringBoot与微信模板消息的整合，实现了情感关怀的自动化，其核心价值在于：

技术浪漫：将编程能力转化为生活仪式感。
可复用性：代码结构清晰，可扩展为生日提醒、纪念日通知等场景。
学习价值：覆盖了HTTP调用、定时任务、第三方API集成等常见开发场景。

读者启发：

开发者可基于此项目扩展企业级应用（如客户关怀系统）。
非技术用户可通过低代码平台（如钉钉宜搭）实现类似功能。
强调技术应服务于生活，而非被工具束缚。

（全文约1500字，代码示例与架构图可根据实际需求进一步细化。）