修改JVM参数后Amazon Linux EC2上Jenkins启动失败如何诊断

排查步骤 #

• 先验证JVM参数合法性
  你用简化参数可以正常启动，说明问题出在新增的GC日志相关参数上，大概率是参数和你当前使用的Java版本不兼容。你可以直接在命令行执行以下命令测试参数是否合法，JVM会直接输出错误信息：

  java <替换为你配置的完整JENKINS_JAVA_OPTIONS参数> -version
  

  常见坑点：Java 9及以上版本废弃了Java 8的-XX:+PrintGCDetails、-Xloggc等GC日志参数，统一改用-Xlog:gc*格式的配置，如果你用的是Java 11/17还在配置Java 8的GC日志参数，JVM会直接启动失败。
• 查看systemd服务日志
  JVM启动阶段的错误不会写入Jenkins业务日志/var/log/jenkins/jenkins.log，会被systemd捕获，执行以下命令即可查看服务的完整启动日志：

  journalctl -u jenkins.service -f --since "10 minutes ago"
  

  这里可以直接看到JVM报的参数错误、权限错误等核心问题。
• 验证日志目录权限
  确认jenkins运行用户对/var/log/jenkins目录有读写权限，可以执行以下命令验证：

  sudo -u jenkins touch /var/log/jenkins/test_gc.log
  

  如果执行报错说明权限不足，JVM无法写入GC日志、堆转储文件也会直接启动退出。
• 二分法定位问题参数
  你可以在可正常运行的简化参数基础上，每次新增1-2个GC相关参数，重启Jenkins验证是否能正常运行，直到定位到导致启动失败的具体参数，再针对性处理兼容问题。

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