# 修复证件上传和读取问题

Source: https://help.didit.me/zh/documents-coverage/document-upload-problems
Updated: 2026-09-15

证件上传和 OCR 问题大多可以归结为图像质量、缺少背面图像、不被允许的子类型，或者用了复印件而不是原件 - 以下是逐一排查和修复的方法。

按这个顺序排查：工作流是否**允许该子类型**、是否采集了**背面图像**、图像**质量是否达标**，
以及照片是否为原始拍摄而非截图或扫描件。
这四项几乎覆盖了所有情况。

[Video: 自动证件拍摄：证件一入画即自动拍摄 - Didit Academy](https://www.youtube.com/watch?v=e1nmOvyHZnk)

如果证件上传失败，或者关键字段没有被正确提取，几乎总是几个已知原因之一。
下面逐一说明排查方法。

## 首先：这个证件是否被允许？

在排查图像质量之前，先确认你的工作流是否接受该国家/地区的这个具体证件**子类型**。
不被允许的子类型失败起来看着像读取问题，但其实不是 - 而且它会让持有这种格式证件的每一位用户都失败，而不只是某一个人。
参见[子类型是证件被拒的常见原因](https://help.didit.me/zh/documents-coverage/supported-documents-and-countries)。

## 图像模糊、过暗或过曝

Didit 在处理证件之前会先检查图像质量，如果图像过于模糊、过暗或过亮，会要求用户重新拍摄。
请提醒用户：

- 使用均匀充足的光线，避免直射眩光
- 手持相机保持稳定，让相机先对焦再拍摄
- 让证件的四个角都保持在取景框内
- 把证件从塑料证件套中取出 - 反光会导致自动拍摄失败

用户可重拍的次数有限；在最后一次允许的尝试中，图像会被直接接受，因此用户不会被永久卡住，但低质量的拍摄仍可能导致部分字段无法读取。
检查会话的警告中是否出现 `IMAGE_TOO_BLURRY`、`IMAGE_TOO_DARK` 或 `IMAGE_TOO_BRIGHT`，以确认这就是原因。

**如果模糊的证件正在通过甚至被批准**，说明门槛相对于您的风险偏好太低了。工作流证件核验步骤中的两项设置可以解决：

- **最低图像质量**（质量滑块）：每张证件照片在拍摄的瞬间由质量模型评分，低于您设定最低值的拍摄会被立即拒绝并要求重拍。默认值刻意宽松；调高它，得分33的模糊证件背面就永远到不了检查环节。
- **拍摄图像确认页面**（在高级下）：向用户展示刚拍的照片，要求在上传前确认或重新扫描。仅适用于相机扫描，因为上传文件本身已有预览。

质量分数本身就在会话报告里，您可以查看那些让您担忧的会话，然后把阈值设在略高于它们的位置。

## 字段未被检测到或被读错（姓名、出生日期、证件号码）

当 OCR 无法提取某个特定字段时，这本身通常**不会**拒绝会话 - 默认情况下它会被路由到人工审核，交由人工检查。

如果这种情况在某一种证件类型或某一种语言上频繁出现，请检查工作流中的**首选字符格式**设置：选择提取出的姓名应规范化为拉丁字符，还是保留证件原始文字。
这项设置不匹配，是西里尔文、阿拉伯文、希腊文或汉字证件上姓名字段出现乱码或缺失的常见原因。

当提取出的值是错误的（姓氏错了一个字母、地址进了姓名字段）时，请参阅[修正被读错的姓名或字段](https://help.didit.me/zh/verification-sessions/correct-extracted-data)：支持团队无法替您编辑，但用户数据确认步骤、update-data API和重新提交都能做到。

## 截图、打印件和屏幕翻拍照片会被拒绝

Didit 要求提供实体证件的原始、实时拍摄照片 - 而不是截图、扫描件、打印复印件，或者拍摄另一块屏幕上显示的证件照片。
证件活体检测正是为了识别这些情况而设计的，会标记或拒绝该会话。
请让用户直接拍摄实体证件。

这是刻意为之的设计：如果接受"照片的照片"，证件核验本身的大部分价值就会失去意义。

屏幕截图检测器偶尔会对在杂乱背景下拍摄的真实证件触发，比如键盘、带花纹的桌面、证件后面的显示器。如果您已查看图片且证件明显是真的，**请自行批准会话**：该标记之所以进入审核，正是为了让人做出这个判断。每个证件活体信号（屏幕截图、打印复印件、人像替换）在该步骤的防伪设置中都有各自的审核和拒绝阈值，如果某一项对您的流量过于敏感，可以调整。

## 缺少背面图像

身份证和驾驶证是双面证件 - Didit 需要正面和背面图像才能完成信息提取。
如果这类证件只提交了正面图像，会话就不会拥有它所需要的数据。

如果用户持续卡在背面拍摄这一步，请检查你所询问的这种证件在该国家/地区是否真的在背面印有可读取的数据。
要求提供一份实际没有任何内容的背面图像，只会让用户白白失败一个步骤，却没有任何好处。

## 摄像头始终无法打开

这看起来像是证件问题，其实是环境问题：

- **应用内置浏览器。** 在其他应用（例如聊天应用）内置浏览器中打开的链接，往往无法获取摄像头权限。在手机的常规浏览器中打开同一个链接即可解决。
- **权限此前被拒绝。** 一旦有人拒绝了某个网站的摄像头权限，浏览器会记住这个选择。他们必须在网站设置中重新授权；流程无法再次弹出请求。
- **摄像头正被占用。** 另一个标签页或应用占用摄像头会导致其被阻塞。在部分设备上，授予麦克风权限也可能连带占用摄像头。

## 流程中的文字看起来是乱码

如果用户反馈界面上（不是证件上）出现了乱码或不知所云的文字，通常的原因是浏览器的网页翻译插件重写了屏幕内容。
请让他们为该页面关闭翻译功能 - 流程本身已经提供了自己的多语言支持。
参见[设置核验语言](https://help.didit.me/zh/workflows/verification-languages)。

## OCR 支持多少种语言？

Didit 的 OCR 可以读取超过 130 种语言的证件，这是其[证件与国家覆盖范围](https://help.didit.me/zh/documents-coverage/supported-documents-and-countries)的一部分。
这与核验页面本身的界面语言是两回事，界面语言默认由用户的浏览器自动设置，除非你显式指定。

## 仍然没有解决？

请携带受影响核验的**会话 ID**[联系支持团队](mailto:support@didit.me) - 这是团队调查具体案例最快的方式，因为这样他们可以准确看到你所描述的图像和警告。