接入支付寶 SDK 的過程不算難,但踩到的坑往往與 SDK 本身無關,而是 Xcode 專案設定的細節。以下整理四個最常遇到的問題。

把自建的資料夾拖進「Linked Frameworks and Libraries」清單中,然後重新編譯即可。若仍失敗,多試幾次或手動確認路徑是否正確(避免選到 "Copy items if needed" 造成的重複參照)。
編譯時出現類似訊息:
Cannot find interface declaration for 'NSObject', superclass of 'Base64'
解法:打開報錯的檔案,在頂部補上 Foundation 的引入:
#import <Foundation/Foundation.h>
這個錯誤通常出現在 SDK 的 .m 檔被單獨編譯時缺少前置宣告,補上即可解決。
[[AlipaySDK defaultService] payOrder:orderString
fromScheme:appScheme
callback:^(NSDictionary *resultDic) {
NSLog(@"result = %@", resultDic);
}];
程式執行到這裡沒有報錯,但既沒有跳轉到支付寶,也沒有任何回應。
解法:把 Info.plist 中的 Main storyboard file base name(鍵名 UIMainStoryboardFile)刪掉。
原因是支付寶透過 URL Scheme 唤起自身,返回時再透過你的 scheme 回到 App。而 App 重新啟動時,若系統仍試圖依 storyboard 名稱載入初始場景,會與 SDK 的跳轉流程衝突,導致整個流程卡住。
除了上面的 storyboard 設定,還必須在 AppDelegate 中實作 URL 回呼,把控制權交還給 SDK:
- (BOOL)application:(UIApplication *)app
openURL:(NSURL *)url
options:(NSDictionary<NSString *, id> *)options {
if ([url.host isEqualToString:@"safepay"]) {
[[AlipaySDK defaultService] processOrderWithUrl:url
standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"result = %@", resultDic);
}];
}
return YES;
}
同時確認 Info.plist 的 CFBundleURLTypes 中已註冊與 appScheme 一致的 URL Scheme,否則系統無法把使用者導回你的 App。
· 加入 AlipaySDK 與所需的系統 framework(CoreTelephony、SystemConfiguration、QuartzCore、CFNetwork、Security 等)
· 設定 Other Linker Flags 為 -ObjC(若 SDK 含 Objective-C 類別與 category)
· 移除 UIMainStoryboardFile
· Info.plist 註冊 URL Scheme,並在 LSApplicationQueriesSchemes 中加入 alipay、alipays
· AppDelegate 實作 application:openURL:options: 並轉交 SDK 處理
· 於 App Transport Security 中設定 LSApplicationQueriesSchemes 相關的例外,避免 HTTP 請求被阻擋
若上述都完成仍失敗,請先確認 orderString 是由**伺服器端**依支付寶文件簽章產生,而非在客戶端拼湊——簽章錯誤是「按下付款沒反應」的另一個高頻原因。