使用AWS Rekognition索引人脸并关联MySQL userId的正确方法

• 开发场景：基于Node.js为Electron应用接入人脸识别能力，使用aws-sdk对接AWS Rekognition服务
• 实现目标：拍摄用户照片后，在Rekognition已注册人脸库中检索匹配项，返回对应记录在MySQL数据库中的userId
• 前置准备：已创建ID为Users的Rekognition人脸集合（Collection），初期规划每个用户仅支持录入1张人脸照片

人脸注册逻辑 #

调用indexFaces接口录入人脸，当前通过ExternalImageId字段传入MySQL中的用户ID：

const params = {
    CollectionId: 'Users',
    Image: { Bytes }, // 传入图片二进制数据
    ExternalImageId: '1', // 对应MySQL中存储的userId
    MaxFaces: 1,
    QualityFilter: 'HIGH'
};

Rekognition.indexFaces(params, (err, data) => {
    if (err) {
        console.log(err, err.stack);
        return;
    }
    console.log(data);
});

人脸检索逻辑 #

调用searchFacesByImage接口匹配待查询人脸：

const params = {
    CollectionId: 'Users',
    Image: { Bytes }, // 传入待查询图片二进制数据
    MaxFaces: 1,
    FaceMatchThreshold: 99
};

Rekognition.searchFacesByImage(params, (err, data) => {
    if (err) {
        console.log(err, err.stack);
        return;
    }
    for (let i = 0; i < data.FaceMatches.length; i++) {
        console.log(data.FaceMatches[i].Face);
    }
});

匹配成功返回结构 #

当待查询人脸在Collection中存在匹配记录时，返回结果如下：

{
  "FaceId": "b7506fc1-e8...",
  "BoundingBox": { /* 人脸坐标数据 */ },
  "ImageId": "e11d94c1-831...",
  "ExternalImageId": "1", // 预期拿到的MySQL userId
  "Confidence": 99.999...,
  "IndexFacesModelVersion": "6.0"
}

• 当前通过ExternalImageId属性关联Rekognition人脸记录与MySQL中userId的实现方式是否正确？
• 是否存在更规范合理的实现方案？如果存在应当如何调整？

你当前用ExternalImageId关联业务侧用户ID的做法完全正确，符合Rekognition的字段设计初衷。
ExternalImageId本身就是AWS预留给开发者存储自定义业务标识的字段，支持字母、数字、下划线、连字符格式，最大长度255字符，完全适配数字自增ID、字符串UUID等各类格式的userId，在单用户单张人脸的场景下，匹配成功后直接取返回值中的ExternalImageId作为用户ID查询MySQL即可，没有逻辑问题。

针对你当前的实现，有几个可落地的优化建议，适配生产环境使用：

• 注册人脸前增加重复校验：因为Rekognition不会自动对相同ExternalImageId的记录做去重，如果重复给同一个用户调用indexFaces，Collection中会生成多条同用户ID的人脸记录，既占用配额，也可能导致检索时返回重复结果。注册前可调用listFaces接口，传入CollectionId并指定ExternalImageId为当前待注册userId，如果查询到已有记录，要么先调用deleteFaces删除旧的人脸记录再录入新数据，要么直接返回“用户已注册”的提示。
• 调整匹配阈值到合理区间：你当前设置的FaceMatchThreshold=99阈值过严，实际使用中受光线、拍摄角度、面部遮挡（眼镜、口罩）、摄像头画质影响，本人匹配的置信度很可能落在90-99区间，硬卡99会导致正常用户识别失败。建议初期将阈值设置在85-90区间，后续根据实际测试的误识率、拒识率再做微调。
• 增加ID合法性校验：拿到返回结果中的ExternalImageId后，不要直接作为可信ID透传后续业务逻辑，需要先查MySQL确认该userId真实存在、状态正常，避免因为Rekognition和MySQL数据不同步（比如用户已在业务侧删除，但人脸库记录未清理）导致业务报错。
• 确认图片传参格式：注意Image.Bytes参数要求传入Buffer/Uint8Array类型的二进制数据，如果你直接传入base64编码字符串会触发参数错误，需要提前做格式转换。

如果后续需要扩展支持单用户录入多张人脸，当前的关联逻辑也不需要大改：给同个用户的多个人脸记录都传入相同的ExternalImageId即可，检索时对返回结果按ExternalImageId去重就能拿到正确的用户ID。

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