调用signUp()前，Cognito是否有查询指定用户名是否存在的方法？

一、查询特定用户名是否已存在 #

有两种方案实现预注册的用户名校验：

• 方案1：捕获signUp()的错误
  直接调用Cognito的signUp()方法，若用户名已存在，会抛出UsernameExistsException错误，捕获该错误即可判断用户名重复。这种方式无需额外接口调用，是最简便的实现方式。
• 方案2：通过Admin级API主动校验
  如果需要在调用signUp()前提前查询，可使用AdminGetUser API——传入目标用户名，若接口返回用户信息则表示存在，若抛出UserNotFoundException则表示不存在。注意该API需要管理员权限，不能在前端直接调用，必须通过后端服务中转。

二、查询指定用户名的用户属性 #

fetchUserAttributes()仅支持获取当前登录用户的属性，要查询其他用户的属性，ListUsers API确实适用，但同样需要管理员权限，必须通过后端服务调用：

• 调用ListUsers时，通过Filter参数指定用户名（格式如username = "目标用户名"），并将Limit设为1，就能快速获取目标用户的属性列表。

三、Flutter中的实现逻辑 #

由于管理员级API不能直接在前端使用，需通过后端中间层处理，以下是完整流程示例：

后端示例（Node.js） #

const AWS = require('aws-sdk');
const express = require('express');
const app = express();

const cognito = new AWS.CognitoIdentityServiceProvider({ region: '你的AWS区域' });
app.use(express.json());

// 检查用户名是否存在
async function checkUserExists(username) {
  try {
    await cognito.adminGetUser({
      UserPoolId: '你的用户池ID',
      Username: username
    }).promise();
    return true;
  } catch (err) {
    return err.code === 'UserNotFoundException' ? false : Promise.reject(err);
  }
}

// 获取指定用户的属性
async function getUserAttributes(username) {
  try {
    const res = await cognito.listUsers({
      UserPoolId: '你的用户池ID',
      Filter: `username = "${username}"`,
      Limit: 1
    }).promise();
    return res.Users.length > 0 ? res.Users[0].Attributes : null;
  } catch (err) {
    return Promise.reject(err);
  }
}

// 暴露供Flutter调用的接口
app.post('/check-username', async (req, res) => {
  try {
    const exists = await checkUserExists(req.body.username);
    res.json({ exists });
  } catch (err) {
    res.status(500).json({ error: err.message });
  }
});

app.post('/get-user-attrs', async (req, res) => {
  try {
    const attrs = await getUserAttributes(req.body.username);
    res.json({ attributes: attrs });
  } catch (err) {
    res.status(500).json({ error: err.message });
  }
});

app.listen(3000, () => console.log('后端服务启动'));

Flutter前端调用示例 #

import 'dart:convert';
import 'package:http/http.dart' as http;

// 检查用户名是否存在
Future<bool> checkUsernameExists(String username) async {
  final response = await http.post(
    Uri.parse('http://你的后端服务地址/check-username'),
    body: jsonEncode({'username': username}),
    headers: {'Content-Type': 'application/json'},
  );
  if (response.statusCode == 200) {
    return jsonDecode(response.body)['exists'];
  }
  throw Exception('查询失败：${response.body}');
}

// 获取指定用户属性
Future<List<dynamic>?> getUserAttributes(String username) async {
  final response = await http.post(
    Uri.parse('http://你的后端服务地址/get-user-attrs'),
    body: jsonEncode({'username': username}),
    headers: {'Content-Type': 'application/json'},
  );
  if (response.statusCode == 200) {
    return jsonDecode(response.body)['attributes'];
  }
  return null;
}

注意事项 #

• 绝对不要在Flutter前端直接配置AWS管理员凭证，否则会造成密钥泄露，引发安全风险。
• 若注册场景对预校验的实时性要求不高，优先选择捕获signUp()的UsernameExistsException错误，减少额外的接口调用成本。

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