iOS 支付宝支付成功返回 App 后回调未触发
结论
这类问题通常不是支付结果异常，而是支付宝返回 App 时，系统没有把回跳 URL 正确交给支付宝 SDK。
建议先检查以下几项：
fromScheme与Info.plist中配置的 URL Scheme 不一致，或者没有配置 Scheme。- App 使用了
SceneDelegate，回跳事件进入scene:openURLContexts:，不会触发AppDelegate的application:openURL:options:。 - 收到回跳 URL 后，没有调用
processOrderWithPaymentResult:standbyCallback:。 - App 的生命周期代理、方法签名或多场景配置不正确。
- 把
payOrder:fromScheme:callback:的 block 当成了所有支付场景中唯一的结果回调。 - 支付宝开放平台配置、应用签名或订单参数与当前 App 不匹配。
客户端回调适合用来更新界面。最终支付状态应以服务端收到的支付宝异步通知或主动查询结果为准。
先检查 URL Scheme
调用支付宝 SDK 时传入的 fromScheme，必须与应用注册的 URL Scheme 完全一致，包括大小写。
例如：
NSString *appScheme = @"com.example.alipay";
[[AlipaySDK defaultService] payOrder:orderString
fromScheme:appScheme
callback:^(NSDictionary *resultDic) {
NSLog(@"Alipay payOrder callback: %@", resultDic);
}];在 Xcode 中检查：
Target
→ Info
→ URL Types
→ URL Schemes
对应的 Info.plist 配置类似：
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleURLName</key>
<string>alipay</string>
<key>CFBundleURLSchemes</key>
<array>
<string>com.example.alipay</string>
</array>
</dict>
</array>常见错误包括：
fromScheme传入了空字符串。- Scheme 配置在错误的 Target 中。
- Debug 和 Release 使用了不同的配置。
- 混淆了主工程与扩展 Target 的配置。
- Scheme 包含空格、中文或不合适的特殊字符。
- 实际安装的包不是当前检查的构建版本。
- URL Scheme 已被另一个 App 占用。
可以先在真机 Safari 中输入类似地址进行验证：
com.example.alipay://test
如果系统无法拉起当前 App，应先修复 URL Scheme，暂时不用继续排查支付宝 SDK。
正确处理 AppDelegate 回调
只实现系统的 openURL 方法还不够。收到 URL 后，还要把它交给支付宝 SDK 处理。
#import <AlipaySDK/AlipaySDK.h>
- (BOOL)application:(UIApplication *)app
openURL:(NSURL *)url
options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options
{
NSLog(@"App received URL: %@", url.absoluteString);
if ([url.host isEqualToString:@"safepay"]) {
[[AlipaySDK defaultService]
processOrderWithPaymentResult:url
standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"Alipay result: %@", resultDic);
[self handleAlipayResult:resultDic];
}];
}
return YES;
}如果项目还要兼容较旧的应用生命周期入口，可以同时保留：
- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation
{
NSLog(@"App received legacy URL: %@", url.absoluteString);
if ([url.host isEqualToString:@"safepay"]) {
[[AlipaySDK defaultService]
processOrderWithPaymentResult:url
standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"Alipay legacy result: %@", resultDic);
[self handleAlipayResult:resultDic];
}];
}
return YES;
}不要只在 openURL 中打印日志后直接返回。如果没有调用 processOrderWithPaymentResult:standbyCallback:，支付宝 SDK 就无法解析回跳结果。
使用 SceneDelegate 时的处理方式
如果项目启用了 Scene 生命周期，尤其是 Info.plist 中存在 UIApplicationSceneManifest，系统很可能会把 URL 直接交给 SceneDelegate。
这种情况下，即使 AppDelegate 中的方法完全正确，也可能不会触发。
#import <AlipaySDK/AlipaySDK.h>
- (void)scene:(UIScene *)scene
openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts API_AVAILABLE(ios(13.0))
{
UIOpenURLContext *context = URLContexts.anyObject;
NSURL *url = context.URL;
NSLog(@"Scene received URL: %@", url.absoluteString);
if ([url.host isEqualToString:@"safepay"]) {
[[AlipaySDK defaultService]
processOrderWithPaymentResult:url
standbyCallback:^(NSDictionary *resultDic) {
NSLog(@"Alipay scene result: %@", resultDic);
[self handleAlipayResult:resultDic];
}];
}
}如果 SwiftUI 使用 @main 和 App 生命周期，也要通过 onOpenURL 接收回跳，再把 URL 交给 SDK：
.onOpenURL { url in
guard url.host == "safepay" else {
return
}
AlipaySDK.defaultService().processOrder(
withPaymentResult: url,
standbyCallback: { result in
print("Alipay result: \(String(describing: result))")
}
)
}支付宝 SDK 的版本及其 Swift 映射方式不同，具体方法名可能略有差异，应以当前集成版本的头文件为准。
为什么 payOrder 的 callback 也可能不执行
下面这个 block 不能视为所有场景下唯一可靠的支付结果入口：
[[AlipaySDK defaultService] payOrder:orderString
fromScheme:appScheme
callback:^(NSDictionary *resultDic) {
NSLog(@"payOrder callback: %@", resultDic);
}];支付过程中如果拉起了支付宝客户端，当前 App 会进入后台。支付完成后，结果通常要通过系统回跳入口重新交给 SDK 处理。SDK 版本、设备是否安装支付宝客户端，以及支付流程实际走过的路径，都会影响 callback 在哪里触发。
可以把两个入口统一到同一个结果处理方法：
- (void)handleAlipayResult:(NSDictionary *)resultDic
{
NSString *resultStatus = [NSString stringWithFormat:@"%@", resultDic[@"resultStatus"]];
NSString *memo = [NSString stringWithFormat:@"%@", resultDic[@"memo"]];
NSLog(@"resultStatus = %@, memo = %@", resultStatus, memo);
if ([resultStatus isEqualToString:@"9000"]) {
// 客户端显示“支付处理中”或发起服务端查询，
// 不要仅凭客户端回调直接确认订单已支付。
} else if ([resultStatus isEqualToString:@"6001"]) {
// 用户取消支付。
} else {
// 其他状态交给服务端查询确认。
}
}调用处：
__weak typeof(self) weakSelf = self;
[[AlipaySDK defaultService] payOrder:orderString
fromScheme:appScheme
callback:^(NSDictionary *resultDic) {
[weakSelf handleAlipayResult:resultDic];
}];系统回跳处也调用同一个方法：
[[AlipaySDK defaultService]
processOrderWithPaymentResult:url
standbyCallback:^(NSDictionary *resultDic) {
[self handleAlipayResult:resultDic];
}];按回跳链路逐层排查
1. 确认支付宝是否回到了目标 App
支付完成后，观察以下情况：
- 系统是否自动拉起了正确的 App。
- 拉起的是否是同一 App 的另一个环境版本。
- 用户是否只是手动从后台切回 App。
- 设备上是否同时安装了开发版、测试版或企业版。
用户手动切回 App 不等于发生了 URL 回跳，系统不会因此调用 openURL。
2. 在所有可能的入口打印原始 URL
分别在以下方法的第一行添加日志：
application:openURL:options:
application:openURL:sourceApplication:annotation:
scene:openURLContexts:不要一开始就只在 url.host == safepay 的分支里打印日志。URL 可能已经到达，但判断条件没有匹配，此时很容易误以为方法根本没有执行。
3. 确认生命周期入口确实生效
逐项检查：
UIApplicationDelegate实例是否确实是当前AppDelegate。- 项目是否启用了
SceneDelegate。 UIApplicationSceneManifest指向的 Scene 配置是否正确。- 方法是否写在正确的类实现中。
- Objective-C 方法签名是否完整。
- Swift 方法是否符合协议要求。
- 是否有第三方框架代理了 URL 回调，却没有继续转发。
4. 确认传给支付宝 SDK 的参数不是空值
问题示例中的参数是空字符串：
payOrder:@"" fromScheme:@""如果实际代码也是这样，需要先修正。orderString 和 fromScheme 都不能用空字符串代替真实值。
if (orderString.length == 0 || appScheme.length == 0) {
NSLog(@"Invalid Alipay parameters");
return;
}订单字符串通常应由服务端按照支付宝的要求生成并签名，不建议把商户私钥放在客户端。
5. 检查 SDK 是否完整集成
确认以下事项：
- 工程实际链接的是预期版本的支付宝 SDK。
- 工程中没有同时集成多个版本，也没有残留旧文件。
- 必需的系统依赖、构建设置和 URL 配置已经按照当前 SDK 接入文档完成。
- 升级 SDK 后，回调 API 和接入代码也已同步更新。
- 真机运行时没有出现动态库加载失败或符号冲突。
不同版本的支付宝 SDK 接口可能存在差异。具体接入方式应以项目中的 AlipaySDK 头文件和对应版本的官方说明为准。
不要只依赖客户端判断支付成功
即使客户端收到：
resultStatus = 9000
也不能直接把业务订单永久标记为已支付。客户端可能出现回调丢失、网络中断、进程被杀死或结果被篡改等情况。
更稳妥的流程是：
- 客户端发起支付。
- 支付宝服务端向商户服务端发送异步通知。
- 商户服务端验签，并校验订单号、商户号、金额和支付状态。
- 服务端更新订单。
- App 返回前台后，向业务服务端查询订单状态。
- 根据服务端返回的结果显示支付成功、处理中或失败。
如果 App 已经成功拉起，但所有 URL 回调都没有日志，应重点检查 SceneDelegate 和生命周期配置。如果 App 根本没有被拉起，应重点检查 fromScheme 与 URL Types。如果已经收到 URL，但支付宝结果 block 没有执行，则应检查是否调用了 processOrderWithPaymentResult:standbyCallback:、传入的 URL 是否正确，以及接入方式是否与当前 SDK 版本一致。
备注：内容仅供参考。