Java案例如何实现企业微信通知？

wen python案例 2026-07-21 2

Java案例如何实现企业微信通知？从API集成到生产级部署全指南

目录导读

企业微信通知的核心价值与适用场景
前置准备：企业微信应用配置与权限获取
Java实现企业微信通知的三种主流方案
实战案例：基于RestTemplate的文本消息推送
高级功能：Markdown消息、文件上传与@提及
常见问题与避坑指南（附问答）
生产环境优化：重试机制、限流与日志监控
总结与最佳实践建议

企业微信通知的核心价值与适用场景

企业微信通知已成为企业内部系统（如运维告警、订单提醒、审批流转）与外部服务联动的重要桥梁，通过Java实现企业微信通知，开发者可以快速构建自动化消息推送能力，替代传统邮件或短信，实现实时触达。

Java案例如何实现企业微信通知？

典型场景包括：

系统异常告警（如服务器宕机、接口超时）
业务数据变更通知（如订单状态更新、任务分配）
定时报表或统计结果推送
用户行为触发消息（如新用户注册欢迎语）

前置准备：企业微信应用配置与权限获取

在写代码前,需完成以下企业微信后台配置：

创建自建应用：登录企业微信管理后台 → 应用管理 → 自建 → 创建应用。
获取重要参数：
- CorpID：企业唯一ID（在“我的企业”页面查看）。
- AgentId 和 Secret：在创建的应用详情页获取。
设置回调域名与IP白名单：若需接收回调或使用通讯录权限，需配置可信域名和服务端IP。
获取Access Token：企业微信API使用Token鉴权，需通过https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET获取（有效期7200秒）。

注意：Token必须缓存并定期刷新，避免频繁请求导致频率限制。

Java实现企业微信通知的三种主流方案

方案	描述	适用场景
原生HttpClient	手动构造HTTP请求，无第三方依赖	轻量单次通知，无需复杂封装
Spring RestTemplate	利用Spring生态的HTTP工具，简洁易用	多数Spring Boot项目
企业微信Java SDK	开源封装（如WxJava），提供完整API对象化调用	需要复杂消息类型或多租户管理

推荐：生产环境优先选择Spring RestTemplate或WxJava SDK，前者轻量可控，后者功能全面。

实战案例：基于RestTemplate的文本消息推送

以下是一个完整的Java代码示例,实现向企业微信指定用户发送文本通知。

1 依赖引入（Maven）

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

2 核心实现类

@Service
public class WeChatNoticeService {
    @Value("${wechat.corpid}")
    private String corpid;
    @Value("${wechat.corpsecret}")
    private String corpsecret;
    @Value("${wechat.agentid}")
    private String agentid;
    @Autowired
    private RestTemplate restTemplate;
    // 获取并缓存Token（简化版，生产需用Redis）
    private String getAccessToken() {
        String url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=" 
                   + corpid + "&corpsecret=" + corpsecret;
        JSONObject json = restTemplate.getForObject(url, JSONObject.class);
        return json.getString("access_token");
    }
    // 发送文本消息
    public boolean sendTextMessage(String toUser, String content) {
        String token = getAccessToken();
        String url = "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=" + token;
        JSONObject message = new JSONObject();
        message.put("touser", toUser);           // 用户ID，支持多个用|分隔
        message.put("msgtype", "text");
        message.put("agentid", agentid);
        JSONObject text = new JSONObject();
        text.put("content", content);
        message.put("text", text);
        JSONObject response = restTemplate.postForObject(url, message, JSONObject.class);
        return response.getIntValue("errcode") == 0;
    }
}

3 调用示例

weChatNoticeService.sendTextMessage("zhangsan|lisi", "【告警】服务器CPU使用率超过90%，请处理！");

高级功能：Markdown消息、文件上传与@提及

企业微信支持多种消息类型,以下是Markdown消息的实现示例：

1 发送Markdown消息

public boolean sendMarkdownMessage(String toUser, String markdownContent) {
    String token = getAccessToken();
    String url = "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=" + token;
    JSONObject msg = new JSONObject();
    msg.put("touser", toUser);
    msg.put("msgtype", "markdown");
    msg.put("agentid", agentid);
    JSONObject markdown = new JSONObject();
    markdown.put("content", markdownContent);
    msg.put("markdown", markdown);
    JSONObject resp = restTemplate.postForObject(url, msg, JSONObject.class);
    return resp.getIntValue("errcode") == 0;
}

支持格式示例：

> CPU: 95%  ❌
> 内存: 72%

2 文件上传与发送

需先调用media/upload接口获得media_id，再通过消息推送接口发送，文件大小限制为20MB，图片建议压缩后上传。

3 @指定用户中加入`@userid`即可，但需在消息模板中预置占位符，企业微信客户端才能解析。

常见问题与避坑指南（附问答）

Q1：发送消息后返回错误码81013（openid错误）

原因：接收用户的ID格式不正确，应使用企业微信的userid（如zhangsan），而非微信号或手机号。解决：从通讯录管理中获取正确的userid，或调用user/list接口同步。

Q2：如何避免Token过期？

方法：将Access Token存入Redis，设置7000秒过期，并使用定时任务提前5分钟自动刷新，代码中可使用@Scheduled注解实现。

Q3：发送消息频繁被限流（45009）

规则：企业微信对每个应用有60次/分钟的消息发送频率限制，若需批量推送，建议延迟发送或合并消息（如将多个通知拼接为一条消息发送给群聊）。

Q4：生产环境下如何确保消息可靠投递？

方案：引入消息队列（如RabbitMQ） + 失败重试机制，将待发送消息写入数据库，由后台worker消费，发送失败后自动重试3次，并记录失败日志。

生产环境优化：重试机制、限流与日志监控

1 重试机制（Spring Retry）

@Retryable(value = {HttpServerErrorException.class}, maxAttempts = 3, backoff = @Backoff(delay = 2000))
public boolean sendMessageWithRetry(String toUser, String content) {
    // 调用上述sendTextMessage
    return sendTextMessage(toUser, content);
}