发生了什么
商家 App 是线下业务人员用手机管理换电柜点位的工具。其中“潜在点位管理”用来登记还没建柜的候选位置:业务人员站在候选点位上,App 取到手机当前坐标后,把这次选址登记成一条潜在点位记录,后续再按它建点位。“电池档案”的“位置信息”会显示一块电池的位置,业务人员点导航,App 按自己当前位置到电池位置规划路线,去现场找到这块电池。
这两处操作都依赖同一个前提:App 通过手机里的地图 SDK 取到当前经纬度。正常时,取到坐标后,新建潜在点位可以提交,电池导航可以规划路线并开始导航。
8 月 4 日,平台侧结合新系统的适配情况,对商家 App 做了统一的兼容处理,并通知各业务线的接口人和研发负责人安排业务侧回归与适配。这次改动的影响清单里没有地图和定位相关的条目。9 月 18 日,测试确认通过后发布上线。9 月 26 日,业务侧反馈:在已升级到 iOS 26 的手机上,这两处功能都用不了——新建潜在点位做不下去,电池的位置信息也导航不了;同样的操作在旧系统手机上正常。
本质
地图 SDK 在给出定位结果前会先做一次“虚拟定位检测”,用来判断手机是否正在使用伪造位置的工具。商家 App 里这个检测开关是打开的。在 iOS 26 上,这项检测与系统不兼容,回调里返回的经纬度变成 0,也就是没有拿到有效位置。
- 平台侧按新系统做统一适配,改动影响清单里没有地图和定位条目。
- 业务线接到通知后安排回归和适配,9 月 18 日测试通过并发布。旧系统上的定位一直正常,问题只有在 iOS 26 手机上去取坐标的页面才会出现。
- 业务人员在 iOS 26 手机上打开新建潜在点位或电池导航:SDK 先执行虚拟定位检测,检测在新系统上出错,回调给出的坐标是 0。
- 页面拿到的是 0 坐标,等于没有位置。新建点位取不到可用的位置,流程走不下去;电池导航没有起点,也算不出路线。两个页面表现不同,原因都是同一个无效坐标。
这里最容易被漏掉的是:系统大版本升级影响的常常不是自己写的代码,而是依赖的 SDK 在运行时的行为;它不在改动清单里,回归就不会覆盖到。
临时处理是按系统版本把检测关掉:iOS 26 及以上不再执行虚拟定位检测,其他系统保持原样。这一步只绕开检测,根因仍在地图 SDK,后续需要升级 SDK 版本。下面用 Objective-C 示意这个机制,类名和开关名做了泛化。
错误代码
// 示意:定位管理器初始化与回调
- (void)setupLocationManager {
self.locationManager = [[MapLocationManager alloc] init];
self.locationManager.delegate = self;
self.locationManager.desiredAccuracy = kCLLocationAccuracyHundredMeters;
// 为什么错:虚拟定位检测对所有系统一律打开,没有区分 iOS 26,
// 该检测在新系统上会让回调返回 0 坐标
self.locationManager.detectsFakeLocation = YES;
[self.locationManager startUpdatingLocation];
}
- (void)locationManager:(MapLocationManager *)manager
didUpdateLocation:(CLLocation *)location {
// 这里拿到的坐标已经是 0,新建点位和电池导航都无法继续
self.currentCoordinate = location.coordinate;
[self submitPotentialSiteWithCoordinate:location.coordinate];
}
修复代码示例
// 示意:按系统版本决定虚拟定位检测是否开启
- (void)setupLocationManager {
self.locationManager = [[MapLocationManager alloc] init];
self.locationManager.delegate = self;
self.locationManager.desiredAccuracy = kCLLocationAccuracyHundredMeters;
// 修正:iOS 26 上先关闭虚拟定位检测,其他系统保持开启;
// 这只是临时规避,根因在地图 SDK,后续要升级 SDK 版本
if (@available(iOS 26.0, *)) {
self.locationManager.detectsFakeLocation = NO;
} else {
self.locationManager.detectsFakeLocation = YES;
}
[self.locationManager startUpdatingLocation];
}
- (void)locationManager:(MapLocationManager *)manager
didUpdateLocation:(CLLocation *)location {
self.currentCoordinate = location.coordinate;
[self submitPotentialSiteWithCoordinate:location.coordinate];
}
两段代码是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现,也未在真机运行。这次采用的临时方案只改了检测开关;要让页面在 SDK 再次返回无效坐标时不至于卡住,读取坐标的代码还应判断经纬度是否为零,并在无效时提示用户重新定位。
下次遇到这些场景要警惕
- 系统大版本发布或做兼容适配时:把 App 依赖的定位、地图、相机、推送等系统能力单独列一张验证表,拿新系统真机走“取坐标→新建→导航”的完整流程,观察回调里的坐标是否有效,不只看页面能不能打开。
- SDK 里有风控、检测类开关且默认开启时:在同一台新系统设备、同一位置把开关打开和关闭各跑一次,对比定位结果;升级 SDK 或系统前后都做这个对照,确认开关打开时结果仍然可用。
- 回归范围按改动清单执行时:把“依赖的 SDK 在新系统上的运行行为”补成固定回归项,尤其是清单没有提到、但业务重度依赖的能力,避免清单没写就等于不用测。
- 页面拿定位结果继续业务前:校验经纬度是否为零、是否在合理范围;无效时给出提示,并提供重试或手动选点的入口,不要让流程停在点了没反应的状态。