jenkins 2.346.1+ 强制要求 java 17，非11或8；装错将导致 systemctl start jenkins 静默失败，且错误日志不提示java版本问题，必须通过 java -version 和 which java 验证路径是否为 /usr/lib/jvm/java-17-openjdk-。
Java 17 是硬性前提，别用 Java 8 或 11 混着试
Jenkins 2.346.1+ 强制要求 Java 17（不是 11，也不是 8），装错版本会导致 systemctl start jenkins 静默失败，journalctl -u jenkins 里只看到 “Failed to start Jenkins Continuous Integration Server”，根本不会报 Java 版本错。
验证方式必须是：java -version 输出含 17.，且 which java 指向 /usr/lib/jvm/java-17-openjdk- 类路径；如果系统有多个 Java，得用 sudo update-alternatives --config java 切换，不能只改 JAVA_HOME —— Jenkins systemd 服务不读这个变量。
- Ubuntu/Debian：用
sudo apt install openjdk-17-jre，别装openjdk-17-jdk（JRE 足够，JDK 多余） - RHEL/CentOS/Rocky：用
sudo dnf install java-17-openjdk-headless（带-headless才无图形依赖） - Docker 方式可跳过这步，但镜像必须选
jenkins/jenkins:lts-jdk17，别用老的lts标签
APT/YUM 源配置错一个字符，apt install jenkins 就会装上旧版或报 404
官方源地址和 GPG 密钥路径必须完全匹配发行版和稳定分支。常见错误是把 debian-stable 写成 debian，或把 redhat-stable 写成 redhat，结果 apt update 成功但 apt install jenkins 安装的是 2.319 这类老版本，后续 Pipeline 编辑器直接打不开。
正确操作要分三步验证：
- 导入密钥后检查：
ls /usr/share/keyrings/jenkins-keyring.asc（Debian）或rpm -K /etc/pki/rpm-gpg/RPM-GPG-KEY-JENKINS（RHEL） - 源文件内容必须含
signed-by=（Debian）或gpgcheck=1（RHEL），缺一不可 -
apt-cache policy jenkins（Debian）或dnf list available jenkins（RHEL）确认显示的版本号 ≥ 2.441（2026 年当前 LTS）
部署脚本里写死 /var/lib/jenkins/workspace/xxx 必然失败
Jenkins 的 $WORKSPACE 是动态路径，自由风格项目默认在 /var/lib/jenkins/workspace/任务名，但 Pipeline 项目可能落在 /var/lib/jenkins/workspace/流水线名@2 这种带 @ 符号的路径——硬编码会导致 scp 找不到 jar 包，或者 sh 'cd /var/lib/jenkins/workspace/myapp && npm run build' 报 no such file。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
真正安全的做法只有两个：
- 所有脚本内一律用
$WORKSPACE或${WORKSPACE}，例如：sh 'cd "$WORKSPACE" && npm run build' - Pipeline 中明确用
dir块限定上下文：dir("${WORKSPACE}/frontend") { sh 'npm run build' } - 绝对不要在 Post-build Actions 的 shell 脚本里写
cd /var/lib/jenkins/...—— 这是新手最常踩的坑
远程部署时 ssh 连不上，90% 是因为没关 StrictHostKeyChecking
第一次 ssh user@host 会卡在 “Are you sure you want to continue connecting” 提示，Jenkins 后台进程无法交互，整个构建就挂住不动，日志里只显示 “process apparently never started”。
解决方法不是手动连一次服务器去存 known_hosts，而是强制跳过检查：
- 自由风格项目中，Post-build Actions → Execute shell 里写：
ssh -o StrictHostKeyChecking=no user@192.168.1.100 "systemctl restart myapp" - Pipeline 中用
sh 'ssh -o StrictHostKeyChecking=no ...'，别信网上说的ssh-keyscan预加载——它在容器化 Jenkins 或非 root 用户下经常权限失败 - 生产环境真要配 keyscan，得确保
jenkins用户对/var/lib/jenkins/.ssh/known_hosts有写权限，且ssh-keyscan命令在 PATH 里
最后提醒一句：Jenkins 默认以 jenkins 系统用户运行，它对宿主机的 /var/run/docker.sock、远程服务器的 ~/.ssh/id_rsa、目标部署目录（如 /opt/myapp）都没有天然权限——这些地方出问题，比 Java 版本错更难排查。
