4A异常问题快速定位指南

正式环境管理员：IT客服
测试环境管理员：王浩彬、黄威鸿
4A开发：王浩彬、黄威鸿

1、登录时出现【4000004】错误。

原因：在4A注册系统时，没有提供访问域名或者注册的域名和appId对应不上。联系管理员进行配置，并把门户的appId发给管理员

2、登录时出现【4000003】错误。

原因：没有在门户注册appId，联系管理员进行配置，并带上必要信息(系统名称、系统简要描述、系统域名)

3、登录时出现【4000002】错误

原因：4A没有对角色进行授权，联系管理员进行授权

4、出现重定向次数过多

原因：业务系统判断自身处于未登录的状态，但是4A已经是登录状态。4A已经是登录状态时就会重定向到业务系统，业务系统未登录时就会重定向到4A，如此循环，造成页面奔溃。

一般出现这个问题是业务系统A嵌套了系统B,系统A和B都对接了内部单点登录，这时候业务系统应该解决跨域cookie问题（只发生于chrome浏览器v80版本之后的浏览器）

如果解决了跨域cookie之后还出现这个问题，检查chrome的版本号是否大于100。如果是版本号大于100，应该升级cir-framework的版本为：3.1.0以上。
原因：cir-framework工具函数有异常

应改为：

export function needSecureAndSameSite(ctx) {
  const ua = ctx.headers['user-agent'];
  if (!ua) return false;

  // 搜狗浏览器
  if (ua.indexOf('SE') > 0) return false;

  // 仅判断 Chrome 80 版本以上
  if (ua.indexOf('Chrome/') > 0) {
    const uaVersion = ua.match(/Chrome\/(\d+)/)[1] 
    if (Number(uaVersion) >= 80) {
      return true;
    }
  }

  return false;
}

如果升级了cir-framework版本之后还有异常，请检查鲸云的node环境变量配置：
更改为：NODE_ENV = production

原因：cir-framework会先判断环境和浏览器版本，再决定是不是设置response cookie的属性

5、csb系统报单点登录错误。

原因：原因由业务系统决定，多种多样，无法列出。但是首先要关注自己的业务系统是否报错。4A登录成功后，颁发ticket给业务系统。这时候4A的任务告一段落，剩下都是的先走业务的接口，先排查业务接口是否出现问题。

如地址所示：目前是在scrm.cvte.com/oauth接口上出现的异常，先排查鲸云日志，如果没有异常，再联系4A开发人员。

6、登录界面报服务器出现未知错误

原因：目前出现这种状况的原因有两个：

1. 是乾坤的应用
2. 该应用是支持本地密码校验

解决办法：业务给4A提供自定义的登录校验接口，入参数同https://home.cvte.com/login一样。如果已经提供，则排查自己的校验接口发生了什么异常

7、如果上述的问题都没有命中，怎么办？

查看网络请求，如果报错的接口是门户的接口，则找门户开发人员进行解决；如果是自己业务接口报错，则自己先排查问题。

8、有些用户的场景无法使用双重认证，如何解决

目前双重认证开启的配置有两个，一个是用户层面，一个是系统层面。用户层面的优先级高于系统。用户层面配置了不开启，那就走普通的登录流程。用户层面开启了，就判断系统层面是否配置了要双重认证。找4A开发人员配置即可。为了响应安全部门的要求，一般会开启，除非像工厂端这样不得不关闭的时候，才会关闭双重认证。

9、双重认证中提示验证码已经发送，但是没有及时收到验证码

原因：推送接口可能处于阻塞中，如果长时间无法收到，可联系张浩威检查是否推送服务出现了问题。

10、扫码登录时，手机端登录失败

原因：wmp的接口出现异常，请加链接复制下来后，联系@叶振威

11、登录异常，报错如下：

原因：门户没有同步到这个账号导致的。门户有一个定时任务，会定期同步圭浮4A的人员数据。
门户没有同步到的原因可能如下：

1. 圭浮4A有这个人员数据，但是账号异常，导致门户同步不到
2. 圭浮4A没有这个数据，门户同步不到。

解决步骤：（以测试环境举例）

1. 先找IT客服或者罗威，让他们查圭浮4A的测试环境有没有这个账号，如果没有账号。就让他们同步或创建（一般外协是手动创建，内部人员是同步）。
2. 圭浮4A账号有了之后，就等门户的同步任务进行同步。如果比较紧急，找浩彬看是不是可以临时执行一次同步任务。
3. 门户上有账号之后，这个用户就可以正常登录。

账号同步流程：