Artifactory pro v7.30.x 多种安装方式下服务启动失败问题咨询

已确认故障基线 #

• 评估环境使用Artifactory试用许可证，所有部署操作严格参照官方文档执行
• 已测试两种部署方案均启动失败：Docker容器部署、Linux归档包部署
• 故障表现一致：启动过程中某组件运行异常，日志输出大量stack trace报错，最终所有服务进程完全终止
• 已提交官方Jira工单跟进该故障

核心排查步骤 #

两种完全独立的部署方式同时失败，基本可以排除部署操作失误的问题，不需要反复重装浪费时间，优先排查共性环境问题。
定位首个报错点
不要被后续大量级联报错干扰，先抓第一个抛出的异常栈：

• Docker部署场景：执行 docker exec -it <你的容器名> grep -A 30 -B 5 "ERROR\|Exception" /opt/jfrog/artifactory/var/log/console.log | head -n 100，取输出的第一段异常信息
• Linux归档包部署场景：执行 grep -A 30 -B 5 "ERROR\|Exception" $ARTIFACTORY_HOME/var/log/console.log | head -n 100，取输出的第一段异常信息

核对高频共性故障点
两种部署同时失败的问题90%集中在以下几类，逐个核对：

• 资源不足：Artifactory最低启动要求为4核CPU、8G可用内存，Docker部署还要确认给Docker分配的资源配额达标，资源不足会导致组件初始化超时被系统kill，抛出大量栈追踪后进程退出，可通过free -h、nproc命令核对
• 权限错误：Linux归档包部署必须保证$ARTIFACTORY_HOME整个目录属主为artifactory用户；Docker部署如果做了目录挂载，必须保证宿主机挂载目录的UID为1030（容器内artifactory运行用户的UID），权限不足会导致组件无法读写配置、初始化存储文件直接报错
• 端口冲突：Artifactory默认占用8081、8082两个端口，若端口被本机其他服务（旧版Artifactory、Nginx、其他Java服务）占用，会导致内嵌路由、Web组件初始化失败
• JVM参数错误：如果手动调整过JVM堆内存配置，堆内存设置超过系统可用内存会直接触发OOM导致进程退出，排查阶段先改回默认参数-Xms2g -Xmx4g测试

最小化验证
以上排查都没定位到问题时，先做无自定义配置的最小启动验证，排除安装包损坏、许可证、系统策略的影响：

• 临时关闭系统防火墙、SELinux，清空之前部署生成的所有残留数据目录
• 不挂载任何自定义目录、不添加任何自定义参数，直接执行最简Docker启动命令测试：docker run --name artifactory-test -d -p 8081:8081 -p 8082:8082 releases-docker.jfrog.io/jfrog/artifactory-pro:latest
• 如果最简启动依然失败，把之前抓到的首个异常栈信息补充到工单，优先确认是否为对应版本的已知缺陷

内容的提问来源于stack exchange，提问作者Taylor Schneider