如何在Flutter中编写Appwrite重复注册ID校验查询函数？

我是一家小型科技公司的实习生，公司使用Appwrite作为数据库，基于Flutter开发移动应用。我的任务是校验Appwrite数据库中是否存在重复的注册ID，若存在则在用户完善资料时提示该ID已存在，需输入其他ID。但作为Flutter和Appwrite新手，我编写的校验函数遇到了问题：该函数本应接收registryID参数并返回Appwrite文档中registryId列对应的注册ID，但打印结果为空map，我认为函数写法有误。

我的函数代码如下：

Future<dynamic> checkDuplicateID(String registerID) async{
try {
  dynamic res =  await db.listDocuments(
      collectionId: kycCollectionId,
  queries: [
    Query.equal('registryId', registerID),
  ]
  );
} on AppwriteException catch(e) {
  print(e.toString());
}
}

在提交按钮处，我使用Provider包调用该方法并传入数据库中重复的ID“UKH00250238”：

onTap: () {
dynamic result = state.checkDuplicateID('UKH00250238');

} 

请问上述函数写法是否有误？如何编写可传入registerID参数并校验ID是否重复的函数？还有哪些方法可以在Appwrite中校验重复ID？

现有代码的问题 #

1. 无返回值：checkDuplicateID函数内获取了查询结果res但未返回，调用后无法拿到有效数据。
2. 异步调用未处理：直接赋值dynamic result = state.checkDuplicateID(...)得到的是Future对象，不是实际查询结果，必须用await处理异步逻辑。
3. 结果判断缺失：未对查询返回的文档数量做判断，无法直接知晓是否存在重复ID。

修正后的校验函数 #

可以将函数改为返回bool类型，直观表示是否存在重复ID：

Future<bool> checkDuplicateID(String registerID) async {
  try {
    final res = await db.listDocuments(
      collectionId: kycCollectionId,
      queries: [
        Query.equal('registryId', registerID),
        Query.limit(1), // 仅查询1条数据，提升性能
      ],
    );
    // 文档数量大于0则说明存在重复
    return res.documents.isNotEmpty;
  } on AppwriteException catch (e) {
    print(e.toString());
    // 异常场景可根据业务需求调整返回值，这里默认返回false
    return false;
  }
}

正确的调用方式 #

由于是异步函数，调用时必须使用async/await：

onTap: () async {
  bool isDuplicate = await state.checkDuplicateID('UKH00250238');
  if (isDuplicate) {
    // 通过SnackBar或Dialog提示用户ID重复
    ScaffoldMessenger.of(context).showSnackBar(
      const SnackBar(content: Text('该注册ID已存在，请输入其他ID')),
    );
  } else {
    // 执行后续资料完善流程
  }
}

Appwrite中校验重复ID的其他方法 #

• 字段唯一性约束：在Appwrite控制台的集合设置中，给registryId字段开启唯一性约束。当插入重复ID时，Appwrite会直接抛出异常，捕获该异常即可提示用户，这种方式能避免并发场景下的竞态问题，可靠性更高。
• 云函数+触发器：编写Appwrite云函数，配合数据库的插入/更新触发器，在数据写入前自动校验ID是否重复，拦截违规数据。

内容的提问来源于stack exchange，提问作者Chin-Erdene Gantulga