使用Amplify Studio DataStore保存contactMobile时触发OutboxMutationFailed错误求助

开发者阿泽

2026-8-8

Amplify DataStore保存AWSPhone类型字段触发outboxMutationFailed错误的解决方法

问题概述

将数据保存到Amplify Studio DataStore时，仅contactMobile字段（AWSPhone类型）触发Unhandled DataStoreubEvent: outboxMutationFailed错误，其他字段（如aboutMe）可正常存储，错误详情如下：

OutboxMutationFailedEvent{errorType=UNKNOWN, operation=UPDATE, modelName=Trainers, model=SerializedModel{id='0e871e26-a5de-44ba-ac5c-607bbc79acbe', serializedData={contactMobile=123456789, aboutMe=qq}}

解决步骤

强制符合E.164手机号格式：AWSPhone类型要求数据必须遵循E.164标准，即带国家码前缀（如+86）。不能直接传入纯数字123456789，需在保存前拼接正确的国家码，示例：

String formattedPhone = '+86${_contactMobileController.text.trim()}';
final trainer = Trainers(
  id: '0e871e26-a5de-44ba-ac5c-607bbc79acbe',
  contactMobile: AWSPhone(number: formattedPhone),
  aboutMe: 'qq'
);
await Amplify.DataStore.save(trainer);

同步云端与本地模型配置：确认Amplify Studio中contactMobile字段已设为AWSPhone类型，执行amplify pull命令重新生成本地DataModel代码，确保配置同步。
排查输入数据干扰：保存前打印并检查输入值，确认无空格、特殊字符：
```
print('输入手机号: ${_contactMobileController.text.trim()}');
```

捕获详细错误信息：添加错误监听获取具体报错原因，替代默认UNKNOWN错误：

Amplify.DataStore.observe(Trainers.classType).listen((event) {
  if (event is OutboxMutationFailedEvent) {
    print('错误详情: ${event.error.message}');
    print('错误栈: ${event.error.stackTrace}');
  }
});