
本文授權轉載,作者:Migi000(簡書)
踩坑合集
接入支付寶幾乎是每個 iOS 開發者的必經之路,而這一路上總少不了各種各樣的坑。我把自己的接入經驗整理如下,希望能幫你少走些彎路。
問題 1. Util/base64.h:63:21: Cannot find interface declaration for 'NSObject', superclass of 'Base64'
解決辦法:
這是由於 base64.h 沒有引入 #import
問題 2.(見下圖報錯)

解決辦法:
原因同上,在 openssl_wrapper.h 中 #import
問題 3. Util/openssl_wrapper.m:11:9: 'rsa.h' file not found
解決辦法:
(1)這是名副其實的「萬年老坑」,只要接入支付寶幾乎百分百會遇到,習慣就好。
(2)在 Build Setting 中搜索 search,找到 Header Search Paths,添加 $(PROJECT_DIR)/openssl 與 $(PROJECT_DIR),如下圖。
(3)重要的事說三遍:网上找到的通用答案未必奏效,這是我自己實踐出來的方案——在 Header Search Paths 中填入 $(PROJECT_DIR)/ali;Framework Search Paths 與 Library Search Paths 保持 $(inherited) 與 $(PROJECT_DIR)/ali。
(4)由於後期接入多個項目,我總結出一個近乎萬能的做法:始終保證 Header Search Paths 與 Library Search Paths 都能定位到你導入的 openssl 正確路徑即可,此法我已多次驗證有效。


問題 4. 大量符號未定義錯誤(多半是庫文件沒導入)
典型的 Undefined symbols for architecture x86_64 / arm64,涉及 CNCopyCurrentNetworkInfo、CTRadioAccessTechnology 系列、CMMotionManager、CTTelephonyNetworkInfo、SCNetworkReachability 系列、std::basic_string、operator new/delete、deflate 等一系列符號,最終報 ld: symbol(s) not found for architecture x86_64,clang: error: linker command failed。
解決辦法:
這類問題通过在 General → Link Framework And Libraries 中添加以下 framework 即可解決:
- libz.tbd
- libc++.tbd
- Security.framework
- CoreMotion.Framework
- CFNetwork.framework
- CoreTelephony.framework
- SystemConfiguration.framework
截圖如下。由於公司同時接入了支付寶與微信支付,導入的庫便格外多些:

問題 5. Redefinition of 'RSA' as different kind of symbol(多因 SDK 集成時命名衝突)
解決辦法:
(1)這並非每家公司都會遇到,但一旦遇到也著實頭疼。
(2)由於支付寶 openssl 中的 rsa.h 與我們此前使用的 RSA 加密存在命名衝突,解決思路是改掉公司自己先前導入的 RSA 命名(若你技藝夠高,也可以去改 rsa.h)。
問題 6. 系統庫導入問題
報錯:symbol(s) not found for architecture arm64。

解決辦法:
把缺失的系統庫導入即可。

問題 7:終於轮到微信了
接入微信相對省心,坑少了很多,這裡要感謝兩篇帖子作者的分享。
解決辦法:
使用微信支付 SDK 1.5 版本的支付 demo。若遇到跳轉後只剩一個「確定」按鈕的問題,關鍵是:把微信支付的注册放在友盟分享之後即可。代碼示例:
// 友盟分享 [self configUmengShare]; //向微信注册 [WXApi registerApp:@"wxb4ba3c02aa476ea1" withDescription:@"demo 2.0"];
問題 8:拉起支付寶報錯——交易訂單處理失敗,請稍後再試(ALI64)
解決辦法:
重新生成私鑰與公鑰,步驟見下題。
問題 9:支付寶需要重新生成私鑰與公鑰並上傳公鑰
解決辦法:
RSA 密鑰生成命令步驟如下(「>」符號後才是需要輸入的命令):
(1) 先在終端鍵入 openssl
生成 RSA 私鑰
(2) openssl> genrsa -out rsa_private_key.pem 1024
生成 RSA 公鑰
(3) openssl> rsa -in rsa_private_key.pem -pubout -out rsa_public_key.pem
將 RSA 私鑰轉換為 PKCS8 格式
(4) openssl> pkcs8 -topk8 -inform PEM -in rsa_private_key.pem -outform PEM -nocrypt
生成的文件:

把公鑰上傳到支付寶,再把上述 pkcs8 命令生成的私鑰(去頭去尾)用在下面的設置中即可:
/* 商戶的唯一的 partner 和 seller。 簽約後,支付寶會為每個商戶分配一個唯一的 partner 和 seller。 */ NSString *partner = PartnerID;//合作伙伴身份(PID) NSString *seller = SellerID;//商戶支付寶賬戶 //獲取私鑰並將商戶信息簽名,外部商戶可根據情況存放私鑰和簽名,只需遵循 RSA 簽名規範,並將簽名字符串 base64 編碼和 UrlEncode NSString *privateKey = PartnerPrivKey;// 剛第三端命令生成的去頭去尾
如有其他問題,歡迎繼續交流補充。多總結,坑才會越來越少!