Java 微信開發入門：消息接收與自動回覆核心技術

開發環境與文檔基準

• 基於微信官方文檔（2016-04-03 版本）
• 技術棧：MyEclipse 10.7 + JDK 1.7 + Tomcat 7.0 + Servlet 3.0 註解配置
• 部署環境：阿里雲 Windows Server 2008 64位

消息管理模塊解析

微信消息管理包含接收普通消息/事件推送、發送被動回覆/客服/群發/模板消息、獲取自動回覆配置等接口。核心交互模式：用戶發消息 → 微信服務器 POST XML 到開發者 URL → 開發者解析處理 → 響應 XML 給微信服務器 → 轉發給用戶。

消息接收與解析

核心流程

1. 獲取 request.getInputStream() 讀取原始 XML 流
2. 使用 Dom4j SAXReader 解析 XML 文檔
3. 遍歷根元素子節點，構建 Map<String, String> 鍵值對
4. 提取 ToUserName、FromUserName、CreateTime、MsgType、Content、MsgId 等關鍵字段

InputStream is = req.getInputStream();
SAXReader reader = new SAXReader();
Document document = reader.read(is);
Element root = document.getRootElement();
List<Element> elementList = root.elements();
Map<String, String> map = new HashMap<>();
for (Element e : elementList) {
    map.put(e.getName(), e.getText());
}

被動回覆消息實現

文本消息回覆

構建 TextMsg Bean，設置 ToUserName/FromUserName 互換、CreateTime、MsgType="text"、Content。使用 XStream 別名映射轉換為 XML：xStream.alias("xml", TextMsg.class)。

圖文消息回覆

構建 PicAndTextMsg 包含 Article 列表，每個 Article 含 Title、Description、PicUrl、Url。MsgType="news"，ArticleCount 設置列表大小。XStream 需額外別名：xStream.alias("item", Article.class) 確保生成符合規範的 <item> 節點。

List<Article> articles = new ArrayList<>();
Article a = new Article();
a.setTitle("圖文標題");
a.setDescription("描述內容");
a.setPicUrl("有效圖片URL");
a.setUrl("點擊跳轉鏈接");
articles.add(a);

PicAndTextMsg msg = new PicAndTextMsg();
msg.setArticles(articles);
msg.setArticleCount(1);
// ... 設置公共字段
String xml = xStream.toXML(msg);
resp.getWriter().print(xml);

服務器驗證與 Servlet 完整實現

GET 請求驗證流程

1. 獲取 signature、timestamp、nonce、echostr 參數
2. token + timestamp + nonce 字典序排序拼接
3. SHA1 加密生成簽名
4. 比對簽名一致則原樣返回 echostr，驗證通過

CoreServlet 完整代碼結構

• doGet()：服務器接入驗證
• doPost()：消息接收解析 + 自動回覆（文本/圖文）
• 統一字符編碼 UTF-8，異常捕獲保證穩定性
• 依賴第三方庫：dom4j (XML解析)、xstream (Bean↔XML)

實體類設計規範

• TextMsg：ToUserName、FromUserName、CreateTime (long)、MsgType、Content
• Article：Title、Description、PicUrl、Url
• PicAndTextMsg：繼承公共字段 + ArticleCount + List<Article> Articles
• 所有類提供無參構造器、Getter/Setter、toString() 便於調試

最佳實踐與避坑指南

1. 輸入流只能讀取一次，解析前勿重複消費
2. XML 節點名稱區分大小寫，需與文檔嚴格一致
3. 圖片/鏈接 URL 必須可公開訪問，建議使用 HTTPS
4. 開發階段建議記錄完整請求/響應 XML 便於排查
5. 生產環境需添加消息加解密（文檔「發送消息-被動回覆時的加解密」章節）