iOS Game Center成就解锁后自动重置问题求助

问题现象 #

• 首次集成Game Center，排行榜、分数上报功能正常，但成就解锁存在异常：
  • 已解锁成就会在成就面板短暂显示，几秒后自动重新锁定，且所有上报/加载接口都返回成功
  • 可重复解锁（repeatable = YES）和不可重复解锁（repeatable = NO）的成就都出现这个问题
• 接口补充表现：
  • GKAchievementDescription loadAchievementsWithCompletionHandler: 能正确返回App Store Connect中注册的所有成就
  • GKAchievement reportAchievements: 始终返回成功，成就解锁后能在Game Center面板短暂显示
  • GKAchievement loadAchievementsWithCompletionHandler: 首次请求返回已完成成就，多次请求后成就记录消失

核心原因与解决方案 #

1. 沙盒环境的临时数据特性 #

你猜的没错：未上架的版本在Game Center沙盒环境中，成就数据确实可能出现临时重置。沙盒服务器不会永久保存未关联正式版本的成就数据，尤其是测试账号跨设备登录、或触发服务器同步机制时，很容易出现数据回滚。

但这不是唯一原因，结合你的接口表现，还得排查以下几点：

2. 成就上报的逻辑漏洞 #

• 检查GKAchievement对象初始化是否正确：必须用正确的identifier，percentComplete要设为100.0（不可重复成就），重复解锁的成就也要符合进度要求
• 别重复上报未变更的成就：对于不可重复成就，上报前先调用loadAchievementsWithCompletionHandler:检查当前状态，只有未完成时再上报，重复上报可能触发沙盒的异常同步
• 确认上报代码的线程处理：GKAchievement的所有操作必须在主线程执行，后台线程处理可能导致上报不彻底，后续同步时被沙盒覆盖

正确上报示例代码：

// 加载当前成就状态
[GKAchievement loadAchievementsWithCompletionHandler:^(NSArray<GKAchievement *> * _Nullable achievements, NSError * _Nullable error) {
    if (!error) {
        NSString *targetID = @"your_achievement_identifier";
        GKAchievement *achievement = nil;
        for (GKAchievement *ach in achievements) {
            if ([ach.identifier isEqualToString:targetID]) {
                achievement = ach;
                break;
            }
        }
        // 未完成则上报
        if (!achievement || achievement.percentComplete < 100.0) {
            if (!achievement) {
                achievement = [[GKAchievement alloc] initWithIdentifier:targetID];
            }
            achievement.percentComplete = 100.0;
            achievement.showsCompletionBanner = YES;
            [GKAchievement reportAchievements:@[achievement] withCompletionHandler:^(NSError * _Nullable error) {
                if (error) {
                    NSLog(@"成就上报失败: %@", error.localizedDescription);
                } else {
                    NSLog(@"成就上报成功");
                }
            }];
        }
    }
}];

3. App Store Connect的成就配置验证 #

• 检查成就的Repeatable配置和代码是否一致：如果后台设为不可重复，但代码里误把repeatable设为YES，会导致沙盒同步异常
• 确认成就Identifier和代码完全匹配：大小写、拼写错误会导致成就无法正确关联服务器记录

4. 沙盒测试账号的状态 #

• 换个新的沙盒测试账号试试：部分旧账号可能有数据缓存异常，换账号后重新测试
• 退出再重新登录Game Center：清除本地缓存后再跑成就解锁流程

5. 版本关联验证 #

虽然版本没上架，但要确保App Store Connect里已经创建了对应的App Store版本（哪怕没提交审核），并且把成就关联到这个版本。没关联版本的成就在沙盒里可能没法持久化存储。

总结 #

先排查成就上报逻辑的正确性，确保线程、参数、状态检查都没问题；然后验证App Store Connect的成就配置和代码匹配；最后可以试试更换测试账号或把成就关联到未上架版本。沙盒环境的临时数据问题，等版本提交审核后通常就会消失。

内容的提问来源于stack exchange，提问作者Bektaş Kart