身份证核验接口的 10 个常见问题：签名、超时、格式与流程排查
身份证核验接入十大高频问题:签名三因(排序/时钟/编码)、超时重复计费、高峰限流、虚假不一致来源、批量数据清洗、失败分层引导、三态流水对账。每题现象-原因-修法。
上篇讲过接入全流程的六个环节，其中联调与上线之间的"异常路径设计"是最容易偷工减料的一环。这篇把主词"身份证核验"场景下最容易出错的十个点汇总成排查手册——每个都来自真实的接入咨询，按"现象 → 原因 → 修法"给出。
签名类：接入期 50% 的问题在这里
1. 签名错误，但本地用文档示例算完全一致
三种可能，按出现频率排序：
修法：签名模块上线前做三件事——字典序排序断言、NTP 同步 + 时间偏移自检、中文参数逐字节打印核对。
2. 含生僻字或间隔号的姓名必然失败
少数民族姓名的间隔号（·）有多个 Unicode 变体（全角点、中点、半角点），用户输入什么取决于输入法。修法：入口处统一归一化为 ·（U+00B7），并引导用户对照证件原件录入。这条处理不好，你的"不一致率"会虚高一截。
超时类：钱和状态的麻烦都在这
3. 超时后重试，被重复计费
超时的请求可能实际已成功（响应包没回来而已），直接重试就是第二笔计费。修法是纪律性的：超时后先查状态，结果未知才重试，重试必带幂等键。这套逻辑的完整设计见先查后重的接口模式。
4. 高峰期超时率飙升
平峰正常、高峰（报名季、活动日）集中超时——说明你顶到了并发配额，请求在排队，排队延迟被算进了读超时。修法：读超时上调至 30s 量级 + 客户端主动限流，把瞬时并发压到配额的 70%。
格式类：虚假"不一致"的主要来源
5. 真名真号，返回"不一致"
按概率排查，别急着怀疑数据源：
x 大小写（本平台接口要求转小写 x，传大写 X 返回 1103）；前三种是格式噪声，归一化后再发起核验。完整的分级排查见不一致五步排查法。
6. 批量导入的数据"不一致率"异常高
单条测试正常，批量跑不一致率 10%+——几乎可以断定是源数据质量问题：Excel 导入的隐形字符、全角数字、繁体字。修法：批量前先跑一遍格式清洗（去空白、全角转半角、简繁判断），把清洗日志留档。
流程类：设计缺陷的 late symptoms
7. 用户改一个字就要重新走全流程
核验失败的引导路径没分层：格式错误（可当场改正重试）和真实不符（需人工复核）走的是同一条"拒绝"路径，用户重填整表单。修法：按返回码分层引导——格式类错误当场重填，真实不符才走人工。
8. 对账时发现一批"消失"的调用
发起方记录了请求，账单里却没有——通常是参数校验被拒的请求（未计费）被发起方记成了有效调用。修法：本地流水按"已受理/已拒绝/结果未知"三态记录，别把发出 = 成功。
9. 服务商维护窗口没有预案
接到维护公告，业务方不知道，用户看到的是随机报错。修法：接入时确认服务商的维护通知机制，订阅公告通道，并在业务侧准备"核验暂不可用"的友好降级文案与排队补验机制。
10. 测试环境与生产环境的行为差异
用测试额度联调一切正常，上生产后开始遇到限流——测试配额和生产配额是两套。修法：上线前确认生产配额参数，压测按生产配额做；把两套环境的差异写进上线检查单。
速查表
| 现象 | 先查 | 深入阅读 |
|---|
| 签名错误 | 排序 → 时钟 → 编码 | 本篇 1-2 |
|---|---|---|
| 超时/重复计费 | 先查后重 → 幂等键 | 本篇 3-4 |
| 虚假不一致 | 归一化 → 格式清洗 | 本篇 5-6 |
| 流程问题 | 分层引导 → 三态流水 | 本篇 7-9 |
相关阅读
十个问题里八个能在联调期发现——不要跳过免费额度的四类返回码测试，那是成本最低的排错窗口。