iOS Flutter应用CallKit调试正常但TestFlight版本无法追踪通话

问题背景 #

基于Flutter开发的iOS应用，通过CallKit实现外呼通话追踪功能，Debug模式下运行正常，但发布到TestFlight后功能失效。已完成如下配置：

• Info.plist中添加Background Modes（voip、audio、processing、fetch）及对应权限描述
• Xcode中链接CallKit.framework（设为Optional）
• Runner.entitlements配置aps-environment为production
• Apple开发者后台启用App ID的VoIP和后台模式权限

相关代码包含AppDelegate中CXCallObserver实现、Flutter端Method Channel通话状态监听、API保存通话时长逻辑。排查发现TestFlight版本中通话时长始终为0，但状态打印正常，Console.app无CallKit相关日志。

1. 为何CallKit在Release/TestFlight版本失效但Debug模式正常？ #

核心原因有三点：

• 编译器优化导致回调丢失：Release模式下Xcode默认开启-Os级优化，若CXCallObserver实例未被强引用持有，会被ARC自动释放，无法接收通话状态回调；Debug模式优化等级低，不会出现这类问题。
• 权限验证严格性差异：TestFlight/Release模式下Apple对权限的验证更严格，哪怕配置存在微小疏漏（比如权限描述不符合要求），都可能导致CallKit功能被静默禁用。
• 日志输出被屏蔽：Release模式默认关闭NSLog等日志输出，Console.app看不到日志不代表回调没触发，只是日志被系统过滤了。

2. 如何确保CXCallObserver在TestFlight版本中能检测到通话？ #

• 强引用持有CXCallObserver实例：在AppDelegate中将CXCallObserver声明为全局属性，避免被提前释放。示例代码：

@interface AppDelegate () <CXCallObserverDelegate>
@property (nonatomic, strong) CXCallObserver *callObserver;
@end

@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 初始化Flutter等逻辑
    self.callObserver = [[CXCallObserver alloc] init];
    [self.callObserver setDelegate:self queue:dispatch_get_main_queue()];
    return YES;
}

#pragma mark - CXCallObserverDelegate
- (void)callObserver:(CXCallObserver *)callObserver callChanged:(CXCall *)call {
    // 通话状态处理逻辑，添加本地存储验证回调触发
    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
    if (call.hasConnected) {
        [defaults setObject:[NSDate date] forKey:@"CallStartTime"];
    } else if (call.hasEnded) {
        NSDate *startTime = [defaults objectForKey:@"CallStartTime"];
        NSTimeInterval duration = [[NSDate date] timeIntervalSinceDate:startTime];
        [defaults setObject:@(duration) forKey:@"CallDuration"];
        [defaults synchronize];
        // 同步到Flutter端或API
    }
}
@end

• 针对性关闭编译器优化：对包含CallKit逻辑的文件，在Xcode的Build Settings -> Optimization Level中设置为None [-O0]，避免回调逻辑被优化掉。
• 通过本地存储验证回调：不要只依赖日志，在回调中用UserDefaults记录通话时间点，后续可通过Flutter读取这些数据，确认回调是否真的触发。

3. CallKit在Release模式下是否需要额外的权限或配置？ #

不需要额外权限，但要确保现有配置完全合规：

• 确认Info.plist配置有效性：UIBackgroundModes数组必须包含voip，且NSVoIPUsageDescription权限描述要具体（比如"需要使用VoIP权限追踪通话状态"），不能模糊笼统。
• 检查Entitlements完整性：除了aps-environment为production，还要确认com.apple.developer.voip权限存在（开发者后台启用VoIP后，Xcode会自动同步，也可手动添加）。
• 验证CallKit.framework链接：确保Release模式下CallKit.framework仍在Build Phases -> Link Binary With Libraries列表中，且状态为Optional。
• 规范后台任务使用：若用beginBackgroundTask维持后台存活，要确保调用时机正确，任务结束时必须调用endBackgroundTask，避免被系统强制终止。

额外排查建议 #

• 连接Xcode调试TestFlight版本：通过Xcode的Window -> Devices and Simulators选择已安装TestFlight应用的设备，查看实时日志，获取Release模式下的真实输出。
• 同步开发者后台配置：在Xcode的Signing & Capabilities中点击Sync with Developer Account，确保App ID的权限配置已同步到本地项目。
• 测试真实通话场景：用真实号码测试外呼，避免使用虚拟通话或FaceTime音频（部分场景下CallKit检测逻辑可能有差异）。

内容的提问来源于stack exchange，提问作者Beast69