Appwrite Flutter创建Email Session报401无效凭证问题求助

我在Appwrite管理控制台创建了用户，尝试通过Flutter客户端调用createEmailSession接口登录时，返回401无效凭证错误。已确认代码及调用方式无问题——Flutter客户端注册的用户可正常登录创建会话；甚至曾误操作仅输入邮箱就成功登录。但在控制台编辑该用户密码后，使用邮箱+密码登录就触发401错误。

登录方法代码示例：

@override
Future<Either<Failure, Session>> createEmailSession(
    {required String email, required String password}) async {
  Account account = Account(client);
  try {
    var res = await account
        .createEmailSession(
            email: email.toString(), password: password.toString());
    return Right(res);
  } on AppwriteException catch (e) {
    return Left(LoginFailure(e.message.toString()));
  }
}

原因分析 #

• 控制台创建用户时，若未正确配置密码哈希算法，输入的明文密码不会被正确加密存储，导致客户端传入的明文密码无法匹配后台的哈希值。
• 仅输入邮箱就能登录，说明该用户的密码字段为空或未初始化，Appwrite在这种场景下允许无密码登录（取决于权限配置），但修改密码后，错误的哈希存储导致验证失败。

解决方法 #

• 通过API重置用户密码：不要用控制台直接修改密码，改用Appwrite的updatePassword接口（Flutter客户端或Server SDK均可），确保密码被正确哈希存储。示例代码：

Future<void> resetUserPassword(String newPassword) async {
  Account account = Account(client);
  await account.updatePassword(
    password: newPassword,
    oldPassword: null, // 若用户之前无有效密码，传null即可
  );
}

• 规范控制台用户创建流程：在控制台创建用户时，确认选择默认的bcrypt哈希算法，禁止手动修改数据库中的密码字段，所有密码操作必须通过官方接口完成。
• 校验用户密码状态：调用getUser接口查看用户的passwordUpdateAt字段，如果该字段为null，说明密码未被有效设置，需要重新通过API设置。

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