卸载XRay3评估版后Artifactory PRO 7.15.3包视图出现服务器500错误
同类问题共性说明
不少用Artifactory 7.1x版本好几年的老用户,在做完XRay功能评估、手动卸载XRay组件后,都碰到过包视图报500错的情况。根本原因是XRay3和Artifactory 7.x的绑定逻辑跟早年的XRay2差很多,直接照搬XRay2的卸载流程,根本清不干净两端的绑定残留,最后就会触发包视图接口的查询异常——而且这类异常很多时候不会在默认的info级日志里打明确的报错栈,很容易卡排查。
分层排查解决操作
- 先清最容易漏的Web集成配置残留
很多人卸XRay的时候只把XRay自己的服务停了删了,根本没回头清Artifactory这边留的集成配置:- 用管理员号登Artifactory后台,进「管理 > 安全 > 集成」页面,把所有留着的XRay实例配置条目全删掉,保存完等后台配置自动重载
- 查一下前面的反向代理配置,把所有指向已经下线的XRay服务的转发路径规则删掉,重载代理配置
- 再查数据库层面的残留关联
这也是为啥日志里找不到有效线索的核心:Artifactory的包视图接口默认会读XRay关联的漏洞扫描状态字段,如果数据库里还留着失效的XRay关联配置,接口查的时候直接抛空指针类的异常,返回500,但默认日志级别根本不打这类细粒度错误。- 不管用的是内置PostgreSQL还是外部数据库,操作前先整库做个备份
- 进Artifactory对应的业务库,把
xray_server_config表里的所有残留记录清空 - 找一下节点配置表里和XRay关联的标记字段,把无效的关联标记全置空
- 清本地缓存和残留索引
Artifactory会在本地存一份XRay的关联缓存,光清配置和数据库不会自动把这部分缓存删掉:- 先把Artifactory的运行服务停掉
- 找到安装目录下
var/cache路径,把里面所有跟xray相关的缓存子目录全删了 - 重启Artifactory之后,进「管理 > 服务 > 元数据重建」页面,触发一次和包视图相关的元数据全量重建
- 处理7.15.3版本的固有兼容小问题
你用的这个7.15.3版本本身有个已知的小毛病:当XRay集成被完全移除之后,包视图页面会默认拉XRay那边的漏洞统计数据,请求失效的时候直接抛500,这类异常只有把日志切到debug级别才能看到对应的报错栈。这时候可以临时把后台日志级别调到debug,定位到那个失效的漏洞展示模块,直接从页面配置里把这个模块隐藏就行。
提醒一句:XRay3和Artifactory解绑的正确顺序是,先在Artifactory侧把XRay的集成配置全解除,再停XRay服务清它自己的数据,最后重启Artifactory挨个校验功能点。顺序搞反了很容易留各种隐性的残留问题,排查起来特别麻烦。
内容的提问来源于stack exchange,提问作者titan_cb
相关产品推荐
相关产品推荐

