inspired-by-atmosphere/ops-troubleshooting-skills/windows-biometric-troubleshooting

Windows Hello 生物识别排障（指纹/人脸）

修复 Windows Hello 指纹/人脸识别：录入失败、残留模板、PIN 重设后的凭据-模板失联。本机 ThinkBook 16+ 传感器 = Goodix MOC Fingerprint（USB\VID_27C6）。

触发场景

• "重置指纹识别" / "指纹录不上" / 录入报"已有相似指纹"
• 重设 PIN 后指纹全部失效，设置里显示无指纹
• 指纹识别失败但设备管理器看不出问题

先诊断，再动手

1. 设备健康：powershell.exe -NoProfile -Command "Get-PnpDevice -Class Biometric | Select-Object Status, FriendlyName, InstanceId | Format-List"

• Status=OK → 传感器/驱动正常，问题在凭据层，别去重装驱动；Status=Error/Unknown 才查驱动

1. 模板数据库：%SystemRoot%\System32\WinBioDatabase\*.DAT（每用户一个文件，看修改时间找活跃模板）

机制：为什么重设 PIN 会留下"相似指纹"坑

重设 PIN 重建 Windows Hello NGC 凭据，但指纹模板残留在 WinBioDatabase 且与新凭据失联 → 设置页显示"无指纹"，录入时驱动检出旧模板报"已有相似指纹"。此时 GUI 没有删除按钮可点，唯一出路是清模板数据库。

修复流程（GUI 优先，按序走）

1. 重启电脑 — 凭据重建后 WBF 服务状态常未刷新，重启后设置页常自动出现「删除」按钮，零成本先试
2. GUI：Win+I → 账户 → 登录选项 → 指纹识别(Windows Hello) → 删除 → 设置 → 重录
3. 仍无删除按钮或报相似指纹 → 清 WinBioDatabase（需管理员）：

• 先 net session >/dev/null 2>&1 测权限（git-bash 非管理员删 System32 下文件报 Permission denied）
• 停 WbioSrvc → 备份 .DAT 到用户可写处 → 删 .DAT → 启 WbioSrvc（现成脚本见 templates/reset-fingerprint.bat）
• 跑完重录：多录几个手指、变换按压角度，识别率远高于单指

用户偏好（实测）

• 用户明确要面向用户的操作：先给 GUI 步骤；必须脚本化时交付 .bat 让用户右键→「以管理员身份运行」，禁 agent 自己提权执行——UAC 弹窗留给用户点
• .bat 内容全英文（cmd 按 GBK 读无 BOM 文件，中文必乱码），文件放 <tools-dir>\（小工具统一存放目录）
• 删 System32 下数据前必须备份到用户可写路径（桌面/用户目录），删了没后悔药

Pitfalls

• 停 wbiosrvc 失败 = 有程序正占用指纹读取器，关掉再试
• 必须先停服务再删 DAT，否则文件被锁删不掉
• 备份副本确认新指纹可用后再让用户删掉，别留两套模板互相打架

支持文件

• templates/reset-fingerprint.bat — 清 WinBioDatabase 模板的完整脚本（备份→停服务→删→启服务），可直接交付或改路径复用