Ubuntu 20.04服务器按官方步骤安装Jenkins反复报错求助

按以下顺序操作可解决Ubuntu 20.04上通过Debian稳定源安装Jenkins的绝大多数报错：

• 清理历史残留无效配置
  执行命令删除旧的Jenkins源配置、失效GPG密钥，避免软件包校验失败：

  sudo rm -f /etc/apt/sources.list.d/jenkins.list
  sudo apt-key del $(sudo apt-key list | grep -B1 "Jenkins Project" | head -n1 | awk '{print $NF}') 2>/dev/null
  

• 重新配置可信软件源
  导入Jenkins官方最新GPG密钥到系统可信密钥目录，写入带密钥校验的源配置，更新本地软件包索引：

  curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
  echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
  sudo apt update
  

• 安装版本匹配的Java依赖
  Jenkins稳定版最低要求OpenJDK 11运行环境，推荐直接安装OpenJDK 17，Ubuntu 20.04默认源已提供对应安装包：

  sudo apt install -y openjdk-17-jre-headless
  

  安装完成后执行java -version确认版本为17.x，若系统存在多版本Java，执行sudo update-alternatives --config java选择OpenJDK 17为默认运行环境即可。
• 修复中断安装导致的异常
  若之前安装中途退出导致dpkg锁占用、依赖关系破损，先执行修复命令：

  sudo apt --fix-broken install -y
  sudo dpkg --configure -a
  

  若提示dpkg锁被占用，先执行sudo lsof /var/lib/dpkg/lock-frontend查询占用进程，确认非系统自动更新任务后，杀掉对应PID再重试操作。
• 执行Jenkins安装
  以上前置步骤完成后，执行安装命令即可正常完成部署：

  sudo apt install -y jenkins
  

• 安装后服务启动失败排查
  若安装包执行完成但服务无法正常启动，按以下顺序排查：
  1. 执行sudo ss -tulpn | grep 8080检查默认8080端口是否被其他服务占用，若存在占用，编辑/etc/default/jenkins文件修改HTTP_PORT参数为未被占用的端口，重启服务即可
  2. 执行sudo chown -R jenkins:jenkins /var/lib/jenkins /var/cache/jenkins /var/log/jenkins修复Jenkins工作目录权限，安装脚本偶发权限写入错误会直接导致启动失败
  3. 执行sudo journalctl -u jenkins -n 50拉取服务最近50行日志，可定位个性化配置导致的特殊报错

内容的提问来源于stack exchange，提问作者ravinderpal Singh