ThinkPHP 微信開發：安全模式消息加解密失敗排查與修復

在使用 ThinkPHP 官方 WeChat 包進行微信公眾號開發時，普通模式正常，但啟用「安全模式」（加密模式）後消息解密失敗。經排查，官方解密類 WechatCrypt 返回的 XML 字串包含轉義字符（<\/tag>\n），導致 simplexml_load_string() 解析失敗。本文記錄根因分析與修復方案。

問題現象

• 普通模式（明文傳輸）：simplexml_load_string() 正常解析 XML。
• 安全模式（AES 加密）：解密後調用 simplexml_load_string() 返回 false，無錯誤提示。
• 對比官方示例 WechatCrypt.class.php，邏輯一致，唯獨輸出 XML 格式異常。

根因分析

在 WechatCrypt::decrypt() 方法中，經過 Base64 解碼、AES-CBC 解密、PKCS7 去填充、去隨機串、驗證 AppId 後，直接返回 $text。實際輸出內容如下：

<xml>
<ToUserName><![CDATA[gh_249aeb986d99]]><\/ToUserName>\n
<FromUserName><![CDATA[oopVmxHZaeQkDPsRcbpwXKkH-J2Q]]><\/FromUserName>\n
<CreateTime>1448944621<\/CreateTime>\n
<MsgType><![CDATA[text]]><\/MsgType>\n
<Content><![CDATA[\u7ecf\u7406]]><\/Content>\n
<MsgId>6223169761311044588<\/MsgId>\n
<\/xml>

關鍵異常點：

1. 標籤結束符被轉義：<\/tag> 而非標準 </tag>。
2. 每行結尾包含字面換行符 \n（兩字符），而非真正換行。

simplexml_load_string() 無法識別 <\/tag> 為合法結束標籤，導致解析失敗。

修復方案：解密後清洗 XML

在 WechatCrypt::decrypt() 返回前，添加兩行清洗代碼：

// 明文內容
$text = substr($decrypt, 4, $size);

// 【修復】清洗轉義字符
$text = str_replace('<\/', '</', $text);  // 還原結束標籤
$text = str_replace('>\n', '>', $text);   // 移除字面 \n

return $text;

清洗後 XML 變為標準格式，simplexml_load_string() 即可正常解析。

完整解密流程回顧（關鍵步驟）

1. Base64 解碼：base64_decode($encrypt)
2. AES-256-CBC 解密：Key = EncodingAESKey (Base64 解碼後 32 字節)，IV = Key 前 16 字節。
3. PKCS7 去填充：根據最後一字節值移除填充。
4. 去除 16 字節隨機串：substr($decrypt, 16)
5. 讀取網絡序長度：unpack('N', substr($decrypt, 0, 4)) 獲得 XML 長度。
6. 驗證 AppId：長度後的字串必須等於配置的 AppId。
7. 提取 XML：substr($decrypt, 4, $xml_len)
8. 【新增】清洗轉義字符（本文核心修復）。

加密回覆消息同理

回覆消息加密（encrypt()）流程相反：XML → PKCS7 填充 → 隨機串 + 長度 + XML + AppId → AES 加密 → Base64。若自行構建 XML 回覆，確保輸出標準格式（無轉義斜槓、無字面 \n），避免微信服務端解密失敗。

調試技巧

// 臨時寫入文件檢查解密輸出
file_put_contents('/tmp/wechat_decrypt.xml', $text);
// 然後用瀏覽器或 xmllint 驗證
// xmllint --noout /tmp/wechat_decrypt.xml

避坑總結

掌握微信加解密的數據流向與常見異常格式，能快速定位「安全模式」集成難題，保障公眾號消息通道穩定。