如何在Flutter应用中通过用户名搜索AWS Cognito中的用户

核心思路 #

Cognito原生没有开放客户端可直接调用的"按用户名搜索"接口，需通过两种合规方式实现：借助管理员权限调用ListUsers API（后端封装），或批量导出用户数据到自定义存储后查询。

方案一：后端封装ListUsers API（推荐） #

Cognito的ListUsers API支持通过过滤规则匹配用户名，但该接口属于管理员操作，不能直接在Flutter客户端执行，需通过Lambda函数封装后供前端调用。

1. 编写Lambda函数（Node.js示例）

   const AWS = require('aws-sdk');
   const cognito = new AWS.CognitoIdentityServiceProvider();
   
   exports.handler = async (event) => {
       const { keyword } = event.queryStringParameters;
       const params = {
           UserPoolId: '你的用户池ID',
           Filter: `username contains "${keyword}"` // 支持前缀匹配^=、精确匹配=、包含匹配contains
       };
       try {
           const result = await cognito.listUsers(params).promise();
           // 仅返回前端需要的字段，如username、email等
           const filteredUsers = result.Users.map(user => ({
               username: user.Username,
               email: user.Attributes.find(attr => attr.Name === 'email')?.Value
           }));
           return {
               statusCode: 200,
               body: JSON.stringify(filteredUsers)
           };
       } catch (err) {
           return {
               statusCode: 500,
               body: JSON.stringify({ message: '搜索失败', error: err.message })
           };
       }
   };
   

2. 配置API Gateway
   将Lambda函数封装为REST API，开启CORS允许Flutter前端访问，同时可添加API密钥或Cognito用户认证防止恶意调用。

3. Flutter前端调用（http包示例）

   import 'package:http/http.dart' as http;
   import 'dart:convert';
   
   Future<List<Map<String, dynamic>>> searchUsers(String keyword) async {
       final url = Uri.parse('你的API Gateway地址?keyword=$keyword');
       final response = await http.get(url);
       
       if (response.statusCode == 200) {
         return List<Map<String, dynamic>>.from(json.decode(response.body));
       } else {
         throw Exception('搜索用户失败：${response.body}');
       }
   }
   

方案二：批量导出到自定义数据库（适合小规模用户池） #

若用户池规模较小，可定期导出Cognito用户数据到DynamoDB，前端直接查询数据库实现搜索：

• 登录Amplify Admin UI，进入用户池页面，选择"导出用户"获取CSV格式的用户数据。
• 编写脚本将CSV数据导入DynamoDB，并将username设为全局二级索引。
• Flutter端通过Amplify DataStore或DynamoDB SDK直接查询索引实现搜索。

关键注意事项 #

• ListUsers的过滤规则需符合Cognito语法：前缀匹配用username ^= "xxx"，精确匹配用username = "xxx"，包含匹配用username contains "xxx"。
• 管理员权限需严格管控，Lambda函数仅保留必要的Cognito访问权限，避免权限过大导致数据泄露。

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