如何以管理员身份在Flutter Appwrite中创建并管理用户？

首先明确：新版Appwrite Flutter SDK中，管理员创建/管理其他用户要用Users类（复数），而Account类仅用于当前登录用户的自我操作（比如改自己的资料、登出），旧教程里的User(client)写法已被废弃。

核心实现步骤 #

1. 初始化管理员客户端

创建用户属于管理级操作，需要使用带有users.write权限的API密钥（注意：生产环境不要在Flutter客户端直接硬编码API密钥，建议通过自建后端或Appwrite Functions中转调用，避免密钥泄露）。

import 'package:appwrite/appwrite.dart';

final Client adminClient = Client()
    .setEndpoint('https://你的Appwrite端点/v1')
    .setProject('你的项目ID')
    .setKey('拥有users.write权限的API密钥');

final Users usersApi = Users(adminClient);

2. 创建带自定义资料与身份标签的用户

通过usersApi.create()方法创建独立登录用户，同时传入自定义资料（生日、地址）和身份标签（客户、编辑）：

Future<void> createManagedUser() async {
  try {
    final User newUser = await usersApi.create(
      userId: ID.unique(), // 自动生成唯一用户ID
      email: 'new_user@example.com',
      password: 'StrongPass123!',
      name: '新用户姓名',
      // 自定义资料：生日、地址等
      metadata: {
        'birthday': '1995-05-20',
        'address': 'XX市XX区XX路XX号'
      },
      // 身份标签：用于后续权限区分
      labels: ['customer', 'editor'],
    );
    print('用户创建成功，ID：${newUser.id}');
  } on AppwriteException catch (e) {
    print('创建失败：${e.message}');
  }
}

3. 身份权限的进阶管理（可选）

如果需要更细粒度的权限控制，建议使用Appwrite的Teams功能：

• 创建对应身份的团队（如「编辑团队」「客户团队」）
• 将新创建的用户加入对应团队，通过团队权限控制资源访问

示例代码：

final Teams teamsApi = Teams(adminClient);

// 创建编辑团队（仅需执行一次）
await teamsApi.create(
  teamId: ID.unique(),
  name: 'Editors',
);

// 将用户加入编辑团队
await teamsApi.createMembership(
  teamId: '你的编辑团队ID',
  userId: '新创建的用户ID',
  roles: ['editor'], // 团队内角色
);

4. 普通用户独立登录

创建的用户可以通过Account类完成登录操作：

final Client userClient = Client()
    .setEndpoint('https://你的Appwrite端点/v1')
    .setProject('你的项目ID');

final Account userAccount = Account(userClient);

// 用户登录
await userAccount.login(
  email: 'new_user@example.com',
  password: 'StrongPass123!',
);

// 用户自行修改自定义资料
await userAccount.updatePrefs(
  prefs: {
    'address': '更新后的地址'
  },
);

关键注意点 #

• Users类用于管理所有用户（管理员操作），Account类仅用于当前用户的自我操作，二者不可混淆。
• 生产环境务必避免在Flutter客户端暴露API密钥，推荐用后端代理或Appwrite Functions处理管理员级操作。
• 自定义资料存储在metadata（创建时）或用户prefs（用户自行修改）中，可根据业务需求选择。

内容的提问来源于stack exchange，提问作者Maenda