微信 Java 開發：Access Token 管理、用戶資訊獲取與模板消息主動推送完整實作

整體流程

1. 獲取 access_token（有效期 2 小時，需緩存）
2. 拉取用戶資訊（需 openid）
3. 調用客服消息/模板消息接口主動推送
4. 配置 HTTP 客戶端（連線池、HTTPS、代理、信任所有憑證）

核心工具類 WeixinAPIHelper

public class WeixinAPIHelper {
    private static final String TOKEN_URL   = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={0}&secret={1}";
    private static final String USER_URL    = "https://api.weixin.qq.com/cgi-bin/user/info?access_token={0}&openid={1}";
    private static final String SEND_URL    = "https://api.weixin.qq.com/cgi-bin/message/send?access_token={0}";

    private HttpClient httpClient;
    private Log log = LogFactory.getLog(getClass());

    // 初始化 HTTP 客戶端（連線池、SSL 忽略驗證、代理支援）
    public void initWebClient(String proxyHost, int proxyPort) { /* 見原碼 */ }

    /** 獲取 access_token */
    public String getAccessToken(String appid, String secret) {
        String url = MessageFormat.format(TOKEN_URL, appid, secret);
        String resp = executeHttpGet(url);
        return JsonUtils.read(resp, "access_token");
    }

    /** 獲取用戶資訊 */
    public WeixinOpenUser getUserInfo(String token, String openid) {
        String url = MessageFormat.format(USER_URL, token, openid);
        String resp = executeHttpGet(url);
        JsonNode json = JsonUtils.read(resp);
        if (json.get("openid") != null) {
            WeixinOpenUser u = new WeixinOpenUser();
            u.setOpenUserId(json.get("openid").asText());
            u.setState(json.get("subscribe").asText());
            if ("1".equals(u.getState())) {
                u.setUserName(json.get("nickname").asText());
                u.setSex(json.get("sex").asText());
                u.setCity(json.get("city").asText());
                u.setLanguage(json.get("language").asText());
            }
            return u;
        }
        return null;
    }

    /** 發送客服消息 */
    public String sendMessage(String token, String msgJson) {
        String url = MessageFormat.format(SEND_URL, token);
        HttpPost post = new HttpPost(url);
        post.setEntity(new StringEntity(msgJson, "UTF-8"));
        return (String) httpClient.execute(post, new BasicResponseHandler());
    }

    private String executeHttpGet(String url) throws IOException {
        return (String) httpClient.execute(new HttpGet(url), new BasicResponseHandler());
    }
}

關鍵依賴

• httpclient-4.2.3（或 4.5.x）
• jackson-2.2.1（JSON 解析）
• commons-lang（StringUtils）

消息 JSON 結構範例（文本消息）

{
  "touser": "OPENID",
  "msgtype": "text",
  "text": { "content": "Hello from Java!" }
}

生產環境關鍵強化

現代化替代：WxJava / weixin-java-tools

成熟開源 SDK，封裝 Token 管理、消息路由、事件處理、OAuth2、小程序/企業微信/開放平台全覆蓋，強烈建議新專案直接引用：

<dependency>
    <groupId>com.github.binarywang</groupId>
    <artifactId>weixin-java-mp</artifactId>
    <version>4.6.0</version>
</dependency>

1. 上一篇文章： Java 二分查找插入實作：Comparable 介面與有序集合維護
2. 下一篇文章： Java DES 加密工具類：檔案與字串加解密完整實作（CBC/PKCS5Padding）

Java 程式設計入門

實戰每夜構建（二）：構建管理服務與項目構建服務設計

構建管理服務 構建管理服務（BuildAdmin）是每夜構建

Java 文本文件讀寫完整實戰：創建、追加、讀取與資源管理最佳實踐

文本文件讀寫是 Java 基礎且高頻操作，正確處理字符編碼、

Java 進階教程：深入理解異常處理機制

程序開發過程中難免會遇到各種異常情況，無論是代碼邏輯錯誤、硬

Eclipse XML 開發利器：XMLBuddy 外掛安裝與實戰指南

認識 XMLBuddy XMLBuddy 是 Eclipse