学校用户ReCaptcha v3评分低引发AppCheck报错，求排查方向

问题背景 #

你的Flutter/Dart Web应用已通过ReCaptcha v3完成Firestore AppCheck集成，但有5%请求被标记为可疑，且部分学校的学生在启动应用时触发AppCheck错误，对应的ReCaptcha返回评分仅0.1，问题呈现学校特异性。以下是具体的排查方向和可采取的措施：

排查与解决方向 #

1. 学校网络环境检测

• 检查学校是否使用统一出口代理或防火墙：大量学生通过同一公网IP访问，且短时间内发起重复验证请求，会被ReCaptcha判定为自动化行为；部分防火墙可能拦截ReCaptcha用于采集行为数据的脚本或请求，导致特征缺失评分降低。
• 排查网络安全工具：学校部署的内容过滤、广告拦截或终端安全软件，可能阻止ReCaptcha的核心脚本加载，或屏蔽浏览器行为数据（如鼠标移动、页面交互轨迹）的上报，影响评分计算。

2. 设备与浏览器配置验证

• 检查学校公共设备/浏览器的统一配置：是否禁用了Cookie、本地存储，或限制了JavaScript API（如Canvas指纹、WebGL、Navigator接口）——这些是ReCaptcha识别设备唯一性的关键依据，缺失会导致评分异常。
• 确认是否使用共享设备：机房公共电脑被多名学生频繁切换使用，设备特征的快速变化可能被判定为可疑行为。

3. 并发请求的影响确认

你提到的30名学生几乎同时启动应用确实可能导致评分偏低。ReCaptcha会将同一IP/环境下的短时间高频重复请求识别为批量自动化操作，直接拉低评分。这类场景下，建议优化应用启动流程，比如将验证请求延迟到用户首次交互后（而非启动即触发），分散请求峰值。

4. ReCaptcha配置优化

• 调整Action命名：示例中使用的submit与应用启动场景不匹配，建议改为更贴合的名称（如app_init或student_login），帮助ReCaptcha更精准识别行为场景，提升评分准确性。
• 核对域名白名单：确保在ReCaptcha后台已添加学校可能使用的所有域名（包括子域名），避免因域名验证不通过导致的评分降级。

5. 针对性测试步骤

• 单用户非高峰测试：让学校的单个学生在非上课时段（无大量并发）启动应用，验证是否正常，确认是否由并发导致问题。
• 跨网络对比测试：让学生使用手机热点（避开学校网络）启动应用，若恢复正常，则可定位为学校网络环境问题。
• 浏览器控制台排查：让出现问题的学生打开浏览器开发者工具，检查是否有ReCaptcha脚本加载失败、请求被拦截的报错信息，这些细节能直接定位问题根源。

内容的提问来源于stack exchange，提问作者Marc Van Daele