微信jssdk常見錯誤及解決方法

調用config 接口的時候傳入參數 debug: true 能夠開啓debug模式，頁面會alert出錯誤信息。如下爲常見錯誤及解決方法：

 

• invalid url domain當前頁面所在域名與使用的appid沒有綁定，請確認正確填寫綁定的域名，若是使用了端口號，則配置的綁定域名也要加上端口號（一個appid能夠綁定三個有效域名，見 目錄1.1.1）。

• invalid signature簽名錯誤。建議按以下順序檢查：

• 確認簽名算法正確，可用 http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=jsapisign 頁面工具進行校驗。

• 確認config中nonceStr（js中駝峯標準大寫S）, timestamp與用以簽名中的對應noncestr, timestamp一致。

• 確認url是頁面完整的url(請在當前頁面alert(location.href.split('#')[0])確認)，包括'http(s)://'部分，以及'？'後面的GET參數部分,但不包括'#'hash後面的部分。

• 確認 config 中的 appid 與用來獲取 jsapi_ticket 的 appid 一致。

• 確保必定緩存access_token和jsapi_ticket。

• 確保你獲取用來簽名的url是動態獲取的，動態頁面可參見實例代碼中php的實現方式。若是是html的靜態頁面在前端經過ajax將url傳到後臺簽名，前端須要用js獲取當前頁面除去'#'hash部分的連接（可用location.href.split('#')[0]獲取,並且須要encodeURIComponent），由於頁面一旦分享，微信客戶端會在你的連接末尾加入其它參數，若是不是動態獲取當前連接，將致使分享後的頁面簽名失敗。

• the permission value is offline verifying這個錯誤是由於config沒有正確執行，或者是調用的JSAPI沒有傳入config的jsApiList參數中。建議按以下順序檢查：

• 確認config正確經過。

• 若是是在頁面加載好時就調用了JSAPI，則必須寫在wx.ready的回調中。

• 確認config的jsApiList參數包含了這個JSAPI。

• permission denied該公衆號沒有權限使用這個JSAPI，或者是調用的JSAPI沒有傳入config的jsApiList參數中（部分接口須要認證以後才能使用）。

• function not exist當前客戶端版本不支持該接口，請升級到新版體驗。

• 爲何6.0.1版本config:ok，可是6.0.2版本以後不ok（由於6.0.2版本以前沒有作權限驗證，因此config都是ok，但這並不意味着你config中的簽名是OK的，請在6.0.2檢驗是否生成正確的簽名以保證config在高版本中也ok。）

• Android用戶已取消分享朋友圈，但仍返回分享成功（微信團隊已修復此問題，已在Android6.1版本上線）

• 在iOS和Android都沒法分享（請確認公衆號已經認證，只有認證的公衆號才具備分享相關接口權限，若是確實已經認證，則要檢查監聽接口是否在wx.ready回調函數中觸發）

• Android6.0.2部分客戶端沒法使用監聽分享接口（Android6.0.2以前以及6.0.2.58之後的版本都不會有問題，請從官網weixin.qq.com下載最新版本體驗）

• 服務上線以後沒法獲取jsapi_ticket，本身測試時沒問題。（由於access_token和jsapi_ticket必需要在本身的服務器緩存，不然上線後會觸發頻率限制。請確保必定對token和ticket作緩存以減小2次服務器請求，不只能夠避免觸發頻率限制，還加快大家本身的服務速度。目前爲了方便測試提供了1w的獲取量，超過閥值後，服務將再也不可用，請確保在服務上線前必定全局緩存access_token和jsapi_ticket，二者有效期均爲7200秒，不然一旦上線觸發頻率限制，服務將再也不可用）。

• Android部分版本上傳圖片接口偶爾卡住（早期的Android6.0.2版本存在此問題，官方已修復，6.0.2.58以後的版本都支持，請從官網下載最新版本體驗）

• uploadImage怎麼傳多圖（目前只支持一次上傳一張，多張圖片需等前一張圖片上傳以後再調用該接口）

• 無法對本地選擇的圖片進行預覽（chooseImage接口自己就支持預覽，不須要額外支持）

• 經過a連接(例如先經過微信受權登陸)跳轉到b連接，invalid signature簽名失敗（後臺生成簽名的連接爲使用jssdk的當前連接，也就是跳轉後的b連接，請不要用微信登陸的受權連接進行簽名計算，後臺簽名的url必定是使用jssdk的當前頁面的完整url除去'#'部分）

• 出現config:fail錯誤（這是因爲傳入的config參數不全致使，請確保傳入正確的appId、timestamp、nonceStr、signature和須要使用的jsApiList）

• 如何把jsapi上傳到微信的多媒體資源下載到本身的服務器（請參見文檔中uploadVoice和uploadImage接口的備註說明）

• 在Android中經過其餘設備上傳的serverId，能下載成功但沒法播放（微信團隊已經確認此問題，已在Android6.1版本中修復）

• Android經過jssdk上傳到微信服務器，第三方再從微信下載到本身的服務器，會出現雜音（微信團隊已經修復此問題，目先後臺已優化上線）

• 綁定父級域名，是否其子域名也是可用的（是的，合法的子域名在綁定父域名以後是徹底支持的）

• 在Android中經過掃一掃打開頁面，再調用scanQRCode並返回數據給第三方，會直接退出當前頁（微信團隊已經確認此問題，已在Android6.1版本中修復）

• 在iOS微信6.1版本中，分享的圖片外鏈不顯示，只能顯示公衆號頁面內鏈的圖片或者微信服務器的圖片（微信團隊已經確認此問題，會在6.2中修復）

• 是否須要對低版本本身作兼容（jssdk都是兼容低版本的，不須要第三方本身額外作更多工做，但有的接口是6.0.2新引入的，只有新版纔可調用）

• 該公衆號支付簽名無效，沒法發起該筆交易（請確保你使用的jweixin.js是官方線上版本，不只能夠減小用戶流量，還有可能對某些bug進行修復，拷貝到第三方服務器中使用，官方將不對其出現的任何問題提供保障，具體支付簽名算法可參考 JSSDK微信支付一欄）

• 目前Android微信客戶端不支持pushState的H5新特性，因此使用pushState來實現web app的頁面會致使簽名失敗，此問題會在Android6.2中修復

• uploadImage在chooseImage的回調中有時候Android會不執行，Android6.2會解決此問題，目前能夠把調用uploadImage放在setTimeout中延遲100ms解決

• chooseImage返回的localId在Android6.1下顯示模糊，6.2的版本會修復此問題

• require subscribe錯誤說明你沒有訂閱該測試號，該錯誤僅測試號會出現

• getLocation返回的座標在openLocation有誤差，由於getLocation返回的是gps座標，openLocation打開的騰訊地圖爲火星座標，須要第三方本身作轉換，6.2版本會支持直接獲取火星座標

• 查看公衆號（未添加）: "menuItem:addContact"不顯示，目前僅有從公衆號傳播出去的連接才能顯示，來源必須是公衆號