升级Artifactory至7.71.8+后无法访问，报服务注册Ping失败错误

故障现象 #

将Artifactory从7.38.7版本升级至7.71.8或更高版本后，系统无法正常访问，控制台日志出现如下错误：

Cluster join: Retry 280: Service registry ping failed, will retry. Error: error while trying to connect to local router at address 'http://localhost:8046/access/api/v1/system/ping': Get "http://localhost:8046/access/api/v1/system/ping": dial tcp [::1]:8046: connect: connection refused [startup]

已完成排查项 #

• 确认$JFROG_HOME/artifactory/app/artifactory/tomcat/conf/Catalina/localhost目录下的access.xml和artifactory.xml文件存在且权限正常
• 已排查防火墙配置，所有必要端口均已开放

解决方案 #

1. 检查Router服务状态 #

• 执行命令查看Router服务运行状态：

  $JFROG_HOME/artifactory/app/bin/router.sh status
  

• 若Router未启动，手动启动服务：

  $JFROG_HOME/artifactory/app/bin/router.sh start
  

  等待Router服务完全启动后，再重启Artifactory服务。

2. 验证端口占用情况 #

• 检查8046端口是否被其他进程占用：
  • Linux系统：

    netstat -tulpn | grep 8046
    

  • Windows系统：

    netstat -ano | findstr :8046
    

• 若端口被占用，停止占用进程，或修改Router的端口配置（编辑$JFROG_HOME/artifactory/var/etc/system.yaml文件，调整router.access.port参数）。

3. 核对系统配置一致性 #

• 打开$JFROG_HOME/artifactory/var/etc/system.yaml文件，确认Router的Access服务端口配置正确（默认8046），且Artifactory配置中指向的Access服务地址与该端口匹配。
• 对比升级前后的system.yaml文件，排查是否存在配置项被覆盖或丢失的情况。

4. 清理缓存并重新初始化 #

• 停止所有JFrog服务：

  $JFROG_HOME/artifactory/app/bin/artifactoryctl stop
  

• 删除缓存目录：

  rm -rf $JFROG_HOME/artifactory/var/cache
  

• 重新启动服务：

  $JFROG_HOME/artifactory/app/bin/artifactoryctl start
  

  观察启动日志，确认服务是否正常初始化。

5. 测试端口连通性 #

• 在本地执行curl命令测试Access服务端口：

  curl http://localhost:8046/access/api/v1/system/ping
  

• 若返回OK，说明Access服务正常，重启Artifactory即可；若仍无法连接，查看Router日志（$JFROG_HOME/artifactory/var/log/router/router.log），排查具体启动失败原因。

内容的提问来源于stack exchange，提问作者J Madduri