修复证件上传和读取问题
证件上传和 OCR 问题大多可以归结为图像质量、缺少背面图像、不被允许的子类型，或者用了复印件而不是原件 - 以下是逐一排查和修复的方法。
按这个顺序排查：工作流是否允许该子类型、是否采集了背面图像、图像质量是否达标， 以及照片是否为原始拍摄而非截图或扫描件。 这四项几乎覆盖了所有情况。
如果证件上传失败，或者关键字段没有被正确提取，几乎总是几个已知原因之一。 下面逐一说明排查方法。
#首先：这个证件是否被允许？
在排查图像质量之前，先确认你的工作流是否接受该国家/地区的这个具体证件子类型。 不被允许的子类型失败起来看着像读取问题，但其实不是 - 而且它会让持有这种格式证件的每一位用户都失败，而不只是某一个人。 参见子类型是证件被拒的常见原因。
#图像模糊、过暗或过曝
Didit 在处理证件之前会先检查图像质量，如果图像过于模糊、过暗或过亮，会要求用户重新拍摄。 请提醒用户：
- 使用均匀充足的光线，避免直射眩光
- 手持相机保持稳定，让相机先对焦再拍摄
- 让证件的四个角都保持在取景框内
- 把证件从塑料证件套中取出 - 反光会导致自动拍摄失败
用户可重拍的次数有限；在最后一次允许的尝试中，图像会被直接接受，因此用户不会被永久卡住，但低质量的拍摄仍可能导致部分字段无法读取。
检查会话的警告中是否出现 IMAGE_TOO_BLURRY、IMAGE_TOO_DARK 或 IMAGE_TOO_BRIGHT，以确认这就是原因。
如果模糊的证件正在通过甚至被批准，说明门槛相对于您的风险偏好太低了。工作流证件核验步骤中的两项设置可以解决：
- 最低图像质量（质量滑块）：每张证件照片在拍摄的瞬间由质量模型评分，低于您设定最低值的拍摄会被立即拒绝并要求重拍。默认值刻意宽松；调高它，得分33的模糊证件背面就永远到不了检查环节。
- 拍摄图像确认页面（在高级下）：向用户展示刚拍的照片，要求在上传前确认或重新扫描。仅适用于相机扫描，因为上传文件本身已有预览。
质量分数本身就在会话报告里，您可以查看那些让您担忧的会话，然后把阈值设在略高于它们的位置。
#字段未被检测到或被读错（姓名、出生日期、证件号码）
当 OCR 无法提取某个特定字段时，这本身通常不会拒绝会话 - 默认情况下它会被路由到人工审核，交由人工检查。
如果这种情况在某一种证件类型或某一种语言上频繁出现，请检查工作流中的首选字符格式设置：选择提取出的姓名应规范化为拉丁字符，还是保留证件原始文字。 这项设置不匹配，是西里尔文、阿拉伯文、希腊文或汉字证件上姓名字段出现乱码或缺失的常见原因。
当提取出的值是错误的（姓氏错了一个字母、地址进了姓名字段）时，请参阅修正被读错的姓名或字段：支持团队无法替您编辑，但用户数据确认步骤、update-data API和重新提交都能做到。
#截图、打印件和屏幕翻拍照片会被拒绝
Didit 要求提供实体证件的原始、实时拍摄照片 - 而不是截图、扫描件、打印复印件，或者拍摄另一块屏幕上显示的证件照片。 证件活体检测正是为了识别这些情况而设计的，会标记或拒绝该会话。 请让用户直接拍摄实体证件。
这是刻意为之的设计：如果接受"照片的照片"，证件核验本身的大部分价值就会失去意义。
屏幕截图检测器偶尔会对在杂乱背景下拍摄的真实证件触发，比如键盘、带花纹的桌面、证件后面的显示器。如果您已查看图片且证件明显是真的，请自行批准会话：该标记之所以进入审核，正是为了让人做出这个判断。每个证件活体信号（屏幕截图、打印复印件、人像替换）在该步骤的防伪设置中都有各自的审核和拒绝阈值，如果某一项对您的流量过于敏感，可以调整。
#缺少背面图像
身份证和驾驶证是双面证件 - Didit 需要正面和背面图像才能完成信息提取。 如果这类证件只提交了正面图像，会话就不会拥有它所需要的数据。
如果用户持续卡在背面拍摄这一步，请检查你所询问的这种证件在该国家/地区是否真的在背面印有可读取的数据。 要求提供一份实际没有任何内容的背面图像，只会让用户白白失败一个步骤，却没有任何好处。
#摄像头始终无法打开
这看起来像是证件问题，其实是环境问题：
- 应用内置浏览器。 在其他应用（例如聊天应用）内置浏览器中打开的链接，往往无法获取摄像头权限。在手机的常规浏览器中打开同一个链接即可解决。
- 权限此前被拒绝。 一旦有人拒绝了某个网站的摄像头权限，浏览器会记住这个选择。他们必须在网站设置中重新授权；流程无法再次弹出请求。
- 摄像头正被占用。 另一个标签页或应用占用摄像头会导致其被阻塞。在部分设备上，授予麦克风权限也可能连带占用摄像头。
#流程中的文字看起来是乱码
如果用户反馈界面上（不是证件上）出现了乱码或不知所云的文字，通常的原因是浏览器的网页翻译插件重写了屏幕内容。 请让他们为该页面关闭翻译功能 - 流程本身已经提供了自己的多语言支持。 参见设置核验语言。
#OCR 支持多少种语言？
Didit 的 OCR 可以读取超过 130 种语言的证件，这是其证件与国家覆盖范围的一部分。 这与核验页面本身的界面语言是两回事，界面语言默认由用户的浏览器自动设置，除非你显式指定。
#仍然没有解决？
请携带受影响核验的会话 ID联系支持团队 - 这是团队调查具体案例最快的方式，因为这样他们可以准确看到你所描述的图像和警告。