如何通过Appwrite Dart包根据指定邮箱获取用户ID？

开发者阿泽

2026-6-23

解决Appwrite Dart包精准查询指定邮箱用户ID的问题

问题根源

你之前误用了search参数——这个参数是全局模糊搜索，会在用户的所有可搜索字段（姓名、邮箱、手机号等）中匹配包含关键词的内容，所以才会出现：

搜user@domain.com时，返回所有邮箱含domain.com的用户（因为匹配到了域名部分）
搜Patrick时，返回所有资料里带这个字符串的用户（可能是姓名、邮箱备注等字段）

正确实现方式

要精准匹配邮箱并获取对应用户ID，需要使用queries参数，配合Query.equal做严格的字段匹配：

import 'package:appwrite/appwrite.dart';

void getUserIdByEmail() async {
  final client = Client()
    .setEndpoint('https://[你的Appwrite端点]/v1')
    .setProject('[你的项目ID]')
    .setKey('[你的API密钥]'); // 或根据权限配置使用用户会话

  final users = Users(client);

  try {
    final response = await users.list(
      queries: [Query.equal('email', 'user@domain.com')],
    );

    if (response.users.isNotEmpty) {
      // 邮箱是唯一字段，直接取第一个结果的ID
      final userId = response.users.first.$id;
      print('目标用户ID：$userId');
    } else {
      print('未找到该邮箱对应的用户');
    }
  } catch (e) {
    print('查询失败：$e');
  }
}