摘要:微信憑藉龐大的用戶基數與極強的黏著度,近兩年吸引了大量開發者投入。Node.js 則是發展迅速、特別適合承載行動後台的技術選擇。本文以筆者自己的實作,說明如何以 Node.js 打造自己的微信公眾號,主要用到 express、wechat、mongodb、monk 等模組。
一、申請微信公眾號,前往 https://mp.weixin.qq.com/ 辦理。
二、準備伺服器。這裡推薦 Amazon EC2,首次使用者可選 micro instance 享一年免費,只要輸入信用卡資料即可完成申請;整個流程為英文介面,但為了免費額度,多花一點時間值得。
yum -y install gcc yum -y install gcc-c++ yum -y install make automake wget https://nodejs.org/dist/v0.10.29/node-v0.10.29.tar.gz tar -xvzf node-v0.10.29.tar.gz cd 解壓目錄 ./configure make make install
wget https://downloads.10gen.com/linux/mongodb-linux-x86_64-enterprise-amzn64-2.6.3.tgz tar -xvzf mongodb-linux-x86_64-enterprise-amzn64-2.6.3.tgz sudo cp -R -n mongodb-linux-x86_64-enterprise-amzn64-2.6.3 /usr/local/mongodb
筆者班上有支足球隊,大家把錢集中交給隊長,由他支付每次場地費並記錄每人的支出與餘額。由於不是每次都能全員到場,費用只能由參加者以 AA 方式分攤,用人工記錄頗為繁瑣。
於是筆者做了一個微信公眾號:只要輸入活動消費金額並選擇參與人數,就自動算出每人攤派金額與餘額,再把明細轉發到微信群裡,每個人都能看到。
實際架構上,這其實是一個微網站——用網頁記錄與顯示活動花費與餘額。微信公眾號扮演的是使用者與微網站之間的橋梁:當使用者關注帳號後,透過微信公眾平台的開發者模式,系統會自動回覆操作說明,其中包含對應的網址連結,點擊即可進入功能頁。
先簡述兩個關鍵模組。express 是優秀的 Web 開發框架,能快速搭建網站。由於微信伺服器會以 HTTP POST 與開發者伺服器互動,因此需要 express 來接。
以下是新使用者關注時的 log,其中 103.7.30.84 為微信伺服器的 IP:
103.7.30.84 POST /wechat?signature=8a8e408fdae6bbdd6e470af98865a5f993cea283×tamp=1408610461&nonce=1572142586 2 200
wechat 模組則封裝了與微信伺服器互動的細節,讓開發者只需專注自己的業務邏輯。
npm install -g express express -e your_project // -e 表示使用 ejs 引擎,不帶參數則預設 jade cd your_project && npm install
安裝後的目錄結構:
[ec2-user@ip-172-31-2-188 your_project]$ ls app.js bin node_modules package.json public routes views
接著安裝 wechat:
npm install wechat
在公眾平台後台填寫 URL 與 token:

修改 app.js:
app.use('/users', users);
app.use('/weixin', weixin);
app.use(express.query());
app.use('/wechat', wechat('hchismylove', function (req, res, next) {
// 微信傳入的訊息都在 req.weixin 上
var message = req.weixin;
console.log(message);
if ((message.MsgType == 'event') && (message.Event == 'subscribe')) {
var refillStr = "<a href=\"https://your_IP/weixin/refill?weixinId=" + message.FromUserName + "\">1. 點擊記錄團隊充值</a>";
var consumeStr = "<a href=\"https://your_IP/weixin/consume?weixinId=" + message.FromUserName + "\">2. 點擊記錄團隊消費</a>";
var deleteStr = "<a href=\"https://your_IP/weixin/delete?weixinId=" + message.FromUserName + "\">3. 點擊回退記錄</a>";
var historyStr = "<a href=\"https://your_IP/weixin/history?weixinId=" + message.FromUserName + "\">4. 點擊查詢歷史記錄</a>";
var emptyStr = " ";
var replyStr = "感謝你的關注!" + "\n" + emptyStr + "\n" + refillStr + "\n" + emptyStr + "\n" + consumeStr
+ "\n" + emptyStr + "\n" + deleteStr + "\n" + emptyStr + "\n" + historyStr;
res.reply(replyStr);
}
}));
其中 app.use('/wechat', wechat('your_token', ...)) 這一行就完成了微信伺服器的接入認證。
而判斷 MsgType == 'event' && Event == 'subscribe' 的區塊,實現了新使用者關注時自動發送操作說明:

上述程式碼是幾年前的寫法,今日重做時有幾處必須調整。首先是 express 4 已移除內建的 express.query() 中介層,改用 router 與 express-session 等機制;Node 版本也應選用長期支援版。
其次是安全性:your_token 不應硬編碼在程式碼中,應從環境變數讀取;回覆內容中直接嵌入 FromUserName 也建議先做驗證。此外,微信伺服器要求回應必須在五秒內完成,若後端處理較慢,正確做法是先回覆佔位訊息,再用客服訊息接口補推結果,避免因超時導致重複推送。