1. 概述
本文将介绍 开放平台BETA插件 常见问题和解决方案。
2. 报错
2.1 报错一:权限异常
2.1.1报错信息
403,no privilege
如下图所示
2.1.2 排查思路
1)确认使用应用的认证方式,是否选择aksk认证方式(以下为aksk认证方式排查思路,其他认证方式类似,只是请求中头参数有区别)
2)确认使用的应用是否有该接口的权限;
3)确认请求中的头参数,是否添加了应用的id和密码
4)确认是是否使用nginx,nginx会将带下划线的请求头识别为无效的header
解决方法:将client_id参数改为clientId
2.2 报错二:资源异常
2.2.1 报错信息
404,resource not exist
如下图所示:
2.2.2 排查思路
1)确认请求方式是否正确
2)确认url路径是否正确
2.3报错三:插件更新后开放平台页面空白
2.3.1 排查思路
正常为工程同时安装了开放平台beta插件和其他开放平台子插件,而更新开放平台beta时,没有将子插件禁用;
解决方法:重启工程
3.耗时分析、日志跟踪
在插件「全局设置」中打开 耗时分析、日志跟踪,在FineBI 日志中可以查看耗时分析、日志跟踪,以便定位问题。
3.1耗时分析
基于Spring框架的StopWatch封装成StopWatchDebug,DEBUG日志记录API访问各个阶段的耗时和占比。
3.2日志跟踪
API每次调用会生成traceId绑定,异常返回的errorMsg和日志记录中都会打印traceId,方便快速检索相关联的日志。
返回示例:
{
"status": 403,
"errorCode": "403",
"errorMsg": "FORBIDDEN!NO PRIVILEGE!; trace id=c8fb3d3e-5a6c-405b-8198-c451c832c7bd"
}