Mock Drift 实战案例：Kiosk App 的 5 个真实 Bug

Bug #1：登录请求缺少 login_type 字段

现象 调用 POST /api/auth/login 返回 HTTP 400 错误 "Invalid login type"，用户点登录按钮无任何反应。

原因 后端登录 API 要求请求体必须包含 login_type 字段（值为 'email'），用于区分邮箱登录、手机号登录、第三方登录。但 api_client.dart 的 adminLogin() 只传了 email 和 password，漏掉了这个必填字段。

修复 在 api_client.dart 的 adminLogin() 请求体中补上 'login_type': 'email'。

教训 Mock 只按路径匹配，不校验请求体是否合法。后端的参数校验逻辑被完全跳过。

Bug #2：Token 字段名不匹配

现象 登录请求成功了（HTTP 200），但 App 提示 "Invalid response from server"，无法进入选店步骤。

原因 后端登录成功后返回的 JSON 中，token 放在 data.access_token 字段里。但 admin_setup_cubit.dart 只检查了 data['token'] 和 respData['token']，没有检查 access_token。Token 始终为 null，走到了错误分支。

// Mock 返回
{ "data": { "token": "fake-jwt-123" } }

// 真实后端返回
{ "data": { "access_token": "eyJhbG..." } }

修复 在 admin_setup_cubit.dart 的 token 提取链中增加 respData?['access_token'] 作为第三优先级回退。

教训 字段名是最容易记错的地方。token vs access_token vs jwt — 不同 API 命名习惯不同，只有连真实后端才能验证。

Bug #3：API 响应嵌套格式错误（4 处）

现象 登录选店成功后，进入预约流程，服务列表、技师列表、时间段列表全部为空，页面只显示空白网格。

原因 后端 API 返回的数据不是扁平数组，而是嵌套在对象中：

代码中写的 data['data'] as List 对真实后端返回的 Map 做类型转换，Dart 的 as List? 返回 null，走到 ?? [] 变成空列表。不报错但什么都不显示 — 这是最危险的静默失败。

修复 在 4 个方法中都改为先检查 data['data'] 的实际类型：

final rawData = data['data'];
final rawList = rawData is List
    ? rawData
    : (rawData is Map ? (rawData['services'] as List? ?? []) : []);

教训 API 的响应嵌套层级是最常见的 Mock Drift 来源。开发者通常简化 Mock 数据结构（省略中间层级），导致解析代码从未被真正测试过。

Bug #4：价格字段类型错误导致运行时崩溃

现象 修复 Bug #3 后，服务列表 API 请求成功了，但 Cubit 的 error 状态显示：NoSuchMethodError: Class 'String' has no instance method 'toDouble'. Receiver: "45.00"

原因 后端 PostgreSQL 中 price 列是 numeric / decimal 类型，经过 JSON 序列化后变成字符串 "45.00" 而非数字 45.0。代码中 (s['price'] ?? 0).toDouble() 在 String 上调用 .toDouble()（这是 num 的方法），直接抛 NoSuchMethodError。

// Mock 数据
{ "price": 45.0, "duration": 30 }
// Dart 类型: num → .toDouble() 正常

// 真实后端数据
{ "price": "45.00", "duration": 30 }
// Dart 类型: String → .toDouble() 崩溃!

修复 改为防御性类型检查：

final rawPrice = s['price'] ?? 0;
final price = rawPrice is num
    ? rawPrice.toDouble()
    : double.tryParse(rawPrice.toString()) ?? 0.0;

教训 JSON 中 "45.00"（字符串）和 45.0（数字）在 JavaScript 端看起来差不多，但在 Dart 强类型语言中是完全不同的类型。Mock 数据用 Dart 原生类型构造，永远不会碰到这种类型不匹配。

Bug #5：iOS ATS 拦截 HTTP 请求

现象 App 安装到 iPad 模拟器后，点登录完全没反应。没有错误弹窗，没有 loading，没有任何视觉反馈。

原因 iOS 9 起强制启用 App Transport Security（ATS），默认禁止所有 HTTP 明文请求，只允许 HTTPS。本地开发连接 http://localhost:3000 是 HTTP，iOS 直接在系统层静默拦截了请求。Dio 收到网络错误，被 catch 吞掉。

修复 在 Info.plist 中添加 ATS 例外：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsLocalNetworking</key>
    <true/>
</dict>

NSAllowsLocalNetworking 只放行 localhost HTTP，外部请求仍强制 HTTPS。生产环境使用 https://api.celoria.ai，不受影响。

教训 Mock 测试完全绕过了真实网络栈。任何涉及网络配置、TLS、证书验证、代理设置的问题，Mock 测试一个都抓不到。