常见问题

常见问题概述

本文介绍以下类型的常见问题。

• 热点问题

• 售前常见问题

• 产品计费常见问题

• 售后费用咨询常见问题

• 技术支持常见问题

• 通用SDK使用常见问题

• Android SDK使用常见问题

• iOS SDK使用常见问题

• 服务端SDK使用常见问题

• OSS空间类常见问题

• 如何配置代理网络

热点问题

实人认证、金融级、增强版有什么区别？

金融级实人认证各方案与信息核验有什么区别，该如何选择？

金融级实人认证产品是否支持微信场景，例如微信小程序、微信公众号？

• 微信公众号：您可以参考金融级PC或移动端H5网页集成方式，实现用户自助刷脸认证流程。具体接入步骤，请参见PC或移动端H5网页接入。

• 微信小程序：由于微信运营审核要求，不支持第三方认证插件。若您的业务可获取用户授权的人脸图片或视频，用于验证身份一致性，可参考纯服务端集成方式。具体接入步骤，请参见纯服务端（API）接入。

金融级实人认证业务策略限制不通过，报错206？

为什么认证失败不足20次，就出现418错误提示？

是否必须购买流量包，如何查看流量包剩余流量，如何设置预警？

开通金融级实人认证服务，默认为按天后付费方式。您需要保持开通服务的阿里云账号资金状态正常，才可以正常使用。流量包为您提供不同规格的选择和折扣，可用于抵扣后付费的次数。流量包购买和使用记录查看、流量包自动告警规则设置，请参见资源实例管理。

查询接口没有该身份认证记录，报错424？

手机网络正常，App（SDK）集成时候提示2002网络错误？

若手机网站，部分手机验证返回2002网络错误，通常是该手机系统时间修改引发阿里云网关校验失败导致。您可以打开手机系统设置，查看系统默认时间，确认是否时间被调整，如若被调整，请您恢复手机系统默认时间后重试。

App（SDK）集成返回1001错误？

查询接口为什么没有返回认证过程的图片或视频？

• 确认认证关联的场景中已经开启是否存留认证资料。如何添加场景，请参见添加认证场景。

• 确认已经完成OSS授权且已经自动创建专属存储Bucket。Bucket命名不能修改也不能删除，否则也会影响您的照片回传。如何授权，请参见授权金融级实人认证访问OSS存储空间。

• 确认查询接口的CertifyId已经完成认证，客户端（App（SDK）或H5）已经收到刷脸成功1001或刷脸失败2006的回调通知。

• 确认SDK集成中，是否设置开启返回视频的配置，即extParams的ext_params_key_use_video参数。

售前常见问题

产品计费常见问题

金融级实人认证服务如何计费？

提供按天计费（后付费）和流量包抵扣调用量（预付费）两种付费方式，预付费含阶梯报价。关于计费的详细信息，请参见计费概述。您也可以咨询您的专属商务经理。

金融级实人认证与实人认证价格有什么差异？

价格一致。如需了解详细的计费信息，请参见金融级实人认证计费说明和实人认证计费说明。

后付费的开通入口在哪？

有关后付费方式的开通入口，请参见金融级实人认证（按量计费）。

如何使用预付流量包？

有关预付流量包的订购入口，请参见金融级实人认证流量包。

金融级实人认证是否支持免费体验？

支持免费体验。您可以访问阿里云免费试用申请试用资格。试用教程请参见使用Android App接入金融级实人认证方案。

售后费用咨询常见问题

购买了流量包，如何在流量用尽前收到提醒？

您可以设置剩余流量提醒。具体操作，请参见资源包管理。

如何进行对账？

技术支持常见问题

调用InitFaceVerify接口返回的CertifyId的有效期是多久？

在客户端发起刷脸请求之前，CertifyId有效期为30分钟，且仅能使用一次。

金融级实人认证初始化时，我输入假的身份信息，为什么没有显示报错？

调用API时会校验身份证号码的有效性，但基于安全性考虑，目前不会对身份校验。所有的人脸比对、身份核验都在刷脸端核验。

为什么录入的身份证信息是正确的，但没有返回CertifyId？

返回结果在response的data里，需要用户自己获取。

服务端的签名机制是怎样的？

有关服务端的签名机制，请参见接入金融级实人认证服务。

outerOrderNo参数代表什么？

客户服务端自定义的业务唯一标识，用于后续定位与排查问题使用。参数值最长支持32位的字母和数字组合的字符串，请确保唯一。

认证失败返回什么参数？

您可以通过查询接口获取认证未通过详细信息，包含认证不通过subcode、认证材料等信息。

活体检测的照片如果需要保存到本地，相关的API接口文档在哪里？

您可以调用查询认证请求（DescribeFaceVerify）接口，保存活体检测的照片。有关该接口的详细信息，请参见DescribeFaceVerify-获取认证结果。

除了查询认证结果留存图片外，有没有异步拉取图片的方式？

没有。留存图片属于隐私信息，需要加强管控。

认证查询接口中，图片返回是什么格式？

默认为OSS文件名和URL格式图片，也支持Base64格式。

是否支持在微信公众号的H5页面中调用手机支付宝的活体检测功能？

金融级实人认证服务不支持接入微信公众号的H5页面，但可以从您开发应用的服务端调用。

后台访问活体验证服务，上传视频还是图片（静默活体），图片需要传几张？

上传图片。纯服务端接入只需传入一张即可。

如何统计通过率？

您可以登录金融级实人认证控制台，在左侧导航栏，单击数据统计，在数据统计页面，您可以查看某个时间范围内的认证通过率。您也可以在左侧导航栏选择数据分析 > 产品分析，在通过/转化率（PV）区域查询通过率。

金融级实人认证比对分默认的阈值是多少，是否可以自行设置？

默认阈值是71.5，您也可以根据查询接口返回的比对分和建议阈值自定义业务逻辑。

金融级PictureUrl返回的URL有效期是多久？

有效期为15分钟。

通用SDK使用常见问题

用户手机修改系统时间后，为什么无法刷脸？

阿里云网关会校验设备上手机系统时间是否正确，建议用户开启手机时间自动设置，恢复系统默认时间后再次操作。

用户反馈按照界面提示正常操作，但刷脸动作不通过，是什么原因？

可能与用户的手机摄像头有关，建议清洁擦拭摄像头后再操作。

接入SDK报错“[10002]context为null，请调用APSecuritySdk.init”

初始化SDK时，如果实人认证流程正常，可忽略该错误。

Android SDK使用常见问题

本地IDE和手机测试无误，打包分发内测时，部分手机型号点击同意协议后闪退，应该如何处理？

内测打包时需要打开混淆。

本地IDE和手机测试无误，打包分发内测时，所有机型在点击采集人脸后闪退，应该如何处理？

混淆策略必须与接入文档严格一致。

SDK中的依赖冲突如何解决？

按照SDK模块使用方式可分为以下三种情况解决：

1. SDK中不使用的模块冲突：

   可进行SDK裁剪，排除不使用的模块，模块功能详见SDK包裁剪说明。

2. SDK中包含的公共依赖冲突：

   例如：业务App中依赖了一个ConflictingClass，而SDK包中也依赖了此类。

   这样产生的冲突可以使用构建工具提供的依赖排除功能，将其中一个包中的ConflictingClass排除即可。

   具体构建工具的依赖排除功能，请参考所使用构建工具的文档。（比如使用gradle构建，可搜索gradle排除依赖。）

3. SDK中包含了一个跟业务依赖中完全限定名一样但功能不同的类：

   此种情况可能出现在SDK和业务依赖引入了同一个依赖的不同版本。比如：SDK依赖了A1.0.arr，业务依赖引入了A2.0.arr。

   此种情况如果方法2不能解决问题，则需要联系依赖厂商进行依赖定制。

iOS SDK使用常见问题

调用startVerifyService时，iOS端SDK获得如下结果：resultStatus=4000，应该如何处理？

4000：系统异常。请提供CertifyId进行进一步排查。

跳转认证页面，同意协议并确认开始认证后，第一次认证初始化失败，弹出人气大爆发，应该如何处理？

客户端联网失败。请确认客户端可以正常联网，然后再试。

打包后第一次启动直接测试刷脸，从服务端获取URL正常，但无法唤起认证协议页。第二次启动，正常唤起。这是什么原因？

需要把apverifyservice初始化。

SDK支持的范围？

SDK支持armv7、i386、x86_64、arm64版本，iOS 9及以上的操作系统，机型需在iPhone 5s及以上。

如何解决iOS接入时报系统错误？

报错“-[ZimNetworkResult APBOverrideFromJSONData:]: unrecognized selector sent to instance 0x282975d10”

可能未在Linking > Other Linker Flags设置-ObjC。具体操作，请参见iOS接入。

服务端SDK使用常见问题

PHP处理CeritifyUrl时出现HTML转义，应该如何处理？

采用HTML逆转义。

在测试环境中，认证初始化请求报错：https://saf.cn-shanghai.aliyuncs.com:443, ServerUnreachable是什么原因？

这个域名是稳定的。如果出现ServerUnreachable，可能是测试的网络有限制或者DNS存在中断等问题。

本地环境，认证初始化部分请求报错如下，应该如何处理？

java.lang.IllegalStateException:Serverresponsehasabadformattype:RAWatcom.aliyuncs.reader.ReaderFactory.createInstance(ReaderFactory.java:16)atcom.aliyuncs.DefaultAcsClient.readError(DefaultAcsClient.java:372)atcom.aliyuncs.DefaultAcsClient.getCommonResponse(DefaultAcsClient.java:164)atcom.guohualife.ebiz.cIP.gateway.util.AliCloudJRUtil.aliCloudFaceCheck(AliCloudJRUtil.java:53)

文档中Java SDK示例的request.setQueryParameter 需要改为 request.setBodyParameter。原先写法是将参数在URL中拼接传输，在离线比对场景会造成URL过大（核验图片在140 KB上下，但阿里云POP要求不大于128 KB）。改为在body中传输可以避免这个问题（body要求不大于1 MB）。

调用接口时提示：com.alibaba.fastjson.JSONException: syntax error, pos 1, line 1, column 2，应该如何处理？

DNS解析出现异常，找不到URL对应的IP。请检查网络使用什么代理服务器，或者查看DNS服务是否存在中断等问题。

调用接口时提示如下错误，应该如何处理？

{"rspData":{"orderNo":"GB202002185110401116004974****","requestId":"883B3A40-B820-4013-8473-31C254CBD50F","retCode":"SignatureDoesNotMatch","retMsg":"Specifiedsignatureisnotmatchedwithourcalculation.serverstringtosignis:POST&%2F&AccessKeyId%3DLTAI4Fu4N5JUWyUS7VEW****%26Action%3DExecuteRequest%26Format%3Djson%26Service%3Dfin_face_verify

签名错误，检查AccessKey ID和AccessKey Secret是否正确，是否有空格，是否代码固化。

离线比对报出非法参数，应该如何处理？

POP超时时长过短，引发重试导致。应延长超时时长。

OSS空间类常见问题

使用金融级实人认证服务，必须开通对象存储OSS服务吗？

金融级实人认证服务部分方案需要将认证过程中采集的照片保存到您的OSS存储空间中，所以建议您开通对象存储OSS服务并完成授权。金融级实人认证会将采集到的人脸照片返回到您指定的OSS存储空间。

关于OSS存储空间的具体介绍，请参见什么是对象存储OSS。

关于如何开通对象存储OSS服务，请参见开通对象存储OSS服务。

已经在别的项目中开通了对象存储OSS服务的账号，需要怎么配置呢？

请参考页面引导操作授权开通即可。系统会自动创建一个存储空间，用于存储认证中的用户人脸图片。该操作对其他项目已经在使用的OSS存储空间没有任何影响。

对象存储OSS服务如何进行计费？

对象存储OSS服务的计费方式分为按量计费和包年包月两种。关于OSS的计费详情，请参见OSS计量计费。

如何删除OSS存储空间的照片？

如何配置代理网络

您可以选择金融级实人认证代理（包含正向代理和反向代理）、OSS对象访问反向代理方式中的一种方式。

其中正向代理用于认证客户端无法访问认证服务端的情况，反向代理用于多个认证服务端的容灾整合，具体操作如下：

金融级实人认证正向（认证客户端）代理

1. 在允许访问外部服务的区域创建一台代理服务器，并开放认证客户端服务器（应用服务器）对此代理服务器的访问，执行如下命令安装Nginx。

   yum install nginx

2. 执行如下命令，编辑/etc/nginx/nginx.conf配置文件。

   vim /etc/nginx/nginx.conf

   说明

   配置文件的路径请以实际路径为准，本文以/etc/nginx/nginx.conf配置文件为例。

3. 在config文件中的HTTP模块添加如下内容。

   server {
       resolver 127.0.0.1;       #指定DNS服务器IP地址 
       listen 80;
       location / {
           proxy_pass http://$http_host$request_uri;
       }
   }

4. 执行如下命令，确认添加的配置正常。

   nginx -t

5. 执行如下命令，启动Nginx。

   systemctl start nginx

6. 在客户端服务器上对SDK设置代理并测试，测试响应正常表示您代理设置成功。

   关于SDK源代码，请参见SDK包。

   // Client代理配置。
   HttpClientConfig clientConfig = HttpClientConfig.getDefault();
   // 设置HTTP代理。
   clientConfig.setHttpProxy("http://127.0.0.1:9898");
   // 设置HTTPS代理。
   clientConfig.setHttpsProxy("http://user:password@127.0.0.1:8989");
   // 设置忽略代理地址列表。
   clientConfig.setNoProxy("127.0.0.1,localhost");
   IClientProfile profile = DefaultProfile.getProfile(regionId, accesskeyId, accesskeySecret);
   profile.setHttpClientConfig(clientConfig);
   DefaultAcsClient client = new DefaultAcsClient(profile);

金融级实人认证反向（认证服务端）代理

1. 在允许访问外部服务的区域创建一台代理服务器，执行如下命令安装Nginx。

   yum install nginx

2. 执行如下命令，编辑/etc/nginx/nginx.conf配置文件。

   vim /etc/nginx/nginx.conf

   说明

   配置文件的路径请以实际路径为准，本文以/etc/nginx/nginx.conf配置文件为例。

3. 在config文件中的HTTP模块添加如下内容。

   server {
           listen 0.0.0.0:80;
           server_name cloudauth.aliyuncs.com
           resolver 223.5.5.5 223.6.6.6 valid=30s;
           location / {
               proxy_pass http://cloudauth.aliyuncs.com; 
               proxy_set_header Host $host; 
               access_log  /var/logs/nti-access.log;
               error_log   /var/logs/nti-error.log;
        }  
   }

4. 执行如下命令，确认添加的配置正常。

   nginx -t

5. 执行如下命令，启动Nginx。

   systemctl start nginx

6. 在本地应用服务器上，配置host并访问服务地址，网页响应正常表示您代理设置成功。

   您可以在Nginx反向代理服务器上的/var/logs/nti-access.log中查看访问日志。

OSS对象访问反向代理

1. 在允许访问外部服务区创建一台服务器，执行如下命令安装Nginx。

   yum install nginx

2. 执行如下命令，编辑/etc/nginx/nginx.conf配置文件。

   vim /etc/nginx/nginx.conf

   说明

   配置文件的路径请以实际路径为准，本文以/etc/nginx/nginx.conf配置文件为例。

3. 在config文件中的HTTP模块添加如下内容。

   //主OSS Endpoint 代理配置
   server {
           listen 0.0.0.0:80;
           server_name oss-cn-shanghai.aliyuncs.com
           //223.5.5.5、223.6.6.6为DNS服务器，可以切换成用户本地的互联网DNS服务器
           resolver 223.5.5.5 223.6.6.6 valid=30s;
           location / {
               proxy_pass http://oss-cn-shanghai.aliyuncs.com;  
               proxy_set_header Host $host; 
               access_log  /var/logs/nti-access.log;
               error_log   /var/logs/nti-error.log;
        }  
   }
   //备份OSS Endpoint 代理配置
   server {
           listen 0.0.0.0:80;
           server_name cn-shanghai.oss.aliyuncs.com
           //223.5.5.5、223.6.6.6为DNS服务器，可以切换成用户本地的互联网DNS服务器
           resolver 223.5.5.5 223.6.6.6 valid=30s;
           location / {
               proxy_pass http://cn-shanghai.oss.aliyuncs.com;  
               proxy_set_header Host $host; 
               access_log  /var/logs/nti-access.log;
               error_log   /var/logs/nti-error.log;
        }  
   }

4. 执行如下命令，确认添加的配置正常。

   nginx -t

5. 执行如下命令，启动Nginx。

   systemctl start nginx

6. 在本地应用服务器上配置host并访问服务地址，网页响应正常表示代理设置成功。

   您可以在Nginx反向代理服务器上的/var/logs/nti-access.log中查看访问日志。